Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
maxLevel2
minLevel2
absoluteUrltrue
excludeSee also
typeflat
separatorpipe

Overview

When a state is selected in the workflow panel or the (navigator panel) the transitions, state parameters, approvals, and tasks are listed in the state editor (as applicable to the state).

Image RemovedImage Added

Choosing Transitions opens the Transitions editor

  • existing transitions can be edited or removed

  • new transitions added

When the state has an approval added:

  • the approve and reject transitions will be available

  • the select and submit transitions will not be available

Each state can have more than one possible transition to a destination state in the workflow.

Edit states using workflow builderRelated pages

Filter by label (Content by label)
showLabelsfalse
showSpacefalse
cqllabel = "edit-state-wfb" and space = currentSpace ( )

State transitions editor

When a state is displayed in the state inspector panel choose Transitions to open the transitions editor for the current state.

Image RemovedImage Added

Any existing added transition types from the current state and transition destination state (or destination state options for a select transition) will be  are displayed.

Edit an existing transition

Choose an existing transition to change the transition type and/or the destination state using the dropdown menus.

Image RemovedImage Added

Choose Add to save the change.

Remove a transition

Mouse over a transition and choose the popup to remove a transition.

Image RemovedImage Added

To save the changes to the state, ensure you choose Apply.

Add a new transition

One or more transitions can be added to a state by choosing

  • the type of transition from a Transition dropdown menu

  • the destination state from a State dropdown menu

Choose the Transition dropdown menu.

Image RemovedImage Added
    Choose
    • select a transition from the available transition types

    .
    Info

    To complete the transition, you must configure the destination state (or if select transition is chosen one or more destination states)

    .

    Choose
    • choose the State

    v
    • dropdown menu for the new transition

    .
    Image AddedImage Removed
    Tip

    For a submit transition only one destination state is possible. Use the select transition if you want to provide the user a choice of destination state.

    Image RemovedImage Added

    To amend changes to state transitions, choose Add.

    Info

    To avoid the loss of transition changes in the state you must then

    • add the changes to the workflow by choosing Save in the Navigation panel

    • add the updated workflow to the content or dashboard by selecting Exit in the Navigation panel

    Approved and Rejected transitions

    The Approved and Rejected transitions will are only be available after and an approval has been added to the state.

    Image RemovedImage Added
    Info

    There is no requirement to add both the Approved and Rejected transition. Only one is required for the approval.

    Adding an approval to the state restricts the choice of other transitions for the state - the submit and select transitions cannot be added.

    Image RemovedImage Added

    Adding a condition for a transition

    For Select transitions, one or more conditions can be added that must be met for the select transition to be active.

    Image RemovedImage Added

     Conditions for a select transition include

    • haslabel requiring the content to have the label or labels added as the condition value

    • user requires the current user to be one of the added users added as users as the condition value

    Image RemovedImage Added
    Tip

    Check Invert to make the condition valid when the value(s) specified is not present.

    If the condition is not met then the workflow popup on the content will not display the select transition option.

    Image RemovedImage Added

    For more detail on the Select transition see the state-selection macro and also conditions.

    See also

    Edit states using workflow builder

    Filter by label (Content by label)showLabelsfalseshowSpacefalsecqllabel = "edit-state-wfb" and space = currentSpace ( )

    Using Workflow Builder

    Workflow Authoring Guide

    Administration Guides