Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Panel
Table of Contents

...

It is recommended that you use a Cron trigger, rather than a Time trigger, if you want to schedule non-standard time intervals for a triggering a task (see Scheduling a Time Interval 794538021, below).

Cron Syntax

The Cron trigger uses standard Cron syntax. Once the Cron trigger is entered into the system, the Controller interprets it and processes it as it would any other trigger. The trigger is satisfied when the current date and time match all the values specified in the Minutes, Hours, Day of Month, Month, and Day of Week fields.

...

Field Name

Required

Allowed Values

Allowed Special Characters

Minutes

Yes

0-59

* / , -

Hours

Yes

0-23

* / , -

Day of Month

Yes

1-31

* / , -

Month

Yes

1-12 or JAN-DEC

* / , -

Day of Week

Yes

0-7 or SUN (0 or 7)-SAT

* / , -

...

Note
titleNote

The day when a Cron trigger launches can be specified by two fields: Day of Month and Day of Week 794538021 and 794538021. If both fields are restricted (that is, they both are not *), the trigger launches based on the Day Logic 794538021 field value. If Day Logic 794538021 is set to Or, when either Day field matches, the trigger can launch. For example: 30 4 1,20 * 5 would cause the trigger to launch at 4:30 a.m. on the 1st and 20th of each month, as well as on every Friday. If, however, Day Logic 794538021 is set to And, the trigger would launch at 4:30 a.m. only on days that are the 1st or 20th which are also a Friday.

...

Step 1

From the Automation Center navigation pane, select Triggers > Cron Triggers. The Cron Triggers list displays.
 
To the right of the list, Cron Trigger Details for a new Cron trigger displays.
 
Image RemovedImage Added

Step 2

Enter/select Details for a new Cron 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
titleNote

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).

...

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

Image RemovedImage Added

Anchor
Cron Trigger Details Field Descriptions
Cron Trigger Details Field Descriptions

...

Field Name

Description

General

This section contains general information about the trigger.

Name

Include Page
IL:Trigger Name
IL:Trigger Name

Version

Include Page
IL:Versions - Trigger
IL:Versions - Trigger

Description

Include Page
IL:Summary
IL:Summary

Member of Business Services

Include Page
IL:Member of Business Services
IL:Member of Business Services

Calendar

Include Page
IL:Calendar - 6.4.2.0
IL:Calendar - 6.4.2.0

Anchor
Time Zone
Time Zone
Time Zone

Include Page
IL:Time Zone
IL:Time Zone

Task(s)

Include Page
IL:Triggered Tasks
IL:Triggered Tasks

Simulate
Include Page
IL:Simulate - trigger
IL:Simulate - trigger

Anchor
Purge By Retention Duration
Purge By Retention Duration
Purge By Retention Duration

Include Page
IL:Purge By Retention Duration
IL:Purge By Retention Duration

Anchor
Exclude Backup
Exclude Backup
Exclude Backup

Include Page
IL:Exclude Backup
IL:Exclude Backup

Anchor
Retention Duration
Retention Duration
Retention Duration

Include Page
IL:Retention Duration
IL:Retention Duration

Anchor
Retention Duration Unit
Retention Duration Unit
Retention Duration Unit

Include Page
IL:Retention Duration Unit
IL:Retention Duration Unit

Anchor
Execution User
Execution User
Execution User

Include Page
IL:Execution User - Trigger
IL:Execution User - Trigger

Forecast

Include Page
IL:Forecast
IL:Forecast

Simulate Forecast

Include Page
IL:Simulate Forecast
IL:Simulate Forecast

Status

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

Status

Include Page
IL:Status - Trigger
IL:Status - Trigger

Next Scheduled Time

Include Page
IL:Next Scheduled Time
IL:Next Scheduled Time

Anchor
Enabled By
Enabled By
Enabled By

Include Page
IL:Enabled By
IL:Enabled By

Anchor
Disabled By
Disabled By
Disabled By

Include Page
IL:Disabled By
IL:Disabled By

Anchor
Enabled Time
Enabled Time
Enabled Time

Include Page
IL:Enabled Time
IL:Enabled Time

Anchor
Disabled Time
Disabled Time
Disabled Time

Include Page
IL:Disabled Time
IL:Disabled Time

Skip DetailsThis section contains detailed information about skipping the trigger.

Anchor
Task Launch Skip Condition
Task Launch Skip Condition
Task Launch Skip Condition

Include Page
IL:Task Launch Skip Condition
IL:Task Launch Skip Condition

Anchor
Skip Restriction
Skip Restriction
Skip Restriction

Include Page
IL:Skip Restriction
IL:Skip Restriction

Anchor
Skip Count
Skip Count
Skip Count

Include Page
IL:Skip Count
IL:Skip Count

Anchor
Skip Before Date
Skip Before Date
Skip Before Date

Include Page
IL:Skip Before Date
IL:Skip Before Date

Anchor
Skip Before Time
Skip Before Time
Skip Before Time

