unreleasedVersions() | Decadis App Help Center

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.

Bash

unreleasedVersions() #Output: Text list

Examples

Parser expression	Description
Bash `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()

Parser expression

Description

Bash

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.

Bash

unreleasedVersions(projects) #Output: Text list

Examples

Parser expression	Description
Bash `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()

Parser expression

Description

Bash

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	2020-05-01	#2
JWT 3.1	archived	2020-03-01	#3
JWT 3.0	unreleased	2020-04-01	#4
JWT 2.0	released	2020-02-01	#5
JWT 1.0	unreleased		#6

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

(warning) 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()