Add and edit state transitions in workflow builder
- 1 Overview
- 2 Default transition
- 3 Viewing existing transitions in workflow builder
- 4 Editing a state transition
- 5 Transitions available to add for a state without an approval
- 6 Deleting a transition
- 7 Transitions from a state with an approval added
- 8 Transitions from the Rejected state in the Basic Approval Workflow
Overview
In workflow builder, you can use the state editor in the workflow panel to edit each state and add and edit transitions.
The number of current transitions from the state is displayed.
Choose Transitions (or +Transitions button in the navigator panel) to view and edit the existing transitions or add any new transitions for the state
Use the dropdown menus to choose:
the type of transition
the destination state for the transition
The approval transitions, Approved and Rejected are only available after an approval has been added to the state.
Only one of each type of transition is allowed from a state.
A Select transition cannot be used in the same state as an approval (Approved and/or Rejected transition)
Default transition
A new state will have the default transition that allows a user on the page to select any other state in the workflow as the destination state.
The transitions editor will display no transition type or destination state for the default 'any state' transition.
In a state with no approval added, you can add one of each of the select, updated or expired transitions.
If an approval is added to a state, you can only add one of each of the approved, rejected, updated or expired transitions.
If you add an approval to a state with an existing select transition, the workflow popup on the content will only display the approval Approve and Reject buttons.
Viewing existing transitions in workflow builder
Choose a state name in the workflow panel (or a state lozenge in the navigator panel).
This displays the state editor for the chosen state in the left-hand workflow panel.
The editor displays
the state name and,
the number of Transitions and Approvals for the state
Editing a state transition
The current state Approved in our example has a single transition.
Choose Transitions (or +Transitions button in the navigator panel) to add new transitions or edit the existing transitions from the state.
Use the dropdown menus to edit the type of transition and the destination state for each transition.
Choose Add to update the transitions for the state.
Transitions available to add for a state without an approval
If an approval has not been added to the state, the workflow limits the choice of transition to
Updated - the workflow transitions to the set destination state when the content is edited and saved
Expired - the workflow transitions to the set destination state when the Approved state due date is reached. A due date period must be set in the state editor
Select - the user chooses the destination state from one or more states using the workflow from the workflow popup. The options for the destination state are configured for the select transition by editing the state in the workflow
To add a new transition or amend an existing transition
choose the Transition (or the existing Updated) dropdown menu to select the available type of transition
choose the State (or for the Updated transition the existing Review state) dropdown menu to select the destination state for the transition
Choose Add to confirm any changes and update the transitions for the current state.
If you add a Select transition, add one or more destination states in the transitions editor.
The destination state for this select transition will be chosen from these states by the user using the workflow popup on the content.
Deleting a transition
To delete an existing transition highlight the transition.
Choose X to remove the transition.
Select Add to confirm the change and update the transition for the current state.
Transitions from a state with an approval added
When an approval is added to a state
the approved and rejected transition options become available for the state in the transitions editor
the select transition is not available
The Review state above, has three existing transitions
Updated is used to monitor any edits on the content in this state
Approved and Rejected transitions are components of the content review in the state
An Expired transition can be added if required.
Transitions from the Rejected state in the Basic Approval Workflow
The Rejected state in the Basic Approval Workflow has two existing transitions
Updated and Approved
Rejected and Expired transitions can be added to this state if required.