Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview

One or more workflow triggers can be added to a workflow. Each trigger can be set to

  • listen for a single workflow event such as a change of state ("on-change-state event" event)
  • check that a set condition is met for the event such as the state is the final state in the workflow("final":true condition)
  • and if the condition is met for the event, set one or more actions such as sending a custom email ("send-email action" action)

Triggers are added to a workflow as JSON code. They can be added using workflow builder or the JSON editor.

...

  • the trigger listens for a change of state.
  • the set condition constrains the trigger to listen for the state change to the Rejected state
  • once this event occurs the trigger actions a change of state back to the Draft state

oImage Modified

(blue star) If the JSON trigger is added using workflow builder there is no need to include the "trigger": JSON element. This is added automatically by workflow builder.

There are a range of workflow events including an approval event, a reviewer assignment/unassignment event that a  that a trigger can be set to listen for. These include

  • approval event
  • a reviewer assignment/unassignment event

You can constrain the event by adding a condition that the event is for events by adding conditions for the event such as

  • a named state in the workflow

...

  • the final state

...

  • the initial transition to a named

...

  • state

...

Trigger actions include

  • changing the state ("change- state", "state":"Draft")
  • assign/unassign users or Confluence groups as reviewers to an approval ("assign","approval":"approvalname", "user":"userID"/"unassign"," approval":"approvalname","user":"userID")
  • approve or reject a content review ("approve", "approval":"approvalname")
  • set a state expiration period ("set-expiration", "duedate":"P1M")period 
  • create a custom notification such as an email ("send-email") or on-screen message ("set-message")
  • set or remove page level user permissions ("set-restrictions" and "remove-restrictions")†permissions†

† Only 'Confluence Cloud Standard, Premium and Enterprise Plans' enable customers to edit permissions, including global, space, and page permissions

...