Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Description:

Excerpt

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 also, 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 ther name starts with 'v1' i.e. 'v1.1.0', 'v1.2', 'v1.1.6', etc:

Code Block
languagesql
themeConfluence
affectedVersion IN versionMatches("v1.*")


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

Code Block
languagesql
themeConfluence
fixVersion IN versionMatches(".*alpha.*")


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

Code Block
languagesql
themeConfluence
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

Page Tree
rootJQL Function Reference
startDepth2