All states
By default, each state can transition directly to all other states. All other states in the workflow appear as destination state options in the workflow popup.
Setting any other type of transition for a state disables the default state selection.
{workflow:name=All states}
{state:A}
{state}
{state:B}
{state}
{state:C}
{state}
{workflow}
The transition option will default to All states if
- a state is added to a workflow without specifying the transition
- all the existing state transitions are removed
In workflow builder, the All states transition will be displayed in the editor without a named transition selected.
Note that although the destination states are listed in the transitions editor you will not be able to set a destination state in workflow builder for the All states transition.
The visual workflow diagram displays a state with the default All states transition with a select destination to each of the other states.
In our example all the states have the default All states transition.
See: Edit transitions in workflow builder
Specific state(s)
The {state-selection} macro lists states which can be transitioned to, and in what order.
Options for the specified destination state names, in the specified order, appear in the workflow popup.
{workflow:name=Specific state(s)}
{state:A}
{state-selection:states=C,B}
{state}
{state:B}
{state}
{state:C}
{state}
{state:D}
{state}
{workflow}
In workflow builder you can add the state selection transition by
- choosing Select as the transition type
- choose the options for the destination state(s) from the State dropdown menu.
The states added will be added as user options in the workflow popup.
A Select transition can be added to the state together with
- one or more conditions for the transition to occur
- one or more additional transitions for the state
The additional state transitions can only be Updated, Expired and Tasks Completed.
See: State content transitions, Edit states using workflow builder, Edit transitions using workflow builder
Some transitions cannot be used in a state at the same time as others
For example in workflow builder
- you cannot add a Submit transition to a state with an existing Select transition
- the Select transition will not be available in the transitions editor if the state already contains a content review
- adding a content review (approval) to a state with an existing Select transition will display the approval review buttons in the workflow popup. The Select transition options in the popup will not be available for the user
Macros: {state}, {state-selection}
One state
The submit parameter limits transition to just one state.
The single option for the specified destination state appears in the workflow popup.
{workflow:name=One state}
{state:A|submit=C}
{state}
{state:B}
{state}
{state:C}
{state}
{workflow}
In workflow builder choose the Submit transition in the state transitions editor and the single destination state.
One or more additional state transitions can be added.
The additional state transitions can only be Updated, Expired and Tasks Completed.
See: State content transitions
Some transitions cannot be used in a state at the same time as others
For example in workflow builder
- you cannot add a Select transition to a state with an existing Submit transition
- the Submit transition will not be available in the transitions editor if the state already contains a content review
- adding a content review (approval) to a state with an existing Submit transition will display the approval review buttons in the workflow popup. The Submit transition option in the popup will not be available for the user
No state
The hideselection parameter removes the default direct state transitions.
If the state has the default All state transition
- no state destination options are shown in the workflow popup
- an administrator can use the Administrator state override to transition the state.
If the state has an added transition
- the transition options will be shown in the workflow popup but only an administrator will be able to action the transition using the workflow popup options
{workflow:name=No state}
{state:A|hideselection=true}
{state}
{state:B}
{state}
{state:C}
{state}
{workflow}
In workflow builder the No State option is set by editing the state not in the state transition editor.
In the state editor, simply check the Advanced option Hide Selection.
