Search

User Manual

GETTING STARTED


MODULES AND PLATFORM


APPENDIX


TUTORIALS & HELPFUL TRICKS


GLOSSARY


STRATEGIC PARTNER LINKS

Sepasoft - MES Modules
Cirrus Link - MQTT Modules

RESOURCES

Inductive University
Ignition Demo Project
Knowledge Base Articles
Forum
IA Support
SDK Documentation
SDK Examples

ALL USER MANUAL VERSIONS

Ignition 8.1
Ignition 7.9
Ignition 7.8

Deprecated Pages

Skip to end of metadata
Go to start of metadata

This function is used in Python Scripting.

Description

Queries an audit profile for audit history. Returns the results as a dataset.

Client Permission Restrictions

This scripting function has no Client Permission restrictions.

Syntax

system.util.queryAuditLog(auditProfileName, startDate, endDate, actorFilter, actionFilter, targetFilter, valueFilter, systemFilter, contextFilter)

  • Parameters

String auditProfileName - The name of the audit profile to pull the history from.

Date startDate - The earliest audit event to return. If omitted, the current time - 8 hours will be used.

Date endDate - The latest audit event to return. If omitted, the current time will be used.

String actorFilter - A filter string used to restrict the results by actor.

String actionFilter - A filter string used to restrict the results by action.

String targetFilter - A filter string used to restrict the results by target.

String valueFilter - A filter string used to restrict the results by value.

String systemFilter - A filter string used to restrict the results by system.

Integer contextFilter - A bitmask used to restrict the results by context. 0x01 = Gateway, 0x02 = Designer, 0x04 = Client.

  • Returns

Dataset - A dataset with the audit events from the specified profile that match the filter arguments.

  • Scope

    Vision Client

    The following feature is new in Ignition version 8.0.3
    Click here to check out the other new features
    As of version 8.0.3, the scope of this function was expanded to include the gateway, in addition to Vision Clients.


Code Examples
# This script will query an audit log, and check to see if a user john made any tag writes in the last 8 hours, and write the results to a table
 
data = system.util.queryAuditLog(auditProfileName='AuditLog', actorFilter='john', actionFilter='tag write')
 
event.source.parent.getComponent("Table").data = data
Keywords

system util queryAuditLog, util.queryAuditLog

  • No labels