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.

If the set conditions are met for the named event, one or more trigger "actions" occur.

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 , one or more set 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 box in the Edit Workflow panel in workflow builder.

o