State selection transitions
- Robert Alexander Marshall
State selection transitions
These transitions are actioned by users selecting a state from a drop-down list in the workflow popup.
See also: States, Administrator state override
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.
Although the destination states are listed in the transitions editor you cannot 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.
Further information
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 are displayed 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.
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.
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
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.