Versions Compared

Key

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

...

<ul> <li>
  • To
  • find
  • a
  • specific
  • task,
  • type
  • the
  • name
  • into
  • the
  • Task
  • name
  • field
  • and
click <b>Search</b>. <li> To display a list of tasks whose names match a string, type the string into the Task name field and use one or more

wildcards

. Wildcard(s) can appear anywhere in the string. For example, to find tasks whose name begins with "Fee", type <b>Fee</b> in the Task name field and click <b>Search</b>. <li> To display a list of tasks of a specific type, such as Windows, select the task type from the drop-down menu and click <b>Search</b>. <li> To display a list of all tasks, select All Task Types (the default selection) from the drop-down menu and click <b>Search</b>. </ul>
  • click Search.
  • To display a list of tasks whose names match a string, type the string into the Task name field and use one or more wildcards. Wildcard(s) can appear anywhere in the string. For example, to find tasks whose name begins with "Fee", type Fee in the Task name field and click Search.
  • To display a list of tasks of a specific type, such as Windows, select the task type from the drop-down menu and click Search.
  • To display a list of all tasks, select All Task Types (the default selection) from the drop-down menu and click Search.

The Task Find dialog lists the task(s) that match your search criteria.
 

Step 1

Click the Add Task icon. The Task Find dialog displays.
 

Step 2

Several methods are available for finding tasks:

Html bobswift
Html bobswift

Step 3

To add a task to the Workflow Editor canvas, click the icon to the left of the task and drag it onto the canvas.
 
You can add any task to a Workflow multiple times. To differentiate between multiple additions of the same task in a Workflow, you can assign each of them a unique name used only within the Workflow; the name of the task in the Task Details will not change. To change the name of a task within a Workflow, display the Task Properties menu and select a new name in the name field.

Step 4

Repeat these steps until you have added all the tasks you need.

Step 5

Position the tasks on the canvas as desired. The connections that you will make between the tasks determine the order in which the tasks run, so position the tasks accordingly. For example:
 

Step 6

To close the Task Find window, click the X in the upper right corner. Or, to keep the window open but minimized, click the minimize icon.

...

Field Name

Description

Type

User-defined; indicates whether this is providing instructions on when to run or not run the task.
 
Options:

  • Run Criteria - Provides instructions on when to run the task.
  • Skip Criteria - Provides instructions on when to skip the task.

Description

Include Page
IL:Summary
IL:Summary

Task

User-defined; task for which you are specifying run or skip criteria. Select a task from the drop-down list of all tasks in this Workflow.

Vertex ID

Vertex ID of the task selected in the Task field. Each task within a Workflow has a unique Vertex ID, which distinguishes it from other tasks of the same name, if any.

Business Day

If enabled, the task runs or skips on all business days.

Anchor
Holiday
Holiday
Holiday

If enabled, the task runs or skips on holidays.

Anchor
Adjustment - H
Adjustment - H
Adjustment

If Holiday is enabled; Specification for adjusting a Holiday by a less or plus number of days or business days.

Options:

  • -- None --
  • Less
  • Plus

Default is – None --

Anchor
Adjustment Amount - H
Adjustment Amount - H
Adjustment Amount

If Adjustment is Less or Plus; Number of days or business days to adjust a Holiday.

Default is 1.

Anchor
Adjustment Type - H
Adjustment Type - H
Adjustment Type

If Adjustment is Less or Plus; Type of day by which to adjust a Holiday.

Options:

  • Day
  • Business Day

Default is Day.

Specific Day(s) – Sunday through Saturday

If enabled, the task runs or skips on the day(s) you select in the right-hand column.

Anchor
Custom Day
Custom Day
Custom Day

If enabled, the task runs or skips on the day you select in the Custom Day Choice field.
 

Note
titleNote

The Custom Day and Custom Day Choice fields display in the Task Run Criteria Details only if the Custom Day Global Permitted Universal Controller system property is set to true (the default).


