except()

Supported list types

This function subtracts two number lists from each other. Duplicates won't appear in the output.

Syntax

except(list1, list2) #Output: Number list

Parser expression Description

except([1, 2, 3, 4, 5], [2, 4])

This example returns the following number list: [1, 3, 5]

except([1, 1, 2, 3, 3], [2])

This example returns the following number list: [1, 3]

All duplicates will be removed from the list.

except([1, 1, 2, 3, 3], [])

This example returns the following number list: [1, 2, 3]

Parameters used in this function

Parameter	Input (data type)	Description
`list1`	NUMBER LIST	Any given number list.
`list2`	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.

This function subtracts two text lists from each other. Duplicates won't appear in the output.

Syntax

except(list1, list2) #Output: Text list

Parser expression	Description
except(["blue", "red", "green", "black"], ["red", "green", "yellow"])	This example returns the following text list: `["blue", "black"]`
Syntax 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.

Parameters used in this function

Parameter	Input (data type)	Description
`list1`	TEXT LIST	Any given text list.
`list2`	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.

This function subtracts two issue lists from each other. Duplicates won't appear in the output.

Syntax

except(list1, list2) #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.

Parameters used in this function

Parameter	Input (data type)	Description
`list1`	ISSUE LIST	Any given issue list. Usually this value is retrieved from a function (e.g. linkedIssues() or subtasks()).
`list2`	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.