Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
UI Text Box
sizemedium
typeinfo

This function returns the display name for a given user name.

Code Block
languagebash
titleSyntax
linenumberstrue
userDisplayName(userName) #Output: Text
UI Expand
titleExamples
Parser expressionDescription
Code Block
languagebash
linenumberstrue
userDisplayName(%{system.currentUser})
This example returns the display name of the current user, e.g.:
Bob Smith
UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
userName

Status
subtletrue
titletext

Text containing a valid user name.
UI Expand
titleOutput

This function returns a

Status
subtletrue
titletext


UI Text Box
sizemedium
typeinfo

Variant for multiple users.

Code Block
languagebash
titleSyntax
linenumberstrue
userDisplayName(userList) #Output: Text list
UI Expand
titleExamples
Parser expressionDescription
Code Block
languagebash
linenumberstrue
toString(userDisplayName(%{issue.watcher}))
This example returns the display names of all watchers.

To achieve this, the following functions are used:

Code Block
languagebash
linenumberstrue
toString(userDisplayName(["b.smith", "d.jones"]))

This example returns the display names of all two users, e.g.:

Bob Smith, Dave Jones

To achieve this, the following functions are used:

UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
userList

Status
subtletrue
titletext list

Any valid text list.
UI Expand
titleOutput

This function returns a

Status
subtletrue
titletext list

UI Text Box
typetip

If you want to return the user name instead of a display name, check out: fullNameToUser()


Use cases and examples

Page properties report
firstcolumnUse case
headingsJWT feature, Workflow function, Field type, Automated action, Parser functions
cqllabel = "parser_func_userdisplayname" and space = currentSpace()

Page properties
hiddentrue
id1
Parser function cloud
Map(question)
Notes

Workaround

Code Block
languagebash
issue.reporter.displayName
//and
issue.watchers.map(u=>u.displayName)

Only possible to access it using an user field, but it is not possible to access to an user with an username, only with the account ID.

Page properties
hiddentrue

Status
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 description

Returns the full name of a given user.

Output

Status
subtletrue
titletext
 
Status
subtletrue
titletext list

Available since

Status
subtletrue
colourBlue
title3.0.1

Label