Supported list types


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


append(numberList1, numberList2) #Output: Number list



Parser expressionDescription


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


This example returns

[1, 2, 3, 3, 4, 5]


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




Parameters used in this function

ParameterInput (data type)Description
numberList1

Any given number list.
numberList2

Any given number list.



This function returns a .

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



Text list

Variant for text lists.


append(textList1, textList2) #Output: Text list



Parser expressionDescription


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


This example returns

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


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:



Parameters used in this function

ParameterInput (data type)Description
textList1

Any given text list.
textList2

Any given text list.



This function returns a .

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



 Issue list

Variant for issue lists.


append(issueList1, issueList2) #Output: Issue list



Parser expressionDescription


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:



Parameters used in this function

ParameterInput (data type)Description
issueList1

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

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



This function returns an .

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


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



Use cases and examples



Parser function cloudappend()
Map(tick)
Notes






Status
Tech review

Style guide




Short description

Combines the elements of two lists.

Output

Available since

Label