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

Output

This function returns an issue list

📚 Use cases and examples

Use case	Workflow function	Field type	Automated action	Parser functions
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()
Set fix version based on its start and release date	Update or copy field values			toString() textOnStringList() unreleasedVersions() startDates() releaseDates() first()
Highest ranked custom field value among all linked issues		Text		first() sort() fieldValue() linkedIssues()
Close tickets after version release			Transition issue action	dateToString() first() releaseDates()
Change the assignee to the next evaluator	Update or copy field values			first() toStringList()
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()
Creation date of the linked epic		Date-time		first() fieldValue() linkedIssues()