Process Trigger

Description

Launches a task when the specified process starts, ends or stops responding. To indicate partial process names, use wildcard characters * or ?.

Practical Usage

This trigger is frequently used to monitor external applications for unexpected crashes. For example, if a certain process unexpectedly stops, a task can automatically be launched to remedy the issue by executing a Run action to try and restart the stopped process. This trigger can also be 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

Indicates the process that this trigger should monitor. 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

Property

Description

Trigger on startup if condition is true

If enabled, the system will act upon conditions that already exist upon startup of the current trigger. For example, if the Notepad window is already open on the desktop, a newly created Window trigger set to monitor for the existence of a Notepad window will immediately launch the task as a result. If disabled, the trigger will ignore the open Notepad window upon startup. This parameter is disabled by default.

Trigger after the condition has been met 'X' times.

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.

 

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, and other trigger related properties. For more details, see Using AMTrigger. The AMTrigger fields described below are exclusive only to the Process trigger.

Name

Type

Return Value

AMTrigger.Action

Text (options)

Returns the action that activated the trigger. 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 trigger, including full path and filename information.

AMTrigger.Filename

Text

Returns the filename of the process that activated the trigger excluding path information.

AMTrigger.ProcessID

Number

Returns the process ID of the process that activated the trigger. 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.

 

NOTE: A full list of AMTrigger objects exclusive to each trigger can be viewed from the Expression Builder by expanding Objects -> Triggers and selecting the desired trigger.

See Also

Triggers - Overview

↑ Top of Page