View Source

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

Supported list types

This function returns the first element of a number list.

first(list) #Output: Number

Parser expression

Description

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

This example returns:

3

Parameters used in this function

Parameter	Input (data type)	Description
`list`		Any given number list.

This function returns a

If the number list is empty, the function returns

This function returns the first element of a text list.

first(list) #Output: Text

Parser expression

Description

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

Parameter	Input (data type)	Description
list		Any given text list.

This function returns a

If the text list is empty, the function returns

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

first(list) #Output: Issue list

Parser expression

Description

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

Parameter	Input (data type)	Description
`list`		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