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
o
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
...