Versions Compared

Key

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


Panel

Supported list types

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


Number list

UI Text Box
sizemedium
typeinfo

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.


Code Block
languagebash
titleSyntax
linenumberstrue
except(numberList1, numberList2) #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]


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



UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
numeberList1

Status
subtletrue
titlenumber list

Any given number list.
lnumberList2

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

Variant for text lists.


Code Block
languagebash
titleSyntax
linenumberstrue
except(textList1, textList2) #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
title
languagebash
Syntaxlinenumberstrue
%{except(fieldValuetoStringList(%{issue.fixVersionfixVersions}, subtasks()), fieldValuetoStringList(%{issue.fixVersionversions}, linkedIssues()))}


This example returns a text list

of Fix Version

 of fix version/s

 that

that are

in sub-tasks and not in linked issues.

not as well affected version/s of the current issue, e.g. 

1.0,2.0 

To achieve this, the following functions are used:

  • fieldValue()
  • subtasks()
  • linkedIssues



    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
    .



    Issue 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

    Status
    subtletrue
    titleissue list

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



    This function is the equivalent to the list operator EXCEPT and can be used interchangeably. 
    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



    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



    Status
    Tech review

    Status
    colourGreen
    titledonetodo

    Style guide

    Status
    colourGreen
    titledone

    Status
    titletodo
    Status
    colourYellow
    titleReady for review
    Status
    Green
    colour
    titledone
    Status
    colourRed
    titleflagged



    Page properties
    hiddentrue


    Short description

    Removes certain elements from a list.

    Output

    Status
    subtletrue
    titlenumber list
     
    Status
    subtletrue
    titletext list
     
    Status
    subtletrue
    titleissue list

    Available since

    Status
    subtletrue
    colourBlue
    title2.14.210

    Label