Page History

Versions Compared

Old Version 1

changes.mady.by.user Jona Ittermann

Saved on Mar 18, 2021

compared with

New Version Current

changes.mady.by.user Jona Ittermann

Saved on Sept 30, 2021

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 returns users by checking against their user properties that contain text values.

Code Block

language	bash
title	Syntax
linenumbers	true

usersWithTextProperty(property, comparatoroperator, value) #Output: Text TODOlist

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 current assignee 's has a text property country is equals called country with a value equal to Germany.

Code Block

linenumbers	true

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

This example returns all issues where the reporter's property country is equals current reporter has a user text reporter called country with a value equal 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 current reporter

has a text property

department is either

called department with a value equal to IT or HR.

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

Code Block

linenumbers	true

reporter in usersWithTextProperty("importance", "matches", "^.*(required).*")

This example returns all issues where the assignee's property importance contains the word required.

UI Text Box

type	info

When using the matches

comparator

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

JWT

user property.

comparator

operator

Status

subtle	true
title	text

The

comparator

operator used to compare the actual value with the expected value. Allowed

comparators

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

comparator

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

UI Expand

title	Output

This function returns returns a

Status


subtle	true
title	text 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

TODOReturns users with specific text properties.

Output

Status


subtle	true
title	text list

Label

Page properties

hidden	true

Status

Tech review

Status

colour	Yellow
title	todoReady for review

Style guide

Status

colour	Green
title	tododone

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 1

New Version Current

Key