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]

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"]

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.

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.

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


Use cases and examples