Page Comparison

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

The trigger action "assign" assigns a user to a named approval.

• action (assign) 

  • approval - the name of the approval to assign. If not specified, the default approval^† _{is used}

  • comment - comment for the assignation operation

  • assigner - Atlassian  userID for the assigner (if no value is added the app add-on user is the assigner for the action)

  • user ❗️ Atlassian userID for the assignee (accepts one value only)

  • group❗️ Atlassian groupID or groupName for assignees (accepts one value only)

  • comment - comment for the assignation operation

Only one user and one group can be assigned in a single "assign" action. You cannot add multiple values for the user or group parameters.

❗️ Mandatory parameters

user and group parameters for assignees

At least one value must be added for an assignee (using either user or group). The user parameter value must be specified unless a group is specified using the group parameter instead.

† Default approval

If no approval name is specified in the trigger action, the default approval is the approval in the state named in the trigger event condition.

Ifthe state hasmultiple approvals, the default approval is the first approval listed in the state's JSON markup.

Example trigger code

"triggers":
[
	{"event": "on-change-state",
	"conditions":
	[
		{"state":"Review"}
	],
	"actions":
	[
		{"action": "assign",
			"approval": "Triagereview",
			"user": "5d52a37ef0f22a0da2d6f070",
			"group": "qa_reviewers"}
	]}
]

Notes

When assigning a reviewer, the user parameter only accepts one userID value.

The Atlassian User Identification Number (userId) is visible in the URL when viewing the User Profile.

To assign multiple users as reviewers, you must use a Confluence group for the reviewers instead of a single user by using the group parameter, for example:

• "group":"qa_reviewers"

• where "qa_reviewers" is a Confluence group name.

Tip
The group parameter value can be either the groupID or the Confluence groupName.

The trigger action "unassign" removes a user or members of a Confluence group from a named approval.