Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
maxLevel4
minLevel2
absoluteUrltrue
excludeRelated Pages
typeflat
separatorpipe

Overview

Comala Document Management triggers are created using JSON markup and can be added to a workflow using the workflow builder.

Experienced JSON users can also use the workflow JSON editor.

Related pages

Child pages (Children Display)
pageJSON Triggers

JSON Trigger Examples

JSON triggers are used in the Content Expiry workflow and the Quality Management System workflow.

Table of Contents
maxLevel4
minLevel4
exclude.COMALATECH.

You can add triggers to create your own custom Comala Document

Control

Management workflow.

Content Expiry Workflow trigger

This workflow has the following JSON trigger

Code Block
[
	{"event": "on-expire",
	"actions":
	[
		{"action": "send-email",
			"recipients": ["@creator", "@watchers", "@lastUpdatedBy"],
			"notification":
				{"subject": "${content.title} has expired",
				"title": "${content.title} has expired",
				"body": "Hello, ${content.link} in the ${content.space} space has expired and needs to be reviewed"}},
		{"action": "set-message",
			"type": "info",
			"title": "Expired",
			"body": "The page has expired",
			"tags": "state",
			"mode": "autoClose"}
	]}
]


The JSON trigger listens for the state expiry event and when this occurs

  • sends emails to the content watchers

Image Removed
  • Image Added

  • displays an on-screen message when users view the page

Image Removed
Image Added

Quality Management System Workflow trigger

The QMS Workflow has the following JSON trigger:

Code Block
[
	{"event": "on-change-state",
	"conditions":
	[
		{"state": "In Approval"}
	],
	"actions":
	[
		{"action": "send-email",
			"recipients": ["@document_user_reviewers@", "@document_group_reviewers@"],
			"notification":
				{"subject": "${content.title} is In Approval State",
				"title": "${content.title} is In Approval State",
				"body": "Hello, ${content.link} in the ${content.space} space is in approval state and needs to be reviewed"}}
	]}
]

The JSON trigger listens for the state change event with a condition limiting this to the transition to the In Approval state. When this event occurs

:

  • email notifications are sent to the reviewers assigned to the content review in the In Approval state

Image Removed
  • Image Added


The workflow reviewers for the In Approval state content review are

  • user(s) who are added as a Confluence userID value(s) for the workflow parameters document users reviewers

 and/or
  • users who are a member of the Confluence group(s) added as a Confluence group (groupName or groupID) value(s) for the workflow parameter document group reviewers

.