Anchor
Custom Day Choice
Custom Day Choice
Custom Day Choice

If Custom Day is enabled, select the custom day for which you are specifying run or skip criteria. Enter the name of an existing Custom Day, select a Custom Day from the drop-down list of all existing Custom Days, or click the Details icon to create a new Custom Day.
 
Only a global custom day can be selected for a Custom Day Choice. Use Complex run criteria to use a local custom day.
 
If a workflow is launched using a calendar which does not contain the custom day specified for the Custom Day Choice, the following applies:

html-bobswift

<ul> <li>

  • Run
  • Criteria
  • with
  • the
  • specified
  • custom
  • day
  • will
  • evaluate
  • to
  • false.
  • If
  • no
  • other
  • criteria
  • was
  • specified,
  • the
  • task
  • will
  • be
  • skipped.
<li>
  • Skip
  • Criteria
  • with
  • the
  • specified
  • custom
  • day
  • will
  • evaluate
  • to
  • false.
  • If
  • no
  • other
  • criteria
  • was
  • specified,
  • the
  • task
  • will
  • not
  • be
  • skipped.
</ul>
Note
titleNote

You cannot use a custom day defined as a period as part of the task run criteria.


Anchor
Complex
Complex
Complex

If enabled, the task runs or skips on the day(s) indicated in the Adjective, Noun, and Qualifier fields.

Anchor
Adjective
Adjective
Adjective

If Complex is enabled, you can use this field to specify which in a series of days you want to select. Used in conjunction with the Noun, Qualifier, and Nth Amount (if Adjective = Nth) fields. For example, to specify "the 15th business day of the month," select Adjective: Nth, Noun: Business Day, Qualifier: Month, Nth Amount: 15.
 
Options:

  • Every
  • 1st
  • 2nd
  • 3rd
  • 4th
  • Nth
  • Last

Anchor
Noun
Noun
Noun(s)

If Complex is enabled, you can use this field to specify the type of day(s) you want to select.

Used in conjunction with the Adjective, Qualifier, and Nth Amount (if Adjective = Nth) fields. For example, to specify "the 1st business day of the month," select Adjective: 1st, Noun: Business Day, Qualifier: Month.
 
Options:

  • Sunday through Saturday
  • Day = any day
  • Business Day = The business days specified in the calendar selected in the Workflow definition Default Calendar field.
  • Custom Days specified in the calendar selected in the Workflow definition Default Calendar field.

Anchor
Qualifier
Qualifier
Qualifier(s)

If Complex is enabled, you can use this field to specify the period(s) for your selection formula.

Used in conjunction with the Adjective, Noun, and Nth Amount (if Adjective = Nth) fields. For example, to specify "the 1st business day of the month," select Adjective: 1st, Noun: Business Day, Qualifier: Month.
 
Options:

Anchor
Nth Amount
Nth Amount
Nth Amount

If Adjective = Nth; Sequential occurrence of the day selected in Noun within the selected Qualifier.

Anchor
Adjustment - C
Adjustment - C
Adjustment

If Complex is enabled; Specification for adjusting a complex day by a less or plus number of days or business days.

Options:

  • -- None --
  • Less
  • Plus

Default is – None --

Anchor
Adjustment Amount - C
Adjustment Amount - C
Adjustment Amount

If Adjustment is Less or Plus; Number of days or business days to adjusting a complex day.

Default is 1.

Anchor
Adjustment Type - C
Adjustment Type - C
Adjustment Type

If Adjustment is Less or Plus; Type of day by which to adjust a complex day.

Options:

  • Day
  • Business Day

Default is Day.

Anchor
Variable
Variable
Variable

If enabled, instructs the Controller to run or not run the task, depending on the value of a specific variable. Used in conjunction with fields: Evaluate At, Name, Operator, and Value.

Anchor
Evaluate At
Evaluate At
Evaluate At

If Variable = enabled; Allows you to specify when you want the Controller to evaluate the variable.
 
