Overview

A trigger can be set to listen for a named event in the workflow. When the workflow event occurs the trigger will check that any required conditions are met, and if met set one or more actions.

Event

A trigger can be set to listen for the following events:

A workflow JSON trigger can include more than one event.

However, only one of each type of event can be included in a single trigger.

The trigger event can be filtered to a specific occurrence using conditions.

Once the event occurs and any conditions are met the trigger actions occur.

Example

"on-expire" event

"triggers":
[
	{"event": "on-expire",
  	"actions":
	[
		{"action": "change-state",
			"state": "Review"},
		{"action": "set-message",
        	"type": "warning",
            "title": "Stale content",
            "body": "Content has passed its set life and may be out of date",
            "tags": "state",
            "mode": "autoClose"}
    ]}
]

If adding the JSON trigger using workflow builder visual editor there is no need to include the opening "triggers": JSON markup notation, since it will be added by workflow builder.

The on-expire event is only listening a workflow expiry event.

Each event can include

• conditions

• one or more actions

The JSON trigger event must include at least one JSON trigger action. There are two actions in the example

• the "change-state" action to transition the workflow to the Review state and

• "set-message" notification action

There are no conditions and the trigger will listen for an expiration event for any state.

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

If you want to add this trigger to a workflow using workflow builder, copy and paste the JSON code format (without the opening "triggers": JSON markup notation) to the Triggers dialog in the Edit Workflow panel in workflow builder.

o