Variable Monitor Trigger

Variable Monitor Trigger

Overview

The Variable Monitor trigger allows you to trigger one or more tasks based on the conditions specified by a selected Variable Monitor task.
 

Note

You can select only a Variable Monitor task with a Value Monitor Type = Change.

 

Built-In Variables

The built-in variables outlined below can be used to pass data where appropriate:

Prerequisites

Before you can use a Variable Monitor Trigger, you need a Variable Monitor task, which defines the conditions for the variable being monitored.
 

Note

Any changes made to a Variable Monitor task are not recognized by its respective Variable Monitor Triggers until those Triggers are disabled and re-enabled.

Creating a Variable Monitor Trigger

Step 1

From the Automation Center navigation pane, select Triggers > Variable Monitor Triggers. The Variable Monitor Triggers list displays.
 
To the right of the list, Variable Monitor Trigger Details for a new Variable Monitor trigger displays.
 

Step 2

Enter/select Details for a new Variable Monitor trigger, using the field descriptions below as a guide.

  • Required fields display an asterisk ( * ) after the field name.

  • Default values for fields, if available, display automatically.

To display more of the Details fields on the screen, you can either:

  • Use the scroll bar.

  • Temporarily hide the list above the Details.

  • Click the 

     button above the list to display a pop-up version of the Details.

Step 3

Click a 

 button. The trigger is added to the database, and all buttons and tabs in the Trigger Details are enabled.

Step 4

Enable the trigger(s) as desired.

Note

To open an existing record on the list, either:

  • Click a record in the list to display its record Details below the list. (To clear record Details below the list, click the New button that displays above and below the Details.)

  • Clicking the Details icon next to a record name in the list, or right-click a record in the list and then click Open in the Action menu that displays, to display a pop-up version of the record Details.

  • Right-click a record in the a list, or open a record and right-click in the record Details, and then click Open In Tab in the Action menu that displays, to display the record Details under a new tab on the record list page (see Record Details as Tabs).

Variable Monitor Trigger Details

The following Variable Monitor Trigger Details is for an existing Variable Monitor trigger. See the field descriptions, below, for a description of the fields that display in the Variable Monitor Trigger Details.
 

Variable Monitor Trigger Details Field Descriptions

The following table describes the fields, buttons, and tabs that display in the Variable Monitor Trigger Details.
 

Field Name

Description

Field Name

Description

General

This section contains general information about the trigger.

Name


Name used within the Controller to identify this trigger. It can contain a maximum of 255 alphanumerics. It is the responsibility of the user to develop a workable naming scheme for triggers.

Version

System-supplied; version number of the current record, which is incremented by the system every time a user updates a record. Click the Versions tab to view previous versions. For details, see Record Versioning.

Description

Description of this record. Maximum length is 255 characters.

Member of Business Services

User-defined; Allows you to select one or more Business Services that this record belongs to.  (You also can Check All or Uncheck All Business Services for this record.)

You can select up to 62 Business Services for any record type, and enter a maximum of 2048 characters for each Business Service.

If the Business Service Visibility Restricted Universal Controller system property is set to true, depending on your assigned (or inherited) Permissions or Roles, Business Services available for selection may be restricted.

Calendar


Calendar that defines the business days, holidays, and other special days that determine the run dates for the task(s) specified in the trigger.

Select a Calendar from the drop-down list of all existing Calendars. To display detailed information about a selected calendar, click the Details icon next to the Calendar field.


Time Zone

User-defined; allows you to specify the time zone that will be applied to the time(s) specified in the trigger. For example, if you specify 23:00 and a time zone of Canada/Central, the task will run at 11:00 p.m. Central Canada time.

Task(s)

Name of the task(s) being triggered when this trigger is satisfied. When selecting tasks from the Details, click on the lock icon to unlock the field and select tasks.

Simulate

Specifies if the instances generated by this trigger should execute under simulation mode, in which none of the tasks execute. Alternatively, simulation mode can be enabled from the Trigger Now… command (see Triggering with Variables and Triggering by Date and Time).

Purge By Retention Duration

Exclude Backup

Retention Duration

Retention Duration Unit

Execution User

Status

This section contains information about the current status of the trigger.

Status

Next Scheduled Time

Enabled By

Disabled By

Enabled Time

Disabled Time

Skip Details

This section contains detailed information about skipping the trigger.

Task Launch Skip Condition

Skip Restriction

Skip Count

Skip Before Date

Skip Before Time

Skip After Date

Skip After Time

Skip Date List

Variable Monitor Details

This section contains assorted detailed information about the trigger.

Variable Monitor

Note

If you click the Details icon to create or update a Variable Monitor, Change is pre-selected for the Variable Monitor Type field and cannot be changed.

Running Monitor

Restrictions

This section specifies any restrictions that apply to the trigger.

Restrict Times

Enabled Start

Enabled End

Special Restriction

Action

Simple Restriction

Situation

Complex Restriction

Restriction Mode

Restriction Adjective

Restriction Noun(s)

Restriction Qualifier(s)

Restriction Nth Amount

Self-Service Options 

This section contains Self-Service specifications for the trigger.

Enforce Variables

Lock Variables

Metadata

This section contains Metadata information about this record.

UUID

Universally Unique Identifier of this record.

Updated By

Name of the user that last updated this record.

Updated

Date and time that this record was last updated.

Created By

Name of the user that created this record.

Created

Date and time that this record was created.

Buttons

This section identifies the buttons displayed above and below the Trigger Details that let you perform various actions.

Save

Saves a new task record in the Controller database.

Save & New

Saves a new record in the Controller database and redisplays empty Details so that you can create another new record.

Save & View

Saves a new record in the Controller database and continues to display that record.

New

Displays empty (except for default values) Details for creating a new record.

Update

Enable

Disable

Trigger Now...

Copy

Creates a copy of this trigger, which you are prompted to rename.

Delete

Refresh

Refreshes any dynamic data displayed in the Details.

Close

For pop-up view only; closes the pop-up view of this trigger.

Tabs

This section identifies the tabs across the top of the Trigger Details that provide access to additional information about the trigger.

Variables

Instances

Notes

Versions