A workflow post-function that assigns the current issue to the default member of a selected project role.
For information on where the post-function needs to be placed on a transition, see Placing post-functions on a transition.
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 and the issue is assigned to the picked user.
Works best if you have only one user in the selected Project Role
.
If you want a specific user to be picked, you must either use the User Property (explained below) or use a more specific Role (one that contains only a single user).
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 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)
Customize this post-function using the additional options provided as a part of the post-function. The options are:
Force assignment (default)
Forcibly assigns the issue to the default member of the selected Project Rol
e. In this case, any user selected in the Assignee
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 when the user selects Automatic
in the Assignee
field on the Transition screen. If not the issue stays with the current assignee.
Use selected assignee only if member of required role
Assigns the issue to the member selected on the Transition screen, only if the member belongs to the selected Project Role
. If not, it assigns the issue to the default member of the selected Project role
.
Use selected assignee if changed on the transition screen
Assigns the issue to the default role member of the selected Project Role
only when the assignee is not changed on the Transition screen or Automatic
is selected in the Assignee
field. If not the issue is assigned to the selected assignee 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.
Refer Use cases for post-functions page for use cases for this post-function.