sublist()

Supported list types

This function returns a sublist of a given number list by using a start index (first element) and end index (last element).

Syntax

sublist(numberList, startIndex, endIndex) #Output: Number list

Parser expression	Description
%{sublist([1, 2, 3, 4, 5], 2, 4)}	This example returns [2, 3, 4]
%{sublist(toNumberList(%{issue.versions.id}), 1, 2)}	This example returns a distinct number list of both affected and fix version/s id/s of the current issue, e.g. [10002, 10000] To achieve this, the following functions are used: toNumberList()

Parameters used in this function

Parameter	Input (data type)	Description
`numberList`	NUMBER LIST	Any given number list.
`startIndex`	NUMBER	A valid index must be >= 1 and <= count(numberList) which is the maximum number of elements in the list
`endIndex`	NUMBER	A valid index must be >= 1 (and >= startIndex) and <= count(numberList) which is the maximum number of elements in the list.

This function returns a NUMBER LIST

Variant for text lists.

Syntax

sublist(textList, startIndex, endIndex) #Output: Text list

Parser expression

Description

%{sublist(["red", "green", "blue", "purple", "white"], 2, 4)}

This example returns

["green", "blue", "purple"]

%{sublist(toStringList(%{issue.components}), 1, 3)}

This example returns a distinct text list of the three first components of the current issue, e.g.

["UI", "UX", "Cloud"]

To achieve this, the following functions are used:

Parameters used in this function

Parameter	Input (data type)	Description
`textList`	TEXT LIST	Any given text list.
`startIndex`	NUMBER	A valid index must be >= 1 and <= count(textList) which is the maximum number of elements in the list
`endIndex`	NUMBER	A valid index must be >= 1 (and >= startIndex) and <= count(textList) which is the maximum number of elements in the list.

This function returns a TEXT LIST

Variant for issue lists.

syntax

sublist(issueList, startIndex, endIndex)  #Output: Issue list

Parser expression	Description
%{sublist(subtasks(), 1, 3)}	This example returns an issue list with the first 3 sub-tasks. To achieve this the following functions are used: subtasks()

Parameters used in this function

Parameter	Input (data type)	Description
`issueList`	ISSUE LIST	Any given issue list. Usually this value is retrieved from a function (e.g. linkedIssues() or subtasks()).
`startIndex`	NUMBER	A valid index must be >= 1 and <= count(issueList) which is the maximum number of elements in the list.
`endIndex`	NUMBER	A valid index must be >= 1 (and >= startIndex) and <= count(issueList) which is the maximum number of elements in the list.

This function returns an ISSUE LIST

Use case
No content found.