When you add this post-function to a transition and trigger the transition, the add-on checks for the default member of the selected Project Role
. If such member is found, it assigns the issue to the fetched user. If not, the issue is assigned to a random member of the selected Project Role
. If there are multiple default members, a random member is picked among them.
The easiest is to have only one user in the selected Project Role
for each applicable project.
If the selected Project Role can contain more than one user, you should specify how the post-function will identify the default member to use.
Since Jira does not support the notion of a default member for project roles, the Assign to role member function identifies the default member of a project role for a project by going through all the members of the project role looking for a User Property with the following two characteristics:
- Property key: defaultAssignee
- Property value: contains a comma-separated list of entries in the form ProjectKey -> *RoleName. *For example:
TST -> Developers, JMWE -> Testers |
For backward compatibility, the following two forms are also supported:
- Property Key: {ProjectName}x{RoleName} (for example: CoolProjectxQAMembers)
- Property value: "default" (without the quotes)
Or: (since 1.5.3)
- Property Key: defaultAssignee{n} (where n is a number from 1 up, for example: defaultAssignee1)
- Property value: {ProjectName}x{RoleName} (for example: CoolProjectxQAMembers)
Action
To customize the assignment select any of the following options:
- Force assignment (default) - Forcibly assigns the issue to the default member of the selected
Project Rol
e. In this case, user selected in theAssignee
field on the Transition screen (if any) is ignored. - Only if "Automatic" - Assigns the issue to the default member of the selected
Project Role
only if the user selectsAutomatic
in theAssignee
field on the Transition screen. If not, the Assignee field will not be modified. - Use selected assignee only if member of required role - Assigns the issue to the user selected on the Transition screen, only if the user belongs to the selected
Project Role
. If not, the Assignee field is not modified. - Use selected assignee if changed on the transition screen - Assigns the issue to the default role member of the selected
Project Role
only if the assignee is not changed (or set to Automatic) on the Transition screen.
Conditional execution
To execute this post-function based on the result of a groovy expression see Conditional execution using Groovy expression.