Transitions

Transitions

Transitions in Automation Builder Generation 2 behave a bit differently from transitions in Generation 1. Each task is only permitted to have one outgoing transition of each type (success, failure, and error), and loop and revert transitions are not supported.

The only exception to the one transition per task rule is the decision task. This task is used to choose an execution path among a sets of options based.

Adding Success Transitions

To add a transition between two unconnected tasks, click the Add Transition button to enter Add Transition Mode and click a task to transition to.

Add Transition

When hovering over a task while in Add Transition Mode, tasks which may be transitioned to will outline in green, while tasks that may not be transitioned to will outline in red. To find out why a particular task may not be transitioned to, click it to create a toast with a warning message explaining the violated rule.

Add Transition Mode: Green

Add Transition Mode: Red

Press the escape key or click on the empty canvas space to exit Add Transition Mode without adding a transition.

Adding Failure Handlers

To handle task failures, select the task to handle and use the Failure Handler settings of the Details tab in the Edit Task Menu.

Failure Handler

To use another task to handle failures in the current task, select the Task radio button option and either select the New Task option to create and connect to a new empty task, or select an existing task from the dropdown.

Failure Transition

To terminate the automation on task failure, use the associated radio button setting: End the automation.

Adding Error Handlers

To handle task errors, select the task to handle and use the Error Handler settings of the Details tab in the Edit Task Menu.

Error Handler

To use another task to handle errors in the current task, select the Task radio button option and either select the New Task option to create and connect to a new empty task, or select an existing task from the dropdown.

To terminate the automation on task failure, use the associated radio button setting: End the automation.

To use the automation-wide Error handler automation, select the third option in the menu.

Error Transition

Changing Error and Failure Visibility

Use the Visibility toggle button in the Primary actions menu to make the error and failure transitions and their tasks transparent.

Visibility Toggle

Visibility On

Visibility Off

Task Success, Failure, or Error

All tasks are able to return an Error or Success status. However, Evaluation tasks, Manual tasks, and Query tasks can return as a Failure. The differences between an Error and Failure are discussed in the next sections.

Task Failure

A task Failure is displayed on the Job Details page and will not show any output to identify what the issue was that caused the failure.

• A Manual task Failure can be triggered by manually working the task to send the workflow down a Failure transition.

• An Evaluation task will show a Failure that has a False return.

• A Query task can return either a Failure or an Error.

Task Error

An Error on the Job Details page will display an output message for what went wrong. This can be helpful for locating where the error occurred in the workflow and what troubleshooting may be needed.

• An issue in a JST task will result in an Error.

• An issue in a Query task can result in an Error or a Failure.