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