Breadcrumbs

append()

Number list

This function combines two number lists.

The order of elements is respected and the result may contain duplicates.

If you want to avoid duplicates, use the function union().

Bash
append(numberList1, numberList2) #Output: Number list

Examples

Parser expression

Description
Bash
append([1, 2, 3], [3, 4, 5])

This example returns

[1, 2, 3, 3, 4, 5]
Bash
append(fieldValue({issue.timeSpent}, linkedIssues("is blocked by")), fieldValue({issue.timeSpent}, subtasks()))

This example returns a number list with Total time Spent (in minutes) in blocking issues and sub-tasks.

To achieve this, the following functions are used:

This number list can be summed using function sum().

Additional information

Parameters used in this function

Parameter

Input (data type)

Description

numberList1

number list

Any given number list.

numberList2

number list

Any given number list.

Output

This function returns a number list .

If both lists are empty, the function returns an empty  number list .


Text list

Variant for text lists.

Bash
append(textList1, textList2) #Output: Text list

Examples

Parser expression

Description
Bash
append(["blue", "red", "green"], ["red", "green", "yellow"])

This example returns

["blue", "red", "green", "red", "green", "yellow"]

Bash
append(fieldValue(%{issue.fixVersion}, subtasks()), fieldValue(%{issue.fixVersion}, linkedIssues("is blocked by")))

This example returns a text list with Fix Version/s of all sub-tasks and blocking issues.

To achieve this, the following functions are used:

Additional information

Parameters used in this function

Parameter

Input (data type)

Description

textList1

text list

Any given text list.

textList2

text list

Any given text list.

Output

This function returns a text list .

If both lists are empty, the function returns an empty  text list .


Issue list

Variant for issue lists.

Bash
append(issueList1, issueList2) #Output: Issue list

Examples

Parser expression

Description
Bash
append(linkedIssues("is blocked by"), subtasks())

This example returns an issue list of blocking issues and sub-tasks.

If a sub-task is also linked with issue link type "is blocked by", it will appear twice in the output list.

To achieve this, the following functions are used:

Additional information

Parameters used in this function

Parameter

Input (data type)

Description

issueList1

issue list

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

issueList2

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 .

If both lists are empty, the function returns an empty  issue list .

This function is the equivalent to the list operator APPEND and can be used interchangeably. 

📚 Use cases and examples