Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Panel

On this page

Table of Contents
exclude(On this page).*
stylecircle
typeflat
separatorpipe

UI Text Box
sizemedium
typeinfo

The Assign to Project Role This post function assigns an issue to a user in a project role.

In the very likely case that there is more than one user with in the specified project role, you can set specify a user as default for a project role in a project.You can use this functionality with every post-function in the plugin that allows you to write on any field of type User or Multi-User default user using either JWT project properties or JWT user properties.


Image AddedConfiguration

UI Expand
titleProject role

Select the project role containing the users the new assignee should be retrieved from.

UI Text Box
typenote

In this documentation and the post function configuration you will notice the symbol ( * ) next to some parameters, it means that this field is mandatory and shall not be left empty. Fields without the symbol are optional.

Basic configuration*

Below you will find a detailed description of each parameter of the basic configuration of the function.

Project role*

Define the required parameters needed to execute this post function.

Info
iconfalse

Select the project role the user should retrieve from.

Choose between:

  • Administrators
  • Developers

Assignee*

Info
iconfalse

Select the option to define the user who will be assigned to the issue.

Choose between:

  • Default user for project role
  • Default user for project role, except if current assignee is already in project role
  • Last user in project who has had the issue assigned
  • Last user in project role who has had the issue assigned, or lacking that to default user for project role
  • Previous user in project role who has had the issue assigned
  • Previous user in project role who has had the issue assigned, or lacking that to default user for project role
  • Random user among those in project role, except if current assignee is already in project role
  • Random user among those in project role different from current assignee
  • Least busy user om project role
  • Least busy user in project role, except if current assignee is already in project role
  • Next user in selected and project role according to round-robin algorithm
  • Next user in selected and project role according to round-robin algorithm, except if current assignee is already in project role

If you select a project role that is not available in the current project, the issue will not be reassigned.



UI Expand
titleAssignee

The assignee must be a member of the selected project role. Additionally you can define which exact role member the issue will be assigned to. You have the following options:

OptionDescription

Least busy user (fewest unresolved issues assigned)

This is the default. The issue will be assigned to the user with the lowest number of assigned issues. 

UI Text Box
typeinfo

If multiple users have the same number of issues assigned (e.g. none) the issue will be assigned to any of those users randomly.


Least busy user (skip if current assignee is already a project role member)

The issue will be assigned to the user with the lowest number of assigned issues unless the current assignee already is a member of the specified project role. In that case the issue will not be re-assigned.

Random user (skip if current assignee is already a project role member)

The issue will be randomly assigned to any member of the specified project role.

Random user (other than current assignee)

The issue will be randomly assigned to any member of the specified project role unless the current assignee already is a member of the specified project role. In that case the issue will not be re-assigned.

Previous assignee

The issue will be re-assigned to the member of the specified project role who has last been assigned the issue.  

UI Text Box
typeinfo

If the issue has never been assigned to a role member, the issue will not be re-assigned.


Previous assignee (or default user, if not present)

Variant where as a fallback the issue will be assigned to the default user

UI Text Box
typeinfo

Default users can be specified using JWT project properties or JWT user properties.

If the issue has never been assigned to a role member and no default role member has been specified the issue will not be re-assigned.


Previous assignee (skip if current assignee is already a project role member)Variant where the issue will not be re-assigned if the current assignee already is a member of the specified project role. In that case the issue will not be re-assigned.

Previous assignee (or default user, if not present / skip if current assignee is already a project role member)

Variant with the default user fallback, unless the current assignee already is a member of the specified project role. In that case the issue will not be re-assigned. 

Next user (in selected group) using round-robin

The issue will be randomly assigned to any member of the specified group using the round-robin algorithm.

UI Text Box
typetip

What is a round-robin queue?

The selected group in combination with the selected project role, define a round-robin queue. Each time the post function is executed in any workflow with the same configuration (i.e., same group and project role), the issue will be assigned to the next user in the round-robin queue.
The round-robin queue consists of all the users who are members of the selected group and project role at the same time.


Next user( in selected group) using round-robin (skip if current assignee is already a project role member)

The issue will be randomly assigned to any member of the specified group using the round-robin algorithm unless the current assignee already is a member of the specified project role. In that case the issue will not be re-assigned..

Default user

The issue will be assigned to the default user

UI Text Box
typeinfo

Default users can be specified using JWT project properties or JWT user properties.



UI Text Box
typenote

The user must be added to the project role in the Users and roles settings in the project configuration if you use any of these tools.

In addition, if you use both of them, the default users set with JWT project properties will take preference over those set with JWT user properties.



Default user (skip if current assignee is already a project role member)

Variant where the issue will not be re-assigned if the current assignee already is a member of the specified project role. In that case the issue will not be re-assigned.


UI Text Box
typeinfo

When selecting one of the "Least busy user" options, you have to additionally enter a JQL parser expression in JQL mode.

You can use this expression to further limit the number of potential assignees.

You could e.g. restrict the search to the current project by entering:

Code Block
languagebash
linenumberstrue
project = %{issue.project.key}

or to a specific issue type:

Code Block
languagebash
linenumberstrue
type in ("Bug", "Feature", "Improvement")




The post function will only be executed if the condition is met (returns true).

UI Expand
iconfalse
titleConditional execution

Include Page
DECADIS:_snip_condExecution_Server
DECADIS:_snip_condExecution_Server

UI Expand
titleConditional execution

Enter a condition (Logical / boolean condition) using the JWT expression parser - full feature list syntax.

You can even logically link and gather conditions in expressions as you like in order to map more complex conditions.

Note


Choose which user* will be able to execute this post function. By default it is set to the Current user.
UI Expand
iconfalse
titleRun as

Include Page
DECADIS:_snip_runAs_Server_postFunction
DECADIS:_snip_runAs_Server_postFunction



Image AddedUse cases and examples

Page properties report
firstcolumnUse case
headingsJWT feature, Workflow function, Parser functions, Label
cqllabel = "use-case-workflow" and parent = currentContent()


Excerpt Include
DECADIS:Contact support
DECADIS:Contact support
nopaneltrue


Page properties
hiddentrue


Tech review

Status
colourGreen
titledone

Style guide

Status
colourGreen
titledone

Status
titletodo
Status
colourYellow
titleReady for review
Status
colourGreen
titledone
Status
colourRed
titleflagged


Page properties
hiddentrue


Short descriptionAssign the issue to a specific user in a project role.
Label