Options:

html-bobswift

<ul> <li>

  • Trigger
  • Time
  • --
  • Evaluate
  • the
  • variable
  • when
  • the
  • Workflow
  • is
  • triggered.
<li>
  • Run
  • Time
  • --
  • Evaluate
  • the
  • variable
  • when
  • the
  • task
  • is
  • about
  • to
  • run.
</ul>
Note
titleNote

Evaluate At is applicable only to Variable criteria (it is hidden until the Variable field is enabled). Evaluate At has no impact on other criteria, which will resolve the same way whether the Evaluate At value is Trigger Time or Run Time; calendar-based criteria is always evaluated using the task instance Trigger Time (or the task instance Created time, if the workflow was launched manually).


Anchor
Name
Name
Name

If Variable = enabled; Specifies the name of the variable being evaluated. The variable does not need to exist when this record is created.

Anchor
Operator
Operator
Operator

If Variable = enabled; Allows you to select the operator to be used in the evaluation. Options: =, !=, >, >=, <, <=, regex (regular expression).

Anchor
Value
Value
Value

If Variable = enabled; Allows you to specify the value or regular expression (up to 255 alphanumeric characters) that the Controller should look for when evaluating the variable.

Buttons

This section identifies the buttons displayed above and below the Task Run Criteria that let you perform various actions.

Save

Saves a new record in the Controller database.

Update

Include Page
IL:Update button
IL:Update button

New

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

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 Database Connection.

...

Step 1

In the Workflow Monitor, right-click any white space in the Workflow Editor canvas.

Step 2

Click Insert Task.... The Task Insert > Task Selection dialog displays.

Step 3

Find the task you want to insert (see Searching For and Adding Tasks) and drag the task's icon onto the Workflow Editor canvas where you would like it to be inserted.

Step 4

The Task Insert > Predecessor/Successor Selection dialog displays.
 

Step 5

Select zero or more predecessors and zero or more Successors for the inserted task.

Step 6

By default, the inserted task will inherit the Trigger Time of the parent Workflow. If the Trigger Time of the parent Workflow is undefined, the Launch Time will be inherited as the Trigger Time instead. For task instances within an inserted Workflow, Run Criteria will be evaluated using the inherited Trigger Time.
 
If you do not want the inserted task to inherit the Trigger Time of the parent Workflow, de-select the Inherit Trigger Time field (by default, it is pre-selected).
 
For task instances within an inserted Workflow that did not inherit the Trigger Time of the parent Workflow, Run Criteria will be evaluated using the Created Time.

Step 7

Click OK. The Controller inserts the task as a successor to the selected predecessor task instance(s) and as a predecessor to the selected successor task instance(s).

html-bobswift

<ul> <li>

  • When
  • the
  • selected
  • predecessor
  • task
  • instances
  • complete,
  • the
  • inserted
  • task
  • will
  • start
  • to
  • run,
  • assuming
  • that
  • all
  • of
  • its
  • dependencies
  • (for
  • example,
  • virtual
  • resources)
  • have
  • been
  • met.
<li>
  • If
  • the
  • selected
  • successor
  • task
  • instances
  • had
  • not
  • already
  • started,
  • they
  • will
  • wait
  • until
  • the
  • inserted
  • task
  • completes
  • and
  • all
  • of
  • their
  • other
  • dependencies
  • have
  • been
  • satisfied.
</ul>
Note
titleNote

Any predecessor task that is in a SUCCESS, FINISHED, or SKIPPED status will not prevent the inserted task from running.

 
For inheritance of actions on Defined status, refer to Universal Controller property Inherit Actions On Defined For Insert Task.

...

<ul> <li>
  • Run
  • -
  • Task
  • border
  • is
  • gray
  • and
  • solid.
<li>
  • Skip
  • -
  • Task
  • border
  • is
  • red
  • and
  • solid.
