first() | Decadis App Help Center

Number list

This function returns the first element of a number list. If the list is empty, the function returns null .

Bash

first(numberList) #Output: Number

Examples

Parser expression	Description
Bash `first([3, 2, 1, 0])`	This example returns: 3

Parser expression

Description

Bash

first([3, 2, 1, 0])

This example returns:

Additional information

Parameters used in this function

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

Output

This function returns a number

Text list

This function returns the first element of a text list. If the list is empty, the function returns null .

Bash

first(textList) #Output: Text

Examples

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

Parser expression

Description

Bash

first(["blue", "red", "green"])

This example returns:

blue

Additional information

Parameters used in this function

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

Output

This function returns a text

Issue list

The function returns an issue list with the first element of the given issue list. If the issue list is empty, the function returns an empty issue list .

Bash

first(issueList) #Output: Issue list

Examples

Parser expression	Description
Bash `first(subtasks())`	This example returns the first sub-task returned by subtasks(). If subtasks() returns `[SUB-1, SUB-2, SUB-3]`, the output will be: `[SUB-1]`

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

Parameter

Input (data type)

Description

issueList

issue list

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

linkedIssues()

subtasks()

Output

This function returns an issue list

📚 Use cases and examples

Use case	JWT feature	Workflow function	Field type	Automated action	Parser functions
Close tickets after version release				Transition issue action	dateToString() first() releaseDates()
Highest ranked custom field value among all linked issues	(input latin letters)		Text		first() sort() fieldValue() linkedIssues()
Creation date of the linked epic			Date-time		first() fieldValue() linkedIssues()
Inherit value from parent in Advanced Roadmaps hierarchy				Update field action	fieldValue() first() parent()
Copy excerpted value from new comments				Update field action	findPattern() first()
Set fix version based on its start and release date		Update or copy field values			toString() textOnStringList() unreleasedVersions() startDates() releaseDates() first()
Change the assignee to the next evaluator		Update or copy field values			first() toStringList()
Create a sub-task for every sub-task closed		Create issue			findReplaceFirst() first() findPattern() toString() sum() toNumber()
Clone epic, tasks and sub-tasks		Create issue			toString() toStringList() issueKeysToIssueList() replaceFirst() first() fieldValue() textOnStringList() findModify() subtasks() issuesUnderEpic()