Get started

Use case library

JWT expression editor

JWT expression parser functions

JWT remote actions

Cloud migration hub

Additional product info

Supported list types

Number list

This function returns the nth element of the given number list. N specifies the position of an element in a list.

Syntax
nthElement(numberList, position) #Output: Number
Examples
Parser expressionDescription
%{nthElement([5, 6, 7, 8], 3)}

This example returns:

7

Additional information

Parameters used in this function

ParameterInput (data type)Description
numberList

NUMBER LIST

Any given number list.
position

NUMBER

A number satisfying the following condition: 1 <= position <= count(list)
Output

This function returns a NUMBER

If the position is out of bounds (position > count(list)), the function returns NULL. In case the position is less than 1, an error is returned.

If the number list is empty, the function returns NULL


Text list

This function returns the nth element of the given text list. N specifies the position of an element in a list.

Syntax
nthElement(textList, position) #Output: Text
Examples
Parser expressionDescription
%{nthElement(["blue", "red", "green"], 2)}

This example returns:

red

Additional information

Parameters used in this function

ParameterInput (data type)Description
textList

TEXT LIST

Any given text list.
position

NUMBER

A number satisfying the following condition: 1 <= position <= count(list)
Output

This function returns a TEXT

If the position is out of bounds (position > count(list)), the function returns NULL. In case the position is less than 1, an error is returned.

If the text list is empty, the function returns NULL


Issue list

This function returns an issue list with the nth element of the given issue list. N specifies the position of an element in a list.

Syntax
nthElement(issueList, position) #Output: Issue list
Examples
Parser expressionDescription
%{nthElement(subtasks(), 2)}

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

IT-9289

To achieve this, the following functions are used:


Additional information

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()).
position

NUMBER

A number satisfying the following condition: 1 <= position <= count(list)
Output

This function returns an ISSUE LIST

If the position is out of bounds (position > count(list)), the function returns an empty ISSUE LIST. In case the position is less than 1, an error is returned.

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


Use cases and examples

Use case
No content found.