except()

Supported list types

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

Parser expression	Description
%{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: toNumberList()

Parameters used in this function

Parameter	Input (data type)	Description
`numeberList1`	NUMBER LIST	Any given number list.
`lnumberList2`	NUMBER LIST	Any given number list.

This function returns a NUMBER LIST.

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

Variant for text lists.

Syntax

except(textList1, textList2) #Output: Text list

Parser expression

Description

%{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

Parameter	Input (data type)	Description
`textList1`	TEXT LIST	Any given text list.
`textList2`	TEXT LIST	Any given text list.

This function returns a TEXT LIST.

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

Variant for issue lists.

Syntax

except(issueList1, issueList2) #Output: Issue list

Parser expression	Description
%{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: linkedIssues() subtasks()

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

This function returns an ISSUE LIST.

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