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.
| Code Block | ||||
|---|---|---|---|---|
| ||||
{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.
| Info |
|---|
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.
| Info |
|---|
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.
| Code Block | ||||
|---|---|---|---|---|
| ||||
{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.
| Info |
|---|
Further information: |
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
{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.
| Code Block | ||||
|---|---|---|---|---|
| ||||
{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.
| Info |
|---|
Further information: |
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
| Code Block | ||||
|---|---|---|---|---|
| ||||
{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.
| Info |
|---|
Further information: |
|