Trigger Properties

Each trigger is defined in terms of its trigger properties, windows behavior and selected criteria. The following table lists and describes the possible trigger properties.

Property

Description

Trigger Description

A set of pre-defined sentences that describe the nature of the trigger that is being defined. Every time you add or remove a trigger criteria, the Trigger Description changes accordingly.

Trigger Properties

Organization

Indicates the owner organization name. The trigger is visible to all employees within this organizational scope.

Unique Name

The trigger name.

Display Name

The name that helps the user easily associate the screen with its application. For example, for the Windows calculator, you would enter Calculator. Using the same Display Name enables you to evaluate all the triggers with the same name in step definitions, trigger reports and process discovery reports.

Trigger on the following System Event

This property is only relevant for firing a System Event trigger.

Event Code

Property is for backwards compatibility purposes. Ignore unless used in a previous release.

Command to Execute

Select the trigger command and edit existing trigger commands. The trigger command is the executable that runs when the trigger alert is fired.

User Group

Selecting a User Group indicates that the specific trigger will only be fired for users in the selected group. By default, this property is set to All Users.

Fire once for table

 

Class of Service

This property appears when V11 recording trigger commands are selected to execute.

When the following application

This property is only relevant for a Window Trigger.

Select the application that should fire the trigger when it is opened.

With window title containing

This property is only relevant for a Window Trigger.

Enter the characters that should appear in the window title in order to fire the trigger.

If this trigger is fired with a web browser, then enter the URL that should active the trigger.

Evaluate regular expression for window title match

This property is only relevant for a Window Trigger.

Identifies the expression entered in the With window title containing field, so that the trigger is only fired when the expression and window title occur together.

Window Behavior criteria

This property is only relevant for a Screen Content and Window Triggers.

Select the window’s focus on the screen required to fire the trigger.

Selected Criteria

The criteria that must be met for the trigger to fire.

Each trigger is defined in terms of its properties, windows behavior and selected criteria. The more selected criteria used within the trigger, the more specific the trigger will be.

Caution! Ensure that unique triggers are created with specific criteria that only matches the desired screen.

This ensures that the trigger only evaluates to true under the correct circumstances, thus preventing the trigger from firing unexpectedly.

Event criteria includes button clicks, hot keys, and changed criteria options. The first time one of these criteria is detected, the trigger fires.

  • Up to 50 conditions can be combined per trigger.

  • The list can also contain multiple event criteria that fire the trigger when all other conditions in the list are met.

For a each criteria:

  • Select an Event.

  • Enter a Value (one value is supported per trigger).

Select Highlight to activate a guided highlight on the screen control. It will be marked with a red border until the user enters a value. Guided highlights are not relevant for Trigger Variable criteria.

Available Criteria

This property is only relevant for a Screen Content trigger.

Displays the screen bitmap associated with the trigger.

To create the trigger criteria, perform one or more of the following:

  • Click on a highlighted area to add it to the selected criteria.

    Elements highlighted by red rectangles can be added to the selected criteria, and their values can be used as part of the trigger definition.

    Elements highlighted by green rectangles are “hotspot” areas of the screen that were only highlighted for the purposes of button clicks. These screen controls can only be assigned to “IsClicked” or “Exists At”.

    Enter the Control Criteria or edit the existing control criteria if the control was already selected.

  • From the list provided, select a Trigger Variable and click Add Trigger Variable.
    Trigger variables can only be selected if they were previously defined.

  • From the lists provided, select the hot key for the specific trigger and click Add Hot Key.

    A hot key fires the trigger when a particular key is pressed on the screen (For example, F5).

    A hot key criteria cannot be combined with any other event based trigger criteria. For example, you should not configure a trigger to be fired when Unbutton is clicked and the user presses ALT+T. Similarly, you should not configure a trigger to be fired when My input text has changed and the user presses ALT+T.

Trigger Variable Assignment

This property is relevant for all trigger types.

  • Used to perform operations on data in the selected Criteria area.

  • Used to tag steps and process.

For more in-depth information contact Professional Services.

WFO Integration

Scorecard Source Measures

Select items to use as source measures when creating Key Performance Indicators (KPIs).

VCT Integration

Select the Event Type as required.

Enter the name of the data source group. This can be the precise name of a group defined in the Portal under System Management, Data Sources, Data Source Groups. It can also be a set of keywords similar to those used on the command line of the trigger. Examples of valid keywords:

  • <ControlName>

  • <TriggerName>

  • %USER

  • %COMPUTER

  • %WINTEXT

Note: TRIM and PARSE are also available as pre-processors to the value of the data source group.

Trigger Notes

Enter information about the trigger that will enable users to understand the purpose of the trigger and when it will be fired.

Select Commands to Execute

System Event Triggers

Window Behavior Criteria

Tag processes and steps with Trigger Variables

Screen content trigger events