<li>
  • Not
  • Evaluated
  • -
  • Task
  • border
  • is
  • gray
  • and
  • dotted.
  • (Run/skip
  • criteria
  • for
  • this
  • task
  • is
  • dependent
  • on
  • variable
  • resolution;
  • could
  • not
  • be
  • evaluated.)
</ul>

If

you

Critical Path Color

system property. <li> Run/skip criteria is resolved based upon the date specified in the Forecast option. </ul>

enabled

<b>Calculate Critical Path</b>: <ul> <li> Task instances and connectors in the Critical Path display in the color specified by the

 Calculate Critical Path:

  • Task instances and connectors in the Critical Path display in the color specified by the Critical Path Color system property.
  • Run/skip criteria is resolved based upon the date specified in the Forecast option.

Step 1

From the Automation Center navigation pane, select Tasks > All Tasks or Tasks > Workflow Tasks.

Step 2

Display an Action menu either of three ways:

  • Right-click the Workflow in the All Tasks or Workflow Tasks list.
  • Open the Workflow and right-click in the Details.
  • Open the Workflow, click the Triggers tab, and right-click a Trigger on the list.

Step 3

Click Forecast... to display a Forecast dialog.
 

Step 4

Select a Date, Time, Time Zone, and Calendar for when you want to forecast the Workflow (and all of its sub-Workflows, if any).

html-bobswift

<ul> <li>

  • If
  • you
  • selected
  • Forecast
  • from
the <b>All Tasks</b> list, <b>Workflow Tasks</b> list, or Workflow Details, the default Calendar of the Workflow displays. <li> If you selected Forecast from the Triggers tab list, the default Calendar of the selected Trigger displays. </ul>
  • the All Tasks list, Workflow Tasks list, or Workflow Details, the default Calendar of the Workflow displays.
  • If you selected Forecast from the Triggers tab list, the default Calendar of the selected Trigger displays.

By default, the Time Zone field is read-only and displays the time zone in the Forecast Time Zone field, since the Use Forecast Time Zone field is checked.
 ;
The Forecast Time Zone field allows you to change what time zone this forecast of the Workflow will evaluate in. It defaults to the time zone of the Controller but can be modified to another time zone.
 
Uncheck the Use Forecast Time Zone field if you want to enable the Time Zone field and enter a different time zone.
 
The Forecast Time Zone and Use Forecast Time Zone fields allow the forecast to evaluate as if in one time zone, and also allow the Date and Time of the forecast to be based upon another time zone. The time zone associated with the Date and Time is used only for calculating the Date and Time at which the forecast starts.
 
For example, a Forecast could be executed to run at a specific date and time with respect to Time Zone, and yet the Forecast itself will execute, and evaluate Run Criteria and Execution Restrictions, based upon the Forecast Time Zone.

Step 5

Select a View in which you want to display the Forecast: Workflow or List.

Step 6

If you selected Workflow View, a Calculate Critical Path field displays. Enable/disable this field depending on whether or not you want to calculate the Critical Path of the Workflow.

Step 7

Click Submit to display the Forecast in the selected View.
 
Workflow View
 

 
In the Workflow View, each task has a Run Criteria evaluation label:

Html bobswift
Html bobswift
Note
titleNote

You can choose to show or hide skipped tasks in the Workflow View of the Forecast just as you can on a Workflow Monitor.

If Calculate Critical Path is enabled, skipped task instances are hidden, and the Show Skipped/Restore and Hide Skipped context-menu items are not available.

If Calculate Critical Path is enabled, but you want to see skipped task instances, you can restore the standard view by clicking the Toggle Critical Path View icon in the Workflow Forecast toolbar (see Workflow Editor Toolbar for a description of the tools in this toolbar).

 
The Workflow View lets you navigate into sub-Workflows (by double-clicking them) and back to the parent Workflow (via the Go to Parent icon).
 
 
List View
 

 
The List View displays forecast data for the Workflow and all of its tasks, including all sub-Workflows and their tasks.

...