Transitions

Transitions connect tasks and control the order of task execution. Before adding a transition, a user must select a transition binding (a loop or a leading task's finish state: success, error, or failure) and a transition direction (standard, revert).

Transitions states are based on either the finish state of the previous task or on a forEach loop.

1. Finish state indicates:
   • If an automatic task encountered a problem.
   • If an evaluation task matches an evaluation expression.
2. Transition binding values include:
   • Success:
     • A leading task's finish state.
     • An automatic task did not encounter a problem.
     • A manual task associates a button to a success finish state, as specified by the developer.
     • An evaluation task matched an evaluation expression.
   • Error:
     • A leading task's finish state.
     • An automatic task encountered a problem.
     • A manual task associates a button to an error finish state, as specified by the developer.
   • Failure:
     • A leading task's finish state.
     • An evaluation fails to match an evaluation expression.
     • A manual task associates a button to a failure finish state, as specified by the developer.
   • Loop:
     • The forEach loop starts a sequence of tasks to be executed one or more times.

Transition direction refers to the direction of the transition.

1. Standard:
   • Transition moves job execution forward from start toward end.
2. Revert:
   • Transition moves job execution backwards toward start.
   • All previously completed tasks and their data from revert point forward are cleared (including the destination task of the revert transition).
   • Data is saved, not destroyed, but it is not used.

Like tasks, transitions are color-coded.

• Green transitions are bound to the success finish of prior tasks state.
• Red transitions are bound to prior tasks' error or failure finish states. (Place the cursor over the transition, and a tool tip reveals error or failure.)
• Blue transitions are bound to a forEach operation task.
• Solid lines represent standard transitions.
• Dashed lines represent revert transitions.

Add a Transition to a Workflow

On the Workflow Builder canvas page, select a transition binding (example: success) from the Transition Binding dropdown.

1. Select a transition direction (example: standard) from the Transition Direction dropdown.

2. To add the new transition, click the Add transition button or press the "t" key to enter transition mode.

3. To exit this mode, you must draw a transition or press the "y" key.

4. Click the START terminator, drag your cursor to the getNEDs task, and release.

5. Workflow Builder will draw an arrow to connect the two (see figure below).

   • Transition mode closes after a transition is drawn. You must repeat steps 3-4 to draw another transition.

   Figure: Add a transition

   

Delete a Transition

To delete a transition:

1. On the Workflow Builder canvas page, select the transition you want to delete.
2. Click the Delete button or press the "d" key.
3. Click SAVE or UPDATE in the title bar to save changes.