/
versionMatches()

versionMatches()

Owned by Jack Nolddor (Unlicensed)
Last updated: Jul 18, 2019 by Jack Nolddor

Description:

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

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


SyntaxversionMatches(regex)
Available sincev1.0.0-RELEASE
Supported fieldsAffectedVersion, FixVersion, custom fields of type Version
Supported operatorsIN , NOT IN
Unsupported operators

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

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

Examples:

• Find issues affected by versions that their name starts with 'v1' i.e. 'v1.1.0', 'v1.2', 'v1.1.6', etc:

affectedVersion IN versionMatches("v1.*")

• Find issues fixed in versions that their name contains 'alpha':

fixVersion IN versionMatches(".*alpha.*")

• Find issues affected by versions that their name ends with 'SNAPSHOT' i.e. 'v1.1-SNAPSHOT', 'v1.5-NIGHTLY_SNAPSHOT', etc:

affectedVersion IN versionMatches(".*SNAPSHOT")

Real World Use Cases:

· JRASERVER-24152 - JQL - Add wildcard functionality to versions (by John Sloat)
· JRASERVER-30099 - JQL: Allow fuzzy matcher for versions: fixVersions, affectedVersions (by Mark Michaelis)
· JRASERVER-26403 - To search for versions: Affects Version of Fix Version with a commom characters at the start of the version (by Honeywell JIRA Admin)



JQL Function Reference

Related content