assign trigger action

Owned by Robert Alexander Marshall
Last updated: Oct 22, 2024
2 min read

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 assigner

    • user (string) ❗️ Atlassian userID for the assignee

    • group (string) ❗️ Atlassian groupID or groupName 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.

image-20241009-180854.png

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.

 

Trigger actions

Related Pages