Gen2 Automation Builder

On this page:



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, transformation and 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 error.

Example Task

Task example

Creating Tasks

Tasks may be created by clicking the Add Node button when the canvas is zoomed to 100%.

Canvas 100% Zoom

Create task: 100% zoom

Alternately, tasks may be created by clicking the Add Node menu option for lower canvas zoom levels.

Add Node

Create task: Menu

Both options will create a new empty task between the Start task and End task that was provided with the automation.

New Task

Create task: Result

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.

Insert Task

Insert task: 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

Insert task: Result

Task Explorer

Task explorer

Search for methods either by their containing application name or by method name to filter and expand the menu.

Search & Filter Task Methods

Task explorer filtered

Click the desired item (method) to assign it to the task and have it added to the task configuration menu.

Method Assigned to Task

Task assigned

Configuring Tasks

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

Details tab


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

Variables tab

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.

Static Variable

Static variable value

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.

Job Variable

Job variable select

Custom Job Variable

Job variable custom

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.

Reference Variable

Task reference

You can mask all outgoing variables on a task, or mask individual incoming variables.

Mask Incoming Variables

Mask Incoming

Mask Outgoing Variables

Mask Outgoing

Like in the legacy canvas, masked variables will appear as hidden in the Job Manager views.

Mask Variable Result - Incoming

Mask Incoming

Mask Variable Result - Outgoing

Mask 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

Schedule tab

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

Schedule tab static

Deleting Tasks

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


Selecting Tasks

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.

Selecting Tasks

Select multiple tasks

Copying Tasks

To copy a task, open the Secondary actions menu using the three-dot button and select the Clone option.

Clone a Task

Clone task