This site has moved to the integrated Appfire documentation and information site for our apps.

From February 2024 this site is no longer updated.

Take a look here! If you have any questions please email support@appfire.com

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 6 Next »

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.

o

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 notation in full for these three triggers.

"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"}
	]}
]

(info) 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.


You can add the JSON to the workflow in workflow builder.


In the JSON markup the three trigger events are enclosed in a single pair of "[" and "]" brackets.

(green star) 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.

Related Pages

User Guide

Reviewing Content

Add a JSON trigger using workflow builder

Unable to render {children}. Page not found: Add a JSON trigger using workflow builder.

Notifications


  • No labels