🚀 Effective since April 2020 and JWT version 2.9.0 Automation Toolbox for Jira is fully integrated into our top rated app Jira Workflow Toolbox (JWT)🚀

Overview

The expression parser offers multiple functions to retrieve version related field values.

Available functions

Function

Input

Returned value

unreleasedVersions()

Returns a 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(string projects)

STRING

Returns a STRING [] with unreleased version names of projects in argument projects. Returned versions may be archived. Arguments projects is a comma separated list of project keys or project names.

releasedVersions()

Returns a 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(string projects)

STRING

Returns a STRING [] with released version names of projects in argument projects. Returned versions may be archived. Arguments projects is a comma separated list of project keys or project names. 
Example: toStringList(^%{...fixVersions}) in releasedVersions(^%{...projectKey})validates that all fixed versions of a foreign issue are released.

releaseDates(string versions)

STRING

Returns a NUMBER [] with the release dates for versions in string versions for current issues project. Parameter versions is a comma separated list of version names. 
Example: releaseDates(%{...fixVersions}) returns the list of release dates for Fix Version/s. 

releaseDates(string versions, string projects)

STRING

Returns a NUMBER []with the release 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: releaseDates(%{...versions}, "CRM") returns the list of release dates for affected versions for project with key "CRM". .

startDates(string versions)

STRING

Returns a 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)

STRING

Returns a 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 STRING [] with released version names of current issue's project. Returned versions may be archived.

archivedVersions(string projects)

STRING

Returns a STRING [] with released version names of projects in argument projects. Returned versions may either released or unreleased. Arguments projects is a comma separated list of project keys or project names.

latestReleasedVersion()

Returns 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(string projects)

STRING

Returns STRING [] with the name of the latest released version among projects in argument projects.

Returned versions may either released or unreleased. Arguments projects is a comma separated list of project keys or project names.

latestReleasedUnarchivedVersion(string projects)

STRING

Returns 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 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(string projects)

STRING

Returns STRING [] with the name of the earliest unreleased version among projects in argument projects. Returned versions may either released or unreleased. Arguments projects is a comma separated list of project keys or project names.

earliestUnreleasedUnarchivedVersion()

Returns STRING with the name of the earliest unreleased version in current issue's project excluding archived ones.

earliestUnreleasedUnarchivedVersion(string projects)

STRING

Returns STRING [] 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 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 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.

On this page