State content transitions

These transitions are actioned by changes to the content e.g. page edits; reaching the state expiry date; content approval or rejection, completing added tasks.


See also: StatesAdministrator state override, Tasks, Content reviews

Content review transitions

Similar to a state selection transition, but the focus is on reviewing content rather than choosing a state (the workflow determines which state to go to depending on outcome of the review).

The user chooses to Approve or Reject, and the workflow transitions to the appropriate state (as defined in the approved and rejected parameters). Approve and Reject buttons in the Workflow Popup.


{workflow:name=Content review}
  {state:A|approved=C|rejected=B}
     {approval:Review}
  {state}
  {state:B}
  {state}
  {state:C}
  {state}
{workflow}


In workflow builder the approved and rejected transitions for the content review are only available when a content review (aopproval) has been added to the state.


If the approval is added to the state but the Approved and Rejected transitions are not added

  • the workflow popup will still display the Approve and Reject buttons
  • if a user rejects or approves the content the workflow will simply remain in the current state
  • no transition will occur
  • any approval decision will still be recorded in the page activity report

You do not need to add both the Approved and the Rejected transition.


Note that a content review transition may also occur when a trigger listens for an event and uses one of the following action macros to approve or reject the content.

Action macros: {approve-page}{reject-page}{approve-children}{reject-children}

The following events are related to approvals.

Eventspageapprovednewsapprovedpagerejectednewsrejectedpageapprovalassignednewsapprovalassignedapprovalunassigned


See also: ReviewsContent reviewsCustomise Approval Buttons

Macros{state}{approval}


Content expiry transition

States can be given an expiry date, after which a transition can occur.

If the state expires whilst it is active

  • the duedate parameter determines the expiry date
  • the expired parameter specifies which state to transition to 

An expiry indicator appears in the workflow popup.


{workflow:name=State expiry}
  {state:A|duedate=P1W|expired=C}
  {state}
  {state:B}
  {state}
  {state:C}
  {state}
{workflow}



The state expiry transition can be added to the state in the transition editor using workflow builder.


The transition will only occur if a due date has been added to the state and the Expired transition was added before the due date.

Any other of the state transitions can be added with the Expired transition.


Macros{state}{set-state-expiry}

Eventsstateexpired

See also: Expiry DatesState expiry dateState expiry dates


Updated content transition

States can automatically transition should content be updated (edited).

The updated parameter specifies the state to transition to if the content is updated.

If used on a state that has final=true parameter, the workflow popup will show a message about the publishing process, otherwise it will be empty.


{workflow:name=Content update}
  {state:A|updated=C|final=true}
  {state}
  {state:B}
  {state}
  {state:C}
  {state}
{workflow}


The state Updated transition can be added to the state in the transition editor using workflow builder.


The transition will occur when the content is edited and the changes saved.

Any other of the state transitions can be added with the Updated transition.


Macros{state}

Eventspageupdatednewsupdatedpagemovedattachmentschangedattachmentaddedattachmentupdatedattachmentremoved,attachmentversionremoved

See also: Publishing



Tasks completed transition

States can automatically transition should all workflow tasks be completed.

The completed parameter specifies the state to transition to when all tasks are completed. Tasks are listed in the Tasks popup.

{workflow:name=Task completion}
  {state:A}
  {state}
  {state:B|completed=C}
    {task:name=Complete this task|note=Task completion will cause transition to state C.}
  {state}
  {state:C}
  {state}
{workflow}

The task popup will need to be accessed to complete one or more workflow assigned tasks. 


On completion of the task(s) the workflow will transition from state B to state C.

The state Tasks Completed transition can be added to the state in the transition editor using workflow builder.


Before the transition occurs all tasks must be completed - workflow added tasks and user added tasks.

This includes any uncompleted tasks added in other workflow states and still awaiting completion when the workflow transitions into this state.

Any other of the state transitions can be added with the Tasks Completed transition.


Macros{task}{complete-task}

Eventstaskcreatedtaskassignedtaskcompletedtaskexpired

See also: TasksTasks PopupMake tasks disable a review