Event Log Trigger
Description
Triggers task execution when the monitored event is written to the Windows Event Log.
Practical usage
Commonly used to make Automate Desktop act in response to system or application generated errors, warnings, successes or failures that are sent to the Windows Event Log. For example, this trigger can automatically launch a task that emails the system administrator if Windows generates a log entry stating that the DNS server could not be contacted. It can also be used to run a task when a subsequent Automate Desktop task logs an event to the Windows Event Log with the use of the Event Log - Write activity, which logs a user defined event to the Windows Event Log.
Parameters
General
Property | Type | Description |
---|---|---|
Log | Options | 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. |
Source | Text | 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. |
Type | Options | The
type of event to monitor. The available options are:
|
Category | Text | The event category to monitor. The only available option is All categories. |
Description | Text | Allows a description for the event to optionally be entered. To monitor for partial descriptions, use wildcard characters * or ?. |
Behavior
Property | Type | Description |
---|---|---|
Enable Trigger | Yes/No | If selected, the trigger will immediately be active upon creation. If disabled, the trigger will stay inactive until it is manually enabled. This parameter is selected by default. |
Trigger after the condition has been met 'X' times. | Yes/No | If enabled, specifies how many times the trigger condition must be met before the task is started. For example, if a Window trigger is set to monitor for the appearance of a Notepad window and this parameter is set to 3, the task will not launch until the third instance of Notepad appears on the desktop. |
Additional notes
AMTrigger
When this trigger is activated, it automatically passes the AMTrigger object to the task. AMTrigger is a standard Automate Desktop dataset and can be used much like the datasets created by the Database - SQL query activity and Email action. The fields of AMTrigger can be used within a task to determine specific values, such as whether or not the task was started by a trigger, which trigger started the task, when the trigger was activated and other properties. AMTrigger populates a unique set of field–value pairs for each Automate Desktop trigger. The following table lists the ones specific to this trigger. For more details about a specific AMTrigger field–value pair, click the associated link.
Name | Data Type | Return Value |
---|---|---|
AMTrigger.EventCategory | String | Returns The category of the event that activated the trigger as shown in the Windows Event Log Category parameter. |
AMTrigger.EventComputer | String | Returns the computer name where the event that activated the trigger occurred. |
AMTrigger.EventDescription | String | Returns A description of the logged event that activated the trigger. |
AMTrigger.EventID | Number | Returns the Event ID of the logged event that activated the trigger. |
AMTrigger.EventSource | String | Returns the source of the logged event that activated the trigger. |
AMTrigger.EventTime | Date/Time | Returns the date/time that the monitored event was logged in the Windows Event Log. |
AMTrigger.EventType | String | Specifies the type of event that activated the trigger. |