This site has moved to the integrated Appfire documentation and information site for our apps.

From February 2024 this site is no longer updated.

Take a look here! If you have any questions please email support@appfire.com

Transitions

Overview

The routes from one state to another destination state in your workflow are transitions. 

A transition is added to a workflow state. This transition can only take place if the workflow is the state which that transition starts from.

The types of transition available are

  • select

  • approve and reject (available when an approval is added to the state)

  • updated

  • expired (will only occur when added to a state, if that state has been configured with a due date)

One or more possible transitions can be added to a state but only one of each type of transition can be added to the state.

Transitions

Type of transition

The transitions available to add to a state are

select transition

  • a user can select a destination state using the workflow popup




  • select options available for the choice of destination state are set the workflow for the current state

  • the select transition cannot be present in a state when an approval is present in the state

approved transition

  • occurs when a user (or all assigned users) approve the content

  • can only be added to a state if the state has a content review (approval)

rejected transition

  • occurs when a user (or all assigned users) reject the content

  • can only be added to a state if the state has a content review (approval)

updated transition

  • occurs when a user edits and saves a change to the content

  • an updated transition will remove any reviewers previously assigned using the workflow popup

Adding or removing a label or attachment does not action the updated transition.

expired transition

  • occurs when a due date added to the state is reached

  • if no due date is added (or has been removed before the due date) no expiry will occur

  • the Content Expiry workflow has an expired transition added to the Approved state

A state can have one or more or all of these possible transitions. The approved and rejected transitions are only available when the state contains an approval (content review).

Transitions can also occur due to a trigger action. These can be added to the workflow as a JSON trigger.

Example - Basic Approval workflow transitions

In the Basic Approval Workflow, in the Review state the content can undergo one of three transitions


The approve and reject transitions are part of the content review named Review this page in the Review state.

These occur when a user chooses to either approve or reject the Review state content using the content review buttons in the workflow popup.

The workflow popup progress tracker displays the workflow states.

Mouse-over the approve or reject button to display ethe destination state for the content review decisions below the progress tracker bar.

If the content is edited and saved in the Basic Approval workflow Review state,  the page will remain in the Review state but the workflow will log this as a transition.

An updated transition will remove a reviewer from the content review if they had manually assigned using the workflow popup

In the published (final) Approved state, if the content is edited and saved, the page will move to the draft state Review



This transition is not implemented through the workflow popup. The workflow automatically transitions when the content is updated.

Pages or blogs in the Rejected state can be approved, and the page will transition to the Approved state. If the content is edited, the Simple Approval Workflow will transition the page or blog to the Review state:



The content review whilst in the Rejected state can also be rejected by a reviewer.

A rejection decision whilst in the Rejected state will not cause a transition in this example workflow. It will simply remain in the Rejected state, but the event of rejecting the content will be recorded in the workflow history.