View Source

Short description	Removes certain elements from a list.
Output
Available since

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.

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]

Parameters used in this function

Parameter	Input (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 .

Variant for text lists.

except(textList1, textList2) #Output: Text list

Parser expression

Description

except(["blue", "red", "green", "black"], ["red", "green", "yellow"])

This example returns

["blue", "black"]

except(fieldValue(%{issue.fixVersion}, subtasks()), fieldValue(%{issue.fixVersion}, linkedIssues()))

This example returns a text list of Fix Version/s that are in sub-tasks and not in linked issues.

To achieve this, the following functions are used:

Parameters used in this function

Parameter	Input (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 .

Variant for issue lists.

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:

Parameters used in this function

Parameter	Input (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 .

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