unreleasedVersions()

This function returns a text list with all unreleased version names of the current issue's project.

The output will be ordered by release date in ascending order, and by sequence (i.e., as shown in UI) in ascending order.

Syntax

unreleasedVersions() #Output: Text list

Examples

Parser expression

Description

toStringList(%{issue.versions}) any in unreleasedVersions()

This example validates that at least one affected version is unreleased.

To achieve this, the following functions are used:

toStringList()

Output

This function returns a TEXT LIST

Variant where you additionally define multiple projects.

Returned versions may either be released or unreleased. Project keys or project names may be entered as a comma-separated list.

Syntax

unreleasedVersions(projects) #Output: Text list

Examples

Parser expression

Description

Syntax

toStringList(^%{issue.fixVersions}) in unreleasedVersions(^%{issue.project})

This example validates that all Fix Version/s of a seed issue are unreleased. This kind of comparison is usually used in a Logical expression.

To achieve this, the following functions are used:

toStringList()

Additional information

Parameters used in this function

Parameter	Input (data type)	Description
`projects`	TEXT	Text including valid project keys or names in a comma-separated list.

Output

This function returns a TEXT LIST

Name	Status	Release date	Position in UI (e.g. Release Hub)
JWT 6.0	UNRELEASED		#1
JWT 5.0	RELEASED	01 May 2020	#2
JWT 3.1	ARCHIVED	01 Mar 2020	#3
JWT 3.0	UNRELEASED	01 Apr 2020	#4
JWT 2.0	RELEASED	01 Feb 2020	#5
JWT 1.0	UNRELEASED		#6

The output of unreleasedVersions() will be: [JWT 1.0, JWT 6.0, JWT 3.0].

JWT 6.0 will come before JWT 3.0 since it does not have a release date set. If you want to sort by how the versions appear in the UI please use unreleasedVersionsBySequence().

Use cases and examples

Use case	JWT feature	Workflow function	Field type	Automated action	Parser functions
Set fix version based on its start and release date		Update or copy field values			toString() textOnStringList() unreleasedVersions() startDates() releaseDates() first()

Content

Space Tools

Use cases and examples