versionMatches()

versionMatches()

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.

 

Syntax

versionMatches(regex)

Available since

v1.0.0-RELEASE

Supported fields

AffectedVersion, FixVersion, custom fields of type Version

Supported operators

IN , 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