Tasks in Automation Builder represent individual actions taking place. They are the unit from which business logic can be built and fleshed out in Gen 2 Automation Builder. Each task takes a known set of input parameters and produces a known set of output value. In almost every case, each task produces just one output; however,
childJob may produce multiple output values depending on the task configuration. If a task encounters an error, that error may be accessed through a special output value called
Tasks may be created by clicking the Add Node button when the canvas is zoomed to 100%.
Canvas 100% Zoom
Alternately, tasks may be created by clicking the Add Node menu option for lower canvas zoom levels.
Both options will create a new empty task between the Start task and End task that was provided with the automation.
In addition, tasks may be inserted between two existing, connected tasks by hovering over the success transition connecting them and selecting the Insert Node menu option.
Newly created tasks are always empty, and require assignment to a method before they can be run. In order to assign a method to a New Node, click to select it and then use the Task Explorer menu to assign the desired method.
New Task Node
Search for methods either by their containing application name or by method name to filter and expand the menu.
Search & Filter Task Methods
Click the desired item (method) to assign it to the task and have it added to the task configuration menu.
Method Assigned to Task
To configure a task, click it on the canvas to select it. This will open the Task Configuration panel in the right-hand sidebar. If multiple tasks are selected, the Task Configuration panel will not open.
The Details tab of the Task Configuration panel describes the basic properties of a task, including its Summary, Description, and Actor, as well as its Error Handler and Failure Handler settings.
- The Summary and Description fields may be edited using their respective text areas. Note that the Summary field is used to identify the task throughout the automation, and the title displayed for the task on the canvas will change as the Summary is edited.
- The Actor field is only available on Automatic tasks, and denotes which system user will be marked as responsible for running the task. It may be managed using the Actor dropdown in the Details tab.
- The Groups field is only available on Manual tasks, and denotes which groups of users are permitted to work the task in a job. It may be managed by typing to search for a group, and then clicking the desired group to add it.
- See the Transitions documentation for more details on managing Error Handler and Failure Handler.
Configuring Task Details
The Variables tab contains an expandable panel for each available input parameter for the current task. Each panel will contain the name and type of the parameter, and will designate which variables are required parameters.
Configuring Task Variables
The data provided to a task may come from one of several different sources. The source of the data is specified with the Reference Task dropdown.
Selecting Static from the the Reference Task dropdown denotes a value which is manually entered and will be the same every time the automation is run. Select the radio button for the value editor to provide a value, or select the radio button for None to pass no value in for the parameter.
Selecting Job denotes a value which is provided when the automation is initiated. Use the Reference Variable dropdown to select which job input to use for the current task input. Select custom to enter a custom variable name.
Custom Job Variable
Selecting the summary of another previous task from the Reference Task dropdown will designate the output of that value be provided as the input value for the current task. Select the output variable to use in the Reference Variable dropdown.
You can mask all outgoing variables on a task, or mask individual incoming variables.
Mask Incoming Variables
Mask Outgoing Variables
Like in the legacy canvas, masked variables will appear as hidden in the Job Manager views.
Mask Variable Result - Incoming
Mask Variable Result - Outgoing
The Schedule tab is used to designate windows of time in which a task may run. This is useful for requiring specific tasks to be run during maintenance windows.
Configuring a Task Schedule
Select a value source using the Select Mode dropdown. Static activates the input controls. Enter a Start and End time, as well as Days of the Week. The Start time must be before the End time.
Set Schedule Times
To delete a task, open the Secondary actions menu on the task using the three-dot button (ellipsis) and select the Delete option.
Deleting a Task
To select a single task, click it on the canvas. To select multiple tasks, hold the Shift key, and either click multiple tasks, or click and drag to select tasks by drawing a box.
To copy a task, open the Secondary actions menu using the three-dot button and select the Clone option.
Clone a Task