Process Condition

Description

Launches a task/workflow when the specified process starts, ends or stops responding. It can also be used in the middle of the workflow to wait for a particular process to start/stop before continuing or used as a conditional object to determine the course of the workflow depending on the state of a particular process. To indicate partial process names, use wildcard characters * and ?.

Practical Usage

Frequently used to monitor external applications for unexpected crashes. Process condition is also used to start a task when an external application starts.

Parameters

General Properties

Property

Description

Wait for process to

Specifies the process action to monitor. The available options are:

  • Stop responding - The trigger activates when the specified process stops responding or "hangs".

  • Start - The trigger activates when the specified process starts.

  • End - The trigger activates when the specified process ends.

Process Name

Specifies the process to watch. The provided combination list box accepts manual text entry or the process can be selected from the drop-down list of open processes. The folder button can be used to navigate to the desired application as well. Either a filename or a full path and filename may be entered. Wildcard characters * and ? can be used to indicate partial process names. For example, entering e*.exe will watch for all processes starting with the letter e.

Behavior Properties

The Behavior tab properties dictate how the system should react upon the occurrence of a condition. These properties are significant in determining whether the AutoMate Condition should act as a trigger object (used to fire off workflow execution), wait object (used to suspend workflow execution) or conditional (decision making) object.

More about condition behavior

AMTrigger

When this trigger is activated, 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. F

Exclusive AMTrigger Fields

The AMTrigger fields described in the table below are specific only to the Process Condition.

Name

Type

Return Value

AMTrigger.Action

Text

Returns the action that activated the condition. The available return values are:

  • START - The trigger was set to wait for the process to start.

  • END - The trigger was set to wait for the process to end.

  • HUNG - The trigger was set to wait for the process to stop responding.

AMTrigger.Exename

Text

Returns the filename of the process that activated the condition, including full path and filename information.

AMTrigger.Filename

Text

Returns the filename of the process that activated the condition, excluding path information.

AMTrigger.ProcessID

Number

Returns the process ID of the process that activated the condition. A process ID is a number automatically assigned to a process by the system. The process ID can be used by other actions in AutoMate to specify an instance of a process or application.

AMCondition

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.

Exclusive AMCondition Fields

The AMCondition fields described in the table below are specific only to the Process Condition.

Name

Type

Return Value

 

AMCondition.Action

Text

Specifies the type of wait that the condition used. The available returns are:

  • START: The condition was set to wait for the process to start.

  • END: The condition was set to wait for the process to end.

  • HUNG: The condition was set to wait for the process to stop responding

AMCondition.Exename

Text

Returns the filename of the process that activated the condition including path and filename information.

AMTrigger.Filename

Text

Returns the filename of the process that activated the condition without path information.

AMTrigger.ProcessID

Text

Returns the process ID of the process that activated the condition. A process ID is a number automatically assigned to a process by Windows. The process ID can be used by other actions in AutoMate to specify an instance of an application.

 

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 | Condition Behavior | Event Log Condition | File Condition | Idle Condition | Key Event | Logon Condition | Performance Condition | Process Condition | SNMP Trap Condition | Window Condition | WMI Condition