nthElement() | Decadis App Help Center

Number list

This function returns the nth element of the given number list. N specifies the position of an element in a list. If the position is out of bounds (position <= 0 or position > count(list)), the function returns null . If the number list is empty, the function returns null .

Bash

nthElement(numberList, position) #Output: Number

Examples

Parser expression	Description
Bash `nthElement([5, 6, 7, 8], 3)`	This example returns: 7

Parser expression

Description

Bash

nthElement([5, 6, 7, 8], 3)

This example returns:

Additional information

Parameters used in this function

Parameter	Input (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

Text list

This function returns the nth element of the given text list. If the position is out of bounds (position <= 0 or position > count(list)), the function returns null . If the text list is empty, the function returns null .

Bash

nthElement(textList, position) #Output: Text

Examples

Parser expression	Description
Bash `nthElement(["blue", "red", "green"], 2)`	This example returns: red

Parser expression

Description

Bash

nthElement(["blue", "red", "green"], 2)

This example returns:

red

Additional information

Parameters used in this function

Parameter	Input (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

Issue list

This function returns an issue list with the nth element of the given issue list. If the position is out of bounds (position <= 0 or position > count(list)), the function returns an empty issue list . If the issue list is empty, the function returns an empty issue list .

Bash

nthElement(issueList, position) #Output: Issue list

Examples

Parser expression	Description
Bash `nthElement(subtasks(), 2)`	Returns the second issue retrieved by the function subtasks(). If an issue has the following subtasks [SUB-1, SUB-2, SUB-3], the output would be [SUB-2].

Additional information

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() ).
`position`	number	A number satisfying the following condition: `1 <= position <= count(list)`

Parameter

Input (data type)

Description

issueList

issue list

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

linkedIssues()

subtasks()

position

number

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

Output

This function returns a issue list

📚 Use cases and examples

Use case	JWT feature	Workflow function	Field type	Automated action	Parser functions
Create several issues combining fields		Create issue			nthElement() toStringList() modulus() count() ceil()