Supported list types


Number list

This function returns the first element of a number list.


first(numberList) #Output: Number



Parser expressionDescription


%{first([3, 2, 1, 0])}


This example returns:

3



Parameters used in this function

ParameterInput (data type)Description
numberList

Any given number list.



This function returns a

If the number list is empty, the function returns 



Text list

This function returns the first element of a text list.


first(textList) #Output: Text



Parser expressionDescription


%{first(["blue", "red", "green"])}


This example returns:

blue


%{first(%{issue.components})}


This exmaple returns the first component of the current issue, e.g:

IT



Parameters used in this function

ParameterInput (data type)Description
textList

Any given text list.



This function returns a

If the text list is empty, the function returns 



Issue list

The function returns an issue list with the first element of the given issue list.


first(issueList) #Output: Issue list



Parser expressionDescription


%{first(subtasks())}


This example returns the first sub-task of the current issue, e.g.:

IT-9289

To achieve this, the following functions are used:



Parameters used in this function

ParameterInput (data type)Description
issueList

Any given issue list. Usually this value is retrieved from a function (e.g. linkedIssues() or subtasks()).



This function returns an

If the issue list is empty, the function returns an empty 



Use cases and examples



Short description

Returns the first element of a number, text, or issue list.

Output