Key Event

Description

Starts the task when a hot-key combination is pressed or a word is typed on the keyboard.

Practical Usage

Useful for creating hot-key "shortcuts" for repetitive multi-step processes.

Parameters

General Properties

Property

Description

Trigger on the following hot key

If selected, specifies the hot key combination to be monitored. Selecting this parameter enables the following secondary parameter.

Allow hot key to pass through to application

If enabled, specifies that the hot-key combination will continue to be active in an open application. If disabled, the hot key combination will have no effect on any application other than AutoMate (disabled by default).

Trigger on the following auto keys

If selected, specifies that the trigger will monitor for the specified word or phrase to be typed. Selecting this parameter enables the following secondary parameters.

Erase text before triggering task

If enabled, the monitored text will erase itself from any document or application before triggering the task. However, if you want the typed text to appear in the open application or document, disable this parameter.

Only when the following process is active

If selected, the trigger will activate only when the selected process is active on the system during the time that a user enters the specified hot key, word or phrase (disabled by default). Selecting this parameter enables the following secondary parameter.

And the application is in the foreground

If selected, the trigger will activate only when the selected process is active and the application window corresponding to that process is currently in the foreground during the time that a user enters the specified hot key, word or phrase.

AMTrigger

When an AutoMate Event is used to trigger task/workflow execution, a pre-named (or fixed field) dataset called "AMTrigger" is created and populated with a collection of data which is passed onto the associated task. AMTrigger can be used to determine important properties related to the triggered event, such as where (machine name) and when (date/time) the trigger commenced, which AutoMate Event or Condition was responsible for the triggered event and which task started as a result.

Exclusive AMTrigger Parameters

A unique set of AMTrigger values exclusive to each Condition are created and populated along with the collection of common values created by every instance of AMTrigger. The AMTrigger values described in the table below are exclusive only to a Performance Condition.

 

Name

Type

Return Value

AMTrigger.Keys

Text

Returns the hotkeys or auto keys that activated the event.

AMTrigger.WindowTitle

Text

Specifies the title of the Window in the foreground when the Key trigger was activated.

AMTrigger.WindowHandle

Number

Specifies the handle of the Window in the foreground when the Key trigger was activated. 

Exclusive AMCondition Parameters

There are no AMCondition parameters for this event.

 

NOTE: A full list of AMTrigger and AMCondition 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