Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Page properties
hiddentrue



Status
Tech review

Status
colourGreen
titledone

Style guide

Status
colourGreen
titledone

Status
titletodo
Status
colourYellow
titleReady for review
Status
colourGreen
titledone
Status
colourRed
titleflagged



Page properties
hiddentrue


Short description

Subtracts two number, text or issue lists from each otherRemoves certain elements from a list.

Output

Status
subtletrue
titlelist

Available since

Status
subtletrue
colourBlue
title2.1.21




Panel

Supported list types

Table of Contents
exclude(Supported list types).*
stylecircle
typeflat
separatorpipe


Number list

UI Text Box
sizemedium
typeinfo

This function subtracts two number lists from each other. Numbers appearing in both lists will not be returned.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 respectedDuplicates will not appear in the output.


Code Block
languagebash
titleSyntax
linenumberstrue
except(list1numberList1, list2numberList2) #Output: Number list


UI Expand
titleExamples


Parser expressionDescription


Code Block
languagebash
linenumberstrue
except([1, 2, 3, 4, 5], [2, 4])


This example returns

[1, 3, 5]


Code Block
languagebash
linenumberstrue
except([1, 1, 2, 3, 3], [2])


This example returns

[1, 3]

All duplicates will be removed from the list.


Code Block
languagebash
linenumberstrue
except([1, 1, 2, 3, 3], [])


This example returns

[1, 2, 3]



UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
list1numeberList1

Status
subtletrue
titlenumber list

Any given number list.
list2lnumberList2

Status
subtletrue
titlenumber list

Any given number list.



UI Expand
titleOutput

This function returns a

Status
subtletrue
titlenumber list
.

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

Status
subtletrue
titlenumber list
.



Text list

UI Text Box
sizemedium
typeinfo

This function subtracts two Variant for text lists from each other. Texts appearing in both lists will not be returned. Duplicates will not appear in the output.


Code Block
languagebash
titleSyntax
linenumberstrue
except(list1textList1, list2textList2) #Output: Text list


UI Expand
titleExamples


Parser expressionDescription


Code Block
languagebash
linenumberstrue
except(["blue", "red", "green", "black"], ["red", "green", "yellow"])


This example returns

["blue", "black"]


Code Block
languagebash
titleSyntax
linenumberstrue
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:



UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
list1textList1

Status
subtletrue
titletext list

Any given text list.
list2textList2

Status
subtletrue
titletext list

Any given text list.



UI Expand
titleOutput

This function returns a

Status
subtletrue
titletext list
.

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

Status
subtletrue
titletext list
.



Issue list

UI Text Box
sizemedium
typeinfo

This function subtracts two Variant for issue lists from each other. Issues appearing in both lists will not be returned. 

Duplicates will not appear in the output.


Code Block
languagebash
titleSyntax
linenumberstrue
except(list1issueList1, list2issueList2) #Output: Issue list


UI Expand
titleExamples


Parser expressionDescription


Code Block
languagebash
linenumberstrue
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:



UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
list1issueList1

Status
subtletrue
titleissue list

Any given issue list. Usually this value is retrieved from a function (e.g. linkedIssues() or subtasks()).
list2issueList2

Status
subtletrue
titleissue list

Any given issue list. Usually this value is retrieved from a function (e.g. linkedIssues() or subtasks()).



UI Expand
titleOutput

This function returns an

Status
subtletrue
titleissue list
.

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

Status
subtletrue
titleissue list
.


UI Text Box
typetip

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