userDisplayName()

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

Syntax

userDisplayName(userName) #Output: Text

Parser expression	Description
userDisplayName(%{system.currentUser})	This example returns the display name of the current user, e.g.: Bob Smith

Parameters used in this function

Parameter	Input (data type)	Description
`userName`	TEXT	Text containing a valid user name.

This function returns a TEXT

Variant for multiple users.

Syntax

userDisplayName(userList) #Output: Text list

Parser expression

Description

toString(userDisplayName(%{issue.watcher}))

This example returns the display names of all watchers.

To achieve this, the following functions are used:

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:

Parameters used in this function

Parameter	Input (data type)	Description
`userList`	TEXT LIST	Any valid text list.

This function returns a TEXT LIST

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

Use cases and examples

Use case	JWT feature	Workflow function	Field type	Automated action	Parser functions
Add comment with the request participants' display name		Add comment			toString() textOnStringList() toStringList() userDisplayName()
Prevent external users from creating issues		Logical validator			matches() toString() textOnStringList() toStringList() userDisplayName()