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.

except(numberList1, numberList2) #Output: Number list
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:

Parameters used in this function

ParameterInput (data type)Description
numeberList1

Any given number list.
lnumberList2

Any given number list.

This function returns a .

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


Text list

Variant for text lists.

except(textList1, textList2) #Output: Text list
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 a string 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:

Parameters used in this function

ParameterInput (data type)Description
textList1

Any given text list.
textList2

Any given text list.

This function returns a .

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


Issue list

Variant for issue lists.

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

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


Status
Tech review

Style guide

Short description

Removes certain elements from a list.

Output

 

Available since

Label