Get started

Use case library

JWT expression editor

JWT expression parser functions

JWT workflow functions

JWT remote actions

JWT automation rules

JWT calculated fields

JWT calendars

JWT properties

JWT JQL functions

Cloud migration hub

Additional product info

Versions Compared

Old Version 16

changes.mady.by.user Thorsten Letschert

Saved on

compared with

New Version Current

changes.mady.by.user Jona Ittermann

Saved on

Key

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

This JQL function returns users by checking against their user properties that contain text values.

Code Block
languagebash
titleSyntax
linenumberstrue
usersWithTextProperty(property, operator, value) #Output: UserText list
UI Expand
titleExamples
Parser expressionDescription
Code Block
languagebash
linenumberstrue
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
linenumberstrue
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
linenumberstrue
reporter in usersWithTextProperty("department", "matches", "(IT|HR)")

This example returns all issues where the current reporter's has a text property department is either called department with a value equal to IT or HR.

UI Text Box
typeinfo

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

UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
property

Status
subtletrue
titletext

The name of the user property.

operator

Status
subtletrue
titletext

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

ComparatorDescription
=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.
matchesA regex can be provided that must be fulfilled by the property.
doesn't matchA regex can be provided that must not be fulfilled by the property.
value

Status
subtletrue
titletext

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

UI Text Box
typenote

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

UI Expand
titleOutput

This function returns a

Status
subtletrue
titleUser text list

UI Text Box
typetip

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
hiddentrue
Short descriptionReturns users with specific text properties.
Output

Status
subtletrue
titleuser text list

Label
Page properties
hiddentrue

Status
Tech review

Status
colourGreenYellow
titledoneReady for review

Style guide

Status
colourGreen
titledone

Status
titletodo
Status
colourYellow
titleReady for review
Status
colourGreen
titledone
Status
colourRed
titleflagged