Event Log Condition

See Also

 About Conditions, All Available Conditions, Condition Behavior, Using AMTrigger, Using AMCondition

Description

Starts the task/workflow when the monitored event is added to the Windows Event Log. Can also be used in the middle of a workflow to wait for a particular event to be added to the Windows Event Log or determine the course of a workflow depending on whether or not a particular event is added to the Event Log.

Practical Usage

Used to make AutoMate BPA Server react to system or application generated errors that are sent to the system event log. For example: If the system generates a log entry indicating that the DNS server could not be contacted, automatically notify the system administrator.

Parameters

General Properties

Property

Description

Log Type

The type of event log to monitor. The default option is Application, however, other log types can be selected by expanding the list box or a user can simply enter the log type manually.

Event Source

The source of the event in which to monitor. The default option is All Sources, however, expanding the list box will show all available sources on the system to select from or a user can enter the event source manually.

Event Type

The type of event to monitor. The available options are:

  • All Types (default)

  • Information

  • Warning

  • Error

  • Success Audit

  • Failure Audit

Event Category

The event category to monitor. The only available option is All categories.

Description

Allows a description for the event to optionally be entered. To monitor for partial descriptions, use wildcard characters * or ?.

Behavior Properties

All available Conditions contain Behavior properties that dictate how it should handle a monitored event or condition. These properties determine whether the Condition should act as a trigger, a wait object or conditional (or decision making) object. By default, new Conditions are set to wait for the specified event/condition indefinitely, allowing it to act as a trigger object. For more details, see Condition Behavior.

AMTrigger Parameters

When this condition is used to trigger the start of a task, it automatically passes the AMTrigger object to the task. AMTrigger can be used within a task to determine whether or not the task was started by a trigger, which trigger started the task, when the trigger was activated and other trigger related properties.

Common AMTrigger Fields

Every instance of AMTrigger populates a list of common fields which are described in the table below.

Name

Data Type

Return Value

AMTrigger.Trigger

String

Returns the name of the event or condition that triggered the task. Each event or condition contains a unique name. For this trigger, the value is always AMEVENTLOGTRIGGER.

AMTrigger.TaskName

String

Returns the name of the managed task that the trigger was attached to. Useful to determine the responsible task when two managed tasks point to the same AML file.

AMTrigger.TriggerredDateTime

String

Returns the date and time when the trigger occurred.

AMTrigger.TriggeredOn

String

Returns the machine name where the trigger occurred.

AMTrigger.WasLocked

Boolean

If the workstation was locked when the trigger occurred, the value returned is 1. Otherwise, it will be 0.

AMTrigger.WasLoggedOff

Boolean

If the workstation was logged off when the trigger occurred, the value returned is 1. Otherwise, it will be 0.

AMTrigger.AML

String

Returns a verbose set of information about the triggered event or condition in AML (AutoMate Markup Language) format.

 

Exclusive AMTrigger Fields

The AMTrigger fields described in the table below are specific only to the Event Log condition.

Name

Data Type

Return Value

AMTrigger.EventType

Text

Specifies the type of event that activated the trigger. The available event types are:

  • Information

  • Warning

  • Error

  • Success Audit

  • Failure Audit

AMTrigger.EventID

 

Text

The Event ID of the logged event that activated the trigger.

AMTrigger.EventSource

 

Text

The source of the logged event that activated the trigger.

AMTrigger.EventCategory

Text

The category of the event that activated the trigger.

AMTrigger.EventDescription

Text

A description of the event that activated the trigger.

AMTrigger.EventTime

Text

Specifies the date/time that the monitored event was logged in the Windows Event Log.

 

AMCondition Parameters

When this condition is used in the middle of a workflow (as opposed to triggering condition) it automatically passes the AMCondition object to the task.

Common AMCondition Fields

Each condition contains its own set of unique AMCondition values. Therefore, the total number of fields that AMConditon creates during runtime and what they are called depend largely on the condition that was activated. However, every instance of AMCondition is populated with the following general fields:

Name

Data Type

Return Value

AMCondition.Agent

String

Returns the name of the agent where the condition activated.

AMCondition.DateTime

String

Returns the date and time of when the condition occurred.

AMCondition.Name
 

String

Returns the name of the activated condition. Each condition contains a unique name. For example, if the File condition was initiated, the value returned would be . See the help topic for each condition to determine that object's unique name.

AMCondition.Result
 

String

Returns the result of the activated condition (True or False).

AMCondition.WasLocked

Boolean

If the workstation was locked when the condition occurred, the value returned is 1. Otherwise, it will be 0.

AMCondition.WasLoggedOff

Boolean

If the workstation was logged off when the condition occurred, the value returned is 1. Otherwise, it will be 0.

AMCondition.AML

String

Returns verbose data about the activated condition in AutoMate Markup Language (AML) format.

 

Exclusive AMCondition Fields

The AMCondition fields described in the table below are specific only to the Event Log condition.

 

Name

Data Type

Return Value

 
AMCondition.EventType

Text

Returns the type of event that activated the Event Condition.

 
AMCondition.EventID

Text

Returns the unique ID of the logged event.

AMCondition.EventSource

Text

Returns the source value of the logged event.

AMCondition.EventCategory

Text

Returns the category of the event that started the Event Condition.

AMCondition.Description

Text

Returns a description of the event that started the Event Condition.

 
AMCondition.EventTime

 

Text

Specifies the time of the event that started the Event Condition.

 

NOTE: A full list of AMCondition and AMTrigger objects exclusive to each Event/Condition can be viewed from the Expression Builder by expanding the Objects folder and selecting the desired object from either the Triggers or Conditions folder .

See Also

About Events & Conditions

All Available Events & Conditions

Condition_Behavior