assign trigger action
Overview
When the workflow trigger event occurs, the trigger checks that any required conditions are met, and if met, the "assign"
action assigns one or more users and/or groups of users as reviewers to a named approval.
One or more trigger actions can be set for a named event in the workflow.
"assign"
The trigger action "assign"
assigns a user to a named approval.
action (assign)
approval (string) Name of the Approval to assign. If not specified, the default approval† is used
comment (string) Comment for the assignation operation
assigner (string) ❗️ Atlassian
userID
from the assigneruser (string) ❗️ Atlassian
userID
for the assigneegroup (string) ❗️ Atlassian
groupID
orgroupName
for assignees
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
Assigner: If the assigner parameter is not added in the trigger, the trigger uses a default value for the assigner - the app add-on user is set as the assigner
Assignees: At least one value must be added for an assignee (using user or group). The assignee user parameter value must be specified with a user unless you instead specify a group using the group parameter
† 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.
If the state has multiple approvals, the default approval is the first approval listed in the JSON markup for the state.
"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 as reviewers instead of a single user by using the group parameter, for example:
"group":"qa_reviewers"
where
"qa_reviewers"
is a Confluence group name.
The trigger action "unassign"
removes a user or members of a Confluence group from a named approval.