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

Version 1 Next »

 Overview

One or more trigger actions can be set for a named event in the workflow.

When the workflow trigger event occurs the trigger will check that any required conditions are met, and if met the send-email action sends an email to one or more specified recipients.

"send-email"

The trigger action "send-email" sends a custom email to one or more specified recipients. 

  • action (send-email)
  • recipients (array) ❗️Recipients to send the email to (at least one recipient value must be added). A comma separated list of one or more recipients or Confluence groups is added using:
    • Atlassian userID
    • Atlassian groupID or groupName
    • Email address
    • One or more of the following value references can also be added as a value for the send-email action recipients

      • @watcher  (info) Note that @watcher refers to the watchers set at a document level, not including the watchers of the space.
      • @lastUpdatedBy

      • @creator

      • workflow parameter references (user and group types) are also supported as recipients
  • notification (object) ❗️ Notification holder. Can include the following as a comma-separated list within curly brackets:
    • the email subject
    • title
    • body
  • emailContext (object) Email context object: ${content.title} | ${content.link} | ${content.space} 
    • These can be used in the subject, title and body parameter values. You must include an email subject value and body value.

❗️Mandatory parameters - the following parameters are required:

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

(info)  if adding the JSON trigger using workflow builder there is no need to include the opening "triggers:" JSON markup notation, since It will be added by workflow builder.

On screen notification messages can be created using the  "set-message" trigger action.

  • No labels