except() | Decadis App Help Center

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.

Bash

except(numberList1, numberList2) #Output: Number list

Examples

Parser expression	Description
Bash `%{except([1, 2, 3, 4, 5], [2, 4])}`	This example returns 1, 3, 5
Bash `%{except([1, 1, 2, 3, 3], [2])}`	This example returns 1, 3 All duplicates will be removed from the list.
Bash `%{except([1, 1, 2, 3, 3], [])}`	This example returns 1, 2, 3
Bash `%{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()

Additional information

Parameters used in this function

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

Bash

except(textList1, textList2) #Output: Text list

Examples

Parser expression	Description
Bash `%{except(["blue", "red", "green", "black"], ["red", "green", "yellow"])}`	This example returns blue, black
Bash `%{except(toStringList(%{issue.fixVersions}),toStringList(%{issue.versions}))}`	This example returns a text 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: toStringList()

Parser expression

Description

Bash

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

This example returns

blue, black

Bash

%{except(toStringList(%{issue.fixVersions}),toStringList(%{issue.versions}))}

This example returns a text 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:

toStringList()

Additional information

Parameters used in this function

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

Bash

except(issueList1, issueList2) #Output: Issue list

Examples

Parser expression	Description
Bash `%{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()

Parser expression

Description

Bash

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

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

Output

This function returns an issue list .

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

(books) Use cases and examples

Use case
No content found.