Overview
You can use one or more JSON triggers in a Comalatech workflow.
Using JSON triggers to create a custom email notification for different state changes
In our custom workflow, we have added three triggers.
Related pages
- JSON Trigger events
- JSON Trigger conditions
- JSON Trigger actions
- Users or groups within a trigger
- JSON Trigger examples
Add a JSON trigger using workflow builder
Each trigger looks for a different change of state event.
- on a change of state to QM - In Review an email is sent to the users who have been added as a value to the workflow parameter
@QT@, also an informative message dialog is shown - on a change of state to QM - In Approval an email is sent to the users who have been added as a value for the workflow parameter
@QT@and the users who are members of the Confluence user groups added as a value for the workflow parameter @QM@, also an informative message dialog is shown - on a change of state to QM - Published an email is sent to the user who created the page using the value reference @Creator@, also an informative message dialog is shown
Here's the JSON for the three triggers.
[
{"event": "on-change-state",
"conditions":
[
{"state": "QM - In Review"}
],
"actions":
[
{"action": "send-email",
"recipients":
[
"@QT@"
],
"notification": {"subject": "${content.title} is QM - In Review State",
"title": "${content.title} is QM - IN REVIEW State",
"body": "Hello, ${content.link} in the ${content.space} space is in QM - In Review state and needs to be reviewed"}},
{"action": "set-message",
"type": "info",
"title": "This is the title of the dialog shown on your page",
"body": "This is the body of the dialog shown on your page"}
]},
{"event": "on-change-state",
"conditions":
[
{"state": "QM - In Approval"}
],
"actions":
[
{"action": "send-email",
"recipients":
[
"@QT@",
"@QM@"
],
"notification": {"subject": "${content.title} is QM - In Approval State",
"title": "${content.title} is QM - In Approval State",
"body": "Hello, ${content.link} in the ${content.space} space QM - In Approval"}},
{"action": "set-message",
"type": "info",
"title": "This is the title of the dialog shown on your page",
"body": "This is the body of the dialog shown on your page"}
]},
{"event": "on-change-state",
"conditions":
[
{"state": "QM - Published"}
],
"actions":
[
{"action": "send-email",
"recipients":
[
"@Creator@"
],
"notification": {"subject": "${content.title} is QM - Published State",
"title": "${content.title} is QM - Published State",
"body":"Hello, ${content.link} in the ${content.space} space QM - Published"}},
{"action": "set-message",
"type": "info",
"title": "This is the title of the dialog shown on your page",
"body": "This is the body of the dialog shown on your page"}
]}
]
Only one overall "triggers:" will be required in the JSON code if added to a workflow using the JSON editor. In workflow builder you do not have to add the "triggers:" JSON element.
In the JSON markup the three trigger events are enclosed in a single pair of "[" and "]" brackets.
You can add the JSON to the workflow in workflow builder.
The following JSON code format for this example can easily be copied and pasted into workflow builder.
There is no need to add the opening "trigger" JSON when adding the JSON code to workflow builder. Workflow builder will automatically add this when you save the changes to the workflow.