Trigger events
- Robert Alexander Marshall
Overview
A trigger can be set to listen for a named event in the workflow.
When the workflow "event" occurs the trigger checks 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 "event" in the trigger.
For example,
{"event": "on-change-state", "actions":[............]}
The trigger event is filtered to a specific occurrence using conditions.
For example, the event has a condition to only listen for a change of state to a named state
{"event": "on-change-state","conditions":[{"state":"Approved"}], "actions":[............]}
Once the event occurs and any conditions are met, and one or more set trigger actions occur.
Example "on-expire" event
To add this trigger to a workflow using the workflow builder visual editor, 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.
