Page History

Versions Compared

Key

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

UI Text Box

size	medium
type	info

This function returns the user names of users matching a given email address.

Within Jira it is possible that multiple users have the same email address. In this case a text list with all related user names will be returned. If only one user is excepted though, the function first() can be used.

This function is case insensitive.

Code Block

language	bash
title	Syntax
linenumbers	true

usersWithEmail(emailAddress) #Output: Text list

UI Expand

title	Examples

Parser expression

Description

Code Block

language	bash
linenumbers	true

usersWithEmail("b.smith@test.com")

This example returns a list with all usernames for the email address b.smith@test.com, e.g.:

[b.smith]

Code Block

language	bash
linenumbers	true

usersWithEmail("B.SMITH@test.com")

This example returns the same usernames like in the above example, since the function is case insensitive.

Code Block

language	bash
linenumbers	true

usersWithEmail("j.doe@company.com")

This example returns a list with all usernames for the email address j.doe@company.com, e.g.:

[j.doe, john-doe, john.doe]

Code Block

language	bash
linenumbers	true

first(usersWithEmail("j.doe@company.com"))

This example returns only the first username with the given email address, e.g.:

j.doe

Code Block

language	bash
linenumbers	true

toString(textOnStringList(toStringList(%{issue.cf10400}, ", "), toString(usersWithEmail(%{seed.text}))))

This example returns the user names for all email addresses, found in a custom text field (with ID 10400) that stores email addresses, e.g.:

b.smith, a.grant, d.conner

UI Expand

title	more info...

Steps in this example:

Take all individual values found in the custom field (which are separated by ", ") and convert them into a text list with toStringList()
Perform an operation on each (seed) element of that list with textOnStringList()
The operation itself is to convert the email address for each element in the list (%{seed.text}) into a valid user names
Convert the output into a simple text with toString()

UI Expand

title	Additional information

Parameters used in this function

Parameter

Input (data type)

Description

emailAddress

Status


subtle	true
title	text list

Text containing a valid email address.

UI Expand

title	Output

This function returns a

Status


subtle	true
title	text list

UI Text Box

type	tip

You might want to wrap the method with the toString() function so that the result can be parsed to a text field.

Image AddedUse cases and examples

Page properties report

firstcolumn	Use case
headings	JWT feature, Workflow function, Field type, Automated action, Parser functions
cql	label = "parser_func_userswithemail" and space = currentSpace()

Page properties

hidden	true

Status

Tech review

Status

colour	Green
title	done

Style guide

Status

colour	Green
title	done

Status

title	todo

Status

colour	Yellow
title	Ready for review

Status

colour	Green
title	done

Status

colour	Red
title	flagged

Page properties

hidden	true

Short description

Returns the user names of users matching a given email address.

Output

Status


subtle	true
title	text list

Available since

Status

subtle	true
colour	Blue
title	2.1.32

Label

Content

Space Tools

Versions Compared

Old Version 13

New Version 14

Key

Image AddedUse cases and examples