Panel | |
---|---|
|
...
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 | ||
---|---|---|
| ||
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. |
---|---|
Step 2 | Enter/select Details for a new Cron trigger, using the field descriptions below as a guide.
To display more of the Details fields on the screen, you can either:
|
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:
|
...
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.
Anchor | ||||
---|---|---|---|---|
|
...
Field Name | Description | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
General | This section contains general information about the trigger. | ||||||||||||
Name |
| ||||||||||||
Version |
| ||||||||||||
Description |
| ||||||||||||
Member of Business Services |
| ||||||||||||
Calendar |
| ||||||||||||
|
| ||||||||||||
Task(s) |
| ||||||||||||
Simulate |
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
Forecast |
| ||||||||||||
Simulate Forecast |
| ||||||||||||
Status | This section contains information about the current status of the trigger. | ||||||||||||
Status |
| ||||||||||||
Next Scheduled Time |
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
Skip Details | This section contains detailed information about skipping the trigger. | ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
Cron Details | This section contains assorted detailed information about the trigger. | ||||||||||||
Minutes |
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
Month |
| ||||||||||||
|
| ||||||||||||
Cron Criteria |
| ||||||||||||
|
| ||||||||||||
Restrictions | This section specifies any restrictions that apply to the trigger. | ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
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 |
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
Trigger Now... |
| ||||||||||||
List Qualifying Times |
| ||||||||||||
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 |
| ||||||||||||
|
|
...
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: |
...