Versions Compared

Key

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


hiddentrue

Page propertiespanel

Supported list types

Table of Contents

Status
Tech review

Status
titletodo

Style guide

Status
titletodo

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

Page properties
hiddentrue

exclude(Supported list types).*
stylecircle
typeflat
separatorpipe

Short descriptionReturns a  Statussubtletruetitlenumber list with all the numbers in argument l which are not in argument m. Duplicated numbers in l may appear in the output.Output Statussubtletruetitlenumber list


Number list

with all the numbers in argument l which are not in argument m. Duplicated numbers in l may appear in the output.

UI Text Box
sizemedium
typeinfo

The This function returns

Status
subtletrue
titlenumber list
UI Text Box
typetip

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 respectedIf you want to avoid repetition, use the function distinct().


Code Block
languagebash
titleSyntax
linenumberstrue
except(number list lnumberList1, number list mnumberList2) #Output: Number list


UI Expand
titleExamples


Parser expressionDescription


Code Block
languagebash
linenumberstrue
except([1, 2, 3, 4, 5], [2, 4])
The function returns a
Status
subtletrue
titlenumber list
:


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

[1, 3, 5

]



UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
<parameter>numeberList1

Status
subtletrue
titledata typenumber list

Any given number listParameter description.
<parameter>lnumberList2

Status
subtletrue
title

data type
number list

Any given number listParameter description.



UI Expand
titleOutput

The This function returns a

Status
subtletrue
titlenumber list

Image RemovedText list

.

UI Text Box
sizemedium
typeinfo
The function returns a 

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

Status
subtletrue
title

string

number list

with all strings in argument l which are not in argument m. Duplicated strings in l may appear in the output.

.



Image AddedText list

UI Text Box
sizemedium
typetipinfo

Variant for text lists

If you want to remove the output of the function except() use the function distinct()

.


Code Block
languagebash
titleSyntax
linenumberstrue
except(string list ltextList1, string list mtextList2) #Output: StringText list


UI Expand
titleExamples


["blue", "black"]

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:

Parser expressionDescription


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


This example returns

The function returns a

Status
subtletrue
titlestring list


Code Block
languagebash
titleSyntax
linenumberstrue
except(fieldValue(%{00074issue.fixVersion}, subtasks()), fieldValue(%{00074issue.fixVersion}, linkedIssues()))


returns the

Status
subtletrue
titlestring list



UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
textList1

Status
subtletrue
titletext list

Any given text list.
textList2

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
.



Image AddedIssue list

UI Text Box
sizemedium
typeinfo

Variant for issue lists.


Code Block
languagebash
titleSyntax
linenumberstrue
except(issueList1, issueList2) #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
issueList1

Status
subtletrue
titleissue list

Any given issue list. Usually this value is retrieved from a function (e.g. linkedIssues() or subtasks()).
issueList2<parameter>
Status
subtletrue
titledata type
Parameter description.<parameter>

Status
subtletrue
title

data type
issue list

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



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. 



Image AddedUse cases and examples

Page properties report
firstcolumnUse case
headingsJWT feature, Workflow function, Field type, Automated action, Parser functions
cqllabel = "parser_func_except" and space = currentSpace()


Page properties
hiddentrue
id1


Parser function cloudexcept()
Map(tick)
Notes




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


The function returns a
Short description

Removes certain elements from a list.

Output

Status
subtletrue
title

string list

list

Available since

Status
subtletrue
colourBlue
title2.1.21

Label