Supported list types


Number list

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


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



Parser expressionDescription


%{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:



Parameters used in this function

ParameterInput (data type)Description
numberList

Any given number list.
startIndex

A valid index must be >= 1 and <= count(numberList) which is the maximum number of elements in the list
endIndex

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



Text list

Variant for text lists.


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



Parser expressionDescription


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


This example returns

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


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


This example returns a distinctext 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

ParameterInput (data type)Description
textList

Any given text list.
startIndex

A valid index must be >= 1 and <= count(textList) which is the maximum number of elements in the list
endIndex

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



Issue list

Variant for issue lists.


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



Parser expressionDescription


%{sublist(subtasks(), 1, 3)}


This example returns an issue list with the first 3 sub-tasks.

To achieve this the following functions are used:



Parameters used in this function

ParameterInput (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



Use cases and examples




Status
Tech review

Style guide




Short description

Returns a defined extract of a given list.

Output   
Available since

Label