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().
Syntax
append(numberList1, numberList2) #Output: Number list
Examples
Parser expressionDescription
%{append([1, 2, 3], [3, 4, 5])}

This example returns

1, 2, 3, 3, 4, 5

%{append(toNumberList(%{issue.versions.id}),toNumberList(%{issue.fixVersions.id}))}

This example returns a number list of both affected and fix version/s id/s of the current issue, e.g. 

10002,10000,10001,10002 

To achieve this, the following functions are used:

Additional information

Parameters used in this function

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

Syntax
append(textList1, textList2) #Output: Text list
Examples
Parser expressionDescription
%{append(["blue", "red", "green"], ["red", "green", "yellow"])}

This example returns

blue, red, green, red, green, yellow

%{append(toStringList(%{issue.versions}),toStringList(%{issue.fixVersions}))}

This example returns a text list of both affected and fix version/s of the current issue, e.g. 

1.1,1.0,2.0,1.1 

To achieve this, the following functions are used:

Additional information

Parameters used in this function

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

syntax
append(issueList1, issueList2) #Output: Issue list
Examples
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:

Additional information

Parameters used in this function

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


Use cases and examples