AutoMate Events and Conditions are similar in that they can be placed in the beginning of a workflow in order to automatically trigger its execution. However, because events are typically defined as one time occurrences, an AutoMate Event is limited only as a "triggering" object. On the other hand, an AutoMate Condition can affect a task/workflow based on a situation, state or circumstance being met (which normally has a duration), therefore, they can exist as wait of conditional elements in any section of a workflow.

Each AutoMate Condition contains Behavior properties that determine whether it will operate as a triggering or non-triggering element during runtime. In all newly created Conditions, a set of parameters labeled Wait for condition along with indefinitely are toggled by default allowing the Condition to act as a triggering element. When a Condition is used to trigger (i.e. automatically start) a task, a pre-named (or fixed field)  dataset called AMTrigger is created and populated with a collection of data related to the triggered event. This dataset can be used within a subsequent task to determine specific system states or examine particular characteristics about the object that initially triggered execution. This includes information such as the name of the object used as a trigger, the date and time when the trigger occurred, the machine name where the trigger commenced and whether that machine was currently in a locked or logged off state when the trigger occurred. In addition, Behavior parameters can be modified to make the Condition behave as a non-triggering element. In such cases, the AMCondition dataset becomes available instead.

For example, the workflow illustrated below contains three File Condition objects, each used to monitor the existence of a particular file. The File Condition located in the beginning of the workflow waits indefinitely for File A to exist and triggers the connected task upon its existence. When this happens, an AMTrigger dataset populated with a collection of information about the triggered event is created and passed onto the following task. The second File Condition is used to pause execution and wait for File B to exist. When the file is detected, an AMCondition dataset is created and passed onto the next task. The third File Condition is used to immediately evaluate whether or not File C exists. If the evaluation is TRUE, it will execute the task following a Success Arrow. If the evaluation is FALSE, the task following a Failure Arrow runs instead. In both situations, an AMCondition dataset populated with information about the evaluation that took place is created and passed along to the appropriate task.

AMTrigger is a standard AutoMate dataset and can be used much like the datasets created by the SQL Query and Get E-Mail actions. The fields of AMTrigger can be used to determine properties of the object that caused the task to launch. For example, using a Message Box activity with the Message to display parameter set to:


would display a message box during task execution that  displays the name of the AutoMate Condition that triggered the task.

Common AMTrigger Parameters

AMTrigger populates a unique set of values for each AutoMate Event or Condition. Therefore, the total number of values that are populated during runtime and what they are named depend largely on the Event/Condition that was used to as a trigger. However, every instance of AMTrigger is populated with a collection of common values which are listed in the table below.


Data Type

Return Value



Returns the name of the event or condition that triggered the task. Each event or condition contains a unique name. For example, if the File Condition is used, the value is always AMFILETRIGGER.



Returns the name of the managed task that the event/condition was attached to.



Returns the date and time when the trigger occurred.



Returns the machine name where the trigger occurred.



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



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



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


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

Local Variables | Shared Variables | Arrays | AMError |