1 Overview
2 Creating a Time Trigger
- 2.1 Time Trigger Details
- 2.2 Time Trigger Details Field Descriptions
3 Scheduling a Time Interval
- 3.1 Restrict Times
4 Generating a List of Qualifying Times

Overview

The Time trigger, similar to the Cron trigger, allows you to specify dates and times at which a task will be triggered.

With both Time and Cron triggers, you can define:

Simple date and times, such as "every weekday at 12:00 a.m."
Specific dates and times, such as "March 15 at 12:00 a.m."
A series of dates and times, such as "every Friday at every hour."
A mixture of specific dates/times and a series, such as "every Monday at 9 a.m."
Complex dates and times, such as "every 3 hours between 8 a.m. and 5 p.m. on the last business day of the year."

(Read Daylight Saving Time for details about how Universal Controller handles Daylight Saving Time.)

If you want to schedule time intervals for triggering a task on multiple days, use the trigger type (Time or a Cron) that allows you to most accurately select the scheduling parameters (see Scheduling a Time Interval, below).

Creating a Time Trigger

Step 1	From the Automation Center navigation pane, select Triggers > Time Triggers. The Time Triggers list displays. To the right of the list, Time Trigger Details for a new Time trigger displays.
Step 2	Enter/select Details for a new Time 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).

Time Trigger Details

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

Time Trigger Details Field Descriptions

The following table describes the fields, buttons, and tabs that display in the Time 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.
Purge By Retention Duration	Specification for whether triggered task instances can be purged by retention duration.
Exclude Backup
Retention Duration
Retention Duration Unit
Execution User
Forecast
Simulate Forecast
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
Time Details	This section contains assorted detailed information about the trigger.
Time Style
Time
Time Interval	Note See Scheduling a Time Interval, below, for information on using a Time Trigger to schedule a time interval for triggering a task. Also see Time Trigger Minimum Frequency In Seconds Universal Controller system property to the define the minimum time interval that must be used.
Time Interval Units
Enable Offset
Initial Time Offset (hh:mm)
Day Details	This section contains assorted detailed information about the trigger day.
Day Style
Daily
Business Days
Specific Day(s)
Date Adjective
Nth Amount
Date Noun(s)
Date Qualifier(s)
Date Adjustment
Adjustment Amount
Adjustment Type
Day Interval
Interval Start
Restrictions	This section specifies any restrictions that apply to the trigger.
Restrict Times
Enabled Start
Enabled End
Adjust Interval To Enabled Start
Special Restriction
Simple Restriction
Situation
Action
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...
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
Versions