Page History

Versions Compared

Key

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

UI Text Box

size	medium
type	info

This JQL function can be used to search for users by checking against user properties that contain text values.

Code Block

language	bash
title	Syntax
linenumbers	true

usersWithTextProperty(property, operator, value) #Output: User list

UI Expand

title	Examples

Parser expression

Description

Code Block

language	bash
linenumbers	true

assignee in usersWithTextProperty("country" , "=", "Germany")

This example returns all issues where the assignee's property country is equals to Germany.

Code Block

linenumbers	true

reporter in usersWithTextProperty("country", "~", "usa")

This example returns all issues where the reporter's property country is equals to usa ignoring the case. So even if the property was set to "USA" or "Usa", the function would count this as valid property value.

Code Block

linenumbers	true

reporter in usersWithTextProperty("department", "matches", "(IT|HR)")

This example returns all issues where the reporter's property department is either IT or HR.

UI Text Box

type	info

When using the matches operator, the provided value must be a valid regex.

UI Expand

title	Additional information

Parameters used in this function

Parameter

Input (data type)

Description

property

Status

subtle	true
title	text

The name of the user property.

operator

Status

subtle	true
title	text

The operator used to compare the actual value with the expected value. Allowed operators are:

Comparator	Description
=	Property must be equal to the specified value.
!=	Property must not be equal to the specified value.
~	Property must be equal to the specified value, ignoring the case.
!~	Property must not be equal to the specified value, ignoring the case.
matches	A regex can be provided that must be fulfilled by the property.
doesn't match	A regex can be provided that must not be fulfilled by the property.

value

Status

subtle	true
title	text

The value that will be used to check against the actual user property.

UI Text Box

type	note

In case the operator is "matches" or "doesn't match", this value must be a regex.

UI Expand

title	Output

This function returns a

Status


subtle	true
title	User list

UI Text Box

type	tip

If you want to search for issues where a user as a specific numeric or date property value, have a look the the usersWithNumericProperty() or usersWithDateTimeProperty() function.

If you want to search for issues, checking only if a property is being set ignoring it's value, have a look the the usersWithProperty() function.

Include Page

	DECADIS:_snip_limit_JQL_functions
	DECADIS:_snip_limit_JQL_functions

Page properties

hidden	true

Short description

Searches for users by checking on their text properties.

Output

Status


subtle	true
title	user list

Label

Page properties

hidden	true

Status

Tech review

Status

colour	Green
title	done

Style guide

Status

colour	YellowGreen
title	Ready for reviewdone

Status

title	todo

Status

colour	Yellow
title	Ready for review

Status

colour	Green
title	done

Status

colour	Red
title	flagged

Content

Space Tools

Versions Compared

Old Version 13

New Version 14

Key