Overview

One or more conditions can be set for a trigger for a named event in the workflow.When the named workflow event occurs the trigger checks that any required condition is met, and if met sets one or more actions.

Conditions

A condition must be met for the trigger to perform the specified action(s). Available conditions are

• "state": "(string value)"

• "final":(boolean true/false)

• "initial": (boolean true/false)

If "final" condition is added together with another condition to an event, the condition is evaluated as an OR function.

The "initial" condition can be constrained to a named state in the workflow using the "state" condition.

JSON trigger conditions

• Page:
  final condition
• Page:
  initial condition
• Page:
  state condition

Example “on-change-state" event

"triggers":
[
    {"event": "on-change-state",
    "conditions":
    [
        {"initial":true},{"final":true}
    ],
    "actions":
    [
        {"action": "clean-messages"}
    ]}
]

The trigger action clears any existing messages on the content

• "actions":[{ "action":"clean-messages"}],

The action occurs on the change of state event if the current state is either the initial state OR the final state in your workflow.

• "conditions":[{"initial":true},{"final":true}],

If a JSON condition is present this can include one or more conditions.

Example “on-approve" event

"triggers":
[
	{"event": "on-approve",
	"conditions":
	[
		{"state":"Review"}
	],
	"actions":
	[
		{"action":"change-state",
			"state":"Published"}
	]}
]

The trigger action causes a change of state

• "actions":[{ "action":"change-state"}],

The trigger action occurs on the approve event but ONLY if the current state is the Review state

• "conditions":[{"state":"Review"}],