Include Page
IL:Skip Before Time
IL:Skip Before Time

Anchor
Skip After Date
Skip After Date
Skip After Date

Include Page
IL:Skip After Date
IL:Skip After Date

Anchor
Skip After Time
Skip After Time
Skip After Time

Include Page
IL:Skip After Time
IL:Skip After Time

Anchor
Skip Date List
Skip Date List
Skip Date List

Include Page
IL:Skip Date LIst
IL:Skip Date LIst

Cron Details

This section contains assorted detailed information about the trigger.

Minutes

Include Page
IL:Minutes - Cron
IL:Minutes - Cron

Anchor
Hours
Hours
Hours

Include Page
IL:Hours - Cron
IL:Hours - Cron

Anchor
Day of Month
Day of Month
Day of Month

Include Page
IL:Day of Month - Cron
IL:Day of Month - Cron

Month

Include Page
IL:Month - Cron
IL:Month - Cron

Anchor
Day of Week
Day of Week
Day of Week

Include Page
IL:Day of Week - Cron
IL:Day of Week - Cron

Cron Criteria

Include Page
IL:Cron Criteria
IL:Cron Criteria

Anchor
Day Logic
Day Logic
Day Logic

Include Page
IL:Day Logic
IL:Day Logic

Restrictions

This section specifies any restrictions that apply to the trigger.

Anchor
Special Restriction
Special Restriction
Special Restriction

Include Page
IL:Special Restriction
IL:Special Restriction

Anchor
Action
Action
Action

Include Page
IL:Action
IL:Action

Anchor
Simple Restriction
Simple Restriction
Simple Restriction

Include Page
IL:Simple Restriction
IL:Simple Restriction

Anchor
Situation
Situation
Situation

Include Page
IL:Situation
IL:Situation

Anchor
Complex Restriction
Complex Restriction
Complex Restriction

Include Page
IL:Complex Restriction
IL:Complex Restriction

Anchor
Restriction Mode
Restriction Mode
Restriction Mode

Include Page
IL:Restriction Mode
IL:Restriction Mode

Anchor
Restriction Adjective
Restriction Adjective
Restriction Adjective

Include Page
IL:Restriction Adjective
IL:Restriction Adjective

Anchor
Restriction Noun
Restriction Noun
Restriction Noun(s)

Include Page
IL:Restriction Noun - 7.2.0.0
IL:Restriction Noun - 7.2.0.0

Anchor
Restriction Qualifier
Restriction Qualifier
Restriction Qualifier(s)

Include Page
IL:Restriction Qualifier - 7.2.0.0
IL:Restriction Qualifier - 7.2.0.0

Anchor
Restriction Nth Amount
Restriction Nth Amount
Restriction Nth Amount

Include Page
IL:Restriction Nth Amount
IL:Restriction Nth Amount

Self-Service Options This section contains Self-Service specifications for the trigger.
Enforce Variables
Include Page
IL:Enforce Variables -Trigger
IL:Enforce Variables -Trigger
Lock Variables
Include Page
IL:Lock Variables - Trigger
IL:Lock Variables - Trigger

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

Include Page
IL:Update button
IL:Update button

Anchor
Enable Trigger button
Enable Trigger button
Enable

Include Page
IL:Enable Trigger button
IL:Enable Trigger button

Anchor
Disable Trigger button
Disable Trigger button
Disable

Include Page
IL:Disable Trigger button
IL:Disable Trigger button

Trigger Now...

Include Page
UC77:IL:Trigger Now... button - 7.7UC77:
IL:Trigger Now... button - 7.7

List Qualifying Times

Include Page
IL:List Qualifying Times button
IL:List Qualifying Times button

Copy

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

Delete

Include Page
IL:Delete button
IL:Delete button

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

Include Page
IL:Variables tab
IL:Variables tab

Instances

Include Page
IL:Instances tab
IL:Instances tab

Notes

Include Page
IL:Notes tab
IL:Notes tab

Anchor
Versions tab
Versions tab
Versions

Include Page
IL:Versions tab
IL:Versions tab

...

Although you also can use a Time trigger to schedule a time interval for a task to be triggered on multiple days, you should use a Cron trigger if the time interval is not one by which the 24-hour clock is even divisible (2, 3, 4, 6, 8, and 12), such as in the Cron criteria examples, above. Using a Time trigger to schedule this type of time interval could produce unexpected results, since the time interval for a Time trigger does not reset at the end of the day. It continues into the next day, regardless of the 24-hour clock (see Scheduling a Time Interval with a Time Trigger).

...

The Controller allows you to generate a list of future dates and times that a trigger will trigger the specified task.
 

Step 1

Click the List Qualifying Times 794538021 button in the Cron Trigger Details. The List Qualifying Times Input dialog displays.
 

Step 2

Select a Number of Dates/Times (1 - 1000) that you want to list. The default is 30.

Step 3

Select a Start Date from when you want the list to begin.

Step 4

Click the Submit button to generate the list. For example:
 

...