categoryMatches()

categoryMatches()

Description:

Perform searches based on project categories which their name match with the provided regular expression.

Note:
This function uses Java native String.matches() method internally to determine the categories affected by the given expression.
See Pattern Java Class for further information.



Syntax

categoryMatches(regex)

Available since

v1.0.0-RELEASE

Supported fields

Category

Supported operators

IN , NOT IN

Unsupported operators

= , != , ~ , !~ , > , >= , < , <=

IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED

Examples:

• Find issues in projects whose category starts with 'LATAM':

category IN categoryMatches("LATAM.*")

• Find issues in projects whose category contains 'Development':

category IN categoryMatches(".*Development.*")

• Find issues in projects whose category ends with 'EMEA':

category IN categoryMatches(".*EMEA")

Real World Use Cases:

· JRASERVER-43398 - Allow wildcard or '~' symbol to search for project/category name in JQL (by Ismael Olusula Jimoh)
· Is it possible to use a wild card to search for issues in a Category? (by Tina Donato at ATLASSIAN Community)



JQL Function Reference