Comment:
Published by Scroll Versions from this space and version 1.1.0
Excerpt
Overview
The expression parser offers multiple functions to retrieve version related field values.
Available functions
Function
Input
Returned value
unreleasedVersions()
Returns a
Status
subtle
true
colour
Yellow
title
String []
with unreleased version names of current issue's project. Returned versions may be archived. Example:toStringList(%{...versions}) any in unreleasedVersions()validates that at least one affected version is unreleased.
unreleasedVersions(stringprojects)
Status
colour
Yellow
title
String
Returns a
Status
subtle
true
colour
Yellow
title
String []
with unreleased version names of projects in argumentprojects. Returned versions may be archived. Argumentsprojectsis a comma separated list ofproject keysorproject names.
releasedVersions()
Returns a
Status
subtle
true
colour
Yellow
title
String []
with released version names of current issue's project. Returned versions may be archived. Example:toStringList(%{...fixVersions}) in releasedVersions()validates that all fixed versions are released.
releasedVersions(stringprojects)
Status
colour
Yellow
title
String
Returns a
Status
subtle
true
colour
Yellow
title
String []
with released version names of projects in argumentprojects. Returned versions may be archived. Argumentsprojectsis a comma separated list ofproject keysorproject names. Example:toStringList(^%{...fixVersions}) in releasedVersions(^%{...projectKey})validates that all fixed versions of a foreign issue are released.
releaseDates(stringversions)
Status
colour
Yellow
title
String
Returns a
Status
subtle
true
colour
Blue
title
number []
with the release dates for versions in stringversionsfor current issues project. Parameterversionsis a comma separated list of version names. Example:releaseDates(%{...fixVersions})returns the list of release dates forFix Version/s.
releaseDates(stringversions, stringprojects)
Status
colour
Yellow
title
String
Returns a
Status
subtle
true
colour
Blue
title
number []
with the release dates for versions in stringversionsfor projects in parameterprojects. Parameterversionsis a comma separated list of version names. Parameterprojectsis a comma separated list of project keys or project names. Example:releaseDates(%{...versions}, "CRM")returns the list of release dates for affected versions for project with key"CRM". .
startDates(string versions)
Status
colour
Yellow
title
String
Returns a
Status
subtle
true
colour
Blue
title
number []
with the start dates for versions in string versions for current issues project. Parameter versions is a comma separated list of version names.
Example: startDates(%{...fixVersions}) returns the list of start dates for fixed versions.
startDates(string versions, string projects)
Status
colour
Yellow
title
String
Returns a
Status
subtle
true
colour
Blue
title
number []
with the start dates for versions in string versions for projects in parameter projects. Parameter versions is a comma separated list of version names. Parameter projects is a comma separated list of project keys or project names.
Example: startDates(%{...versions}, "CRM") returns the list of start dates for affected versions for project with key "CRM".
archivedVersions()
Returns a
Status
subtle
true
colour
Yellow
title
String []
with released version names of current issue's project. Returned versions may be archived.
archivedVersions(stringprojects)
Status
colour
Yellow
title
String
Returns a
Status
subtle
true
colour
Yellow
title
String []
with released version names of projects in argumentprojects. Returned versions may either released or unreleased. Argumentsprojectsis a comma separated list ofproject keysorproject names.
latestReleasedVersion()
Returns
Status
colour
Yellow
title
String
with the name of the latest released version in current issue's project. Example:latestReleasedVersion() in archivedVersions()validates that the latest released version in current issue's project is archived.
latestReleasedVersion(stringprojects)
Status
colour
Yellow
title
String
Returns
Status
subtle
true
colour
Yellow
title
String []
with the name of the latest released version among projects in argumentprojects.
Returned versions may either released or unreleased. Argumentsprojectsis a comma separated list ofproject keysorproject names.
latestReleasedUnarchivedVersion(stringprojects)
Status
colour
Yellow
title
String
Returns
Status
subtle
true
colour
Yellow
title
String []
with the name of the latest released version excluding archived ones for projects in argument projects. Returned versions may either released or unreleased. Arguments projects is a comma separated list of project keys or project names.
earliestUnreleasedVersion()
Returns
Status
colour
Yellow
title
String
with the name of the earliest unreleased version in current issue's project. Example:earliestUnreleasedVersion() not in archivedVersions()validates that earliest unreleased version in current issue's project is not archived.
earliestUnreleasedVersion(stringprojects)
Status
colour
Yellow
title
String
Returns
Status
subtle
true
colour
Yellow
title
String []
with the name of the earliest unreleased version among projects in argumentprojects. Returned versions may either released or unreleased. Argumentsprojectsis a comma separated list ofproject keysorproject names.
earliestUnreleasedUnarchivedVersion()
Returns
Status
colour
Yellow
title
String
with the name of the earliest unreleased version in current issue's project excluding archived ones.
with the name of the earliest unreleased version excluding archived ones for projects in argument projects. Returned versions may either released or unreleased. Arguments projects is a comma separated list of project keys or project names.
unreleasedVersionsBySequence()
Available since version 1.1.0
Returns a
Status
subtle
true
colour
Yellow
title
string []
with the unreleased versions in the current project with the default order. Only non-archived versions are returned. The first version in the list is the lowermost version in the version table.
releasedVersionsBySequence()
Available since version 1.1.0
Returns a
Status
subtle
true
colour
Yellow
title
string []
with the released versions in the current project with the default order. Only non-archived versions are returned. The first version in the list is the lowermost version in the version table.
