first()

Supported list types

This function returns the first element of a number list.

Syntax

first(numberList) #Output: Number

Parser expression	Description
%{first([3, 2, 1, 0])}	This example returns: 3

Parameters used in this function

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

This function returns a NUMBER

If the number list is empty, the function returns NULL

This function returns the first element of a text list.

Syntax

first(textList) #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
textList	TEXT LIST	Any given text list.

This function returns a TEXT

If the text list is empty, the function returns NULL

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

Syntax

first(issueList) #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: 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()).

This function returns an ISSUE LIST

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

Use case
No content found.