Supported list types

Number list

This function returns a number list of elements in a list which are not present in a second list.

The returned list does not contain duplicates. The order is respected.

Syntax
except(numberList1, numberList2) #Output: Number list
Examples
Parser expressionDescription
%{except([1, 2, 3, 4, 5], [2, 4])}

This example returns

1, 3, 5

%{except([1, 1, 2, 3, 3], [2])}

This example returns

1, 3

All duplicates will be removed from the list.

%{except([1, 1, 2, 3, 3], [])}

This example returns

1, 2, 3

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

This example returns a number list of fix version/s id/s that are not as well affected version/s id/s of the current issue, e.g. 

10000,10001 

To achieve this, the following functions are used:

Additional information

Parameters used in this function

ParameterInput (data type)Description
numeberList1

NUMBER LIST

Any given number list.
lnumberList2

NUMBER LIST

Any given number list.
Output

This function returns a NUMBER LIST.

If the first or both lists are empty, the function returns an empty NUMBER LIST.


Text list

Variant for text lists.

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

This example returns

blue, black

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

This example returns text list of fix version/s that are not as well affected version/s of the current issue, e.g. 

1.0,2.0 

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 the first or both lists are empty, the function returns an empty TEXT LIST.


Issue list

Variant for issue lists.

Syntax
except(issueList1, issueList2) #Output: Issue list
Examples
Parser expressionDescription
%{except(linkedIssues(), subtasks())}

This example returns an issue list of linked issues removing those which are also sub-tasks of current issue.

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 the first or both lists are empty, the function returns an empty ISSUE LIST.