filterByCardinality() | Decadis App Help Center

Number list

This function filters a number list by the list elements' cardinality (how often they appear in the list) using the given comparison.

Bash

filterByCardinality(numberList, operator, number) #Output: Number list

Examples

Parser expression	Description
Bash `%{filterByCardinality([anyNumberList], >, 1)}`	In this example a number list with those elements would be returned, that occurred more than once in the number list.
Bash `%{filterByCardinality([1, 1, 2, 3, 4, 4, 4, 5], >, 1)}`	This example returns [1, 4] since 1 and 4 are occurring more than once in the list.
Bash `%{filterByCardinality([1, 1, 2, 3, 4, 4, 4, 5], =, 1)}`	This example returns [2, 3, 5] since these values are occurring exactly once in the list.

Parser expression

Description

Bash

%{filterByCardinality([anyNumberList], >, 1)}

In this example a number list with those elements would be returned, that occurred more than once in the number list.

Bash

%{filterByCardinality([1, 1, 2, 3, 4, 4, 4, 5], >, 1)}

This example returns

[1, 4]

since 1 and 4 are occurring more than once in the list.

Bash

%{filterByCardinality([1, 1, 2, 3, 4, 4, 4, 5], =, 1)}

This example returns

[2, 3, 5]

since these values are occurring exactly once in the list.

Additional information

Parameters used in this function

Parameter	Input (data type)	Description
`numberList`	number list	Any given number list.
`operator`	operator	One of the following comparison operators: =, !=, <, <=, > and >=.
`number`	number	Any given number that will be used in combination with the operator to filter the given list.

Output

This function returns a number list .

If the number list is empty or the comparison won't be fullfilled by any element, the function returns an empty number list .

Text list

A variant for text lists.

Bash

filterByCardinality(textList, operator, number) #Output: Text list

Examples

Parser expression	Description
Bash `%{filterByCardinality(["tiger", "tiger", "lion", "lion", "cat", "lynx", "tiger"], <, 3)}`	This example returns ["lion", "cat", "lynx"] since these elements are occurring less than 3 times in the list.
Syntax Bash `%{filterByCardinality(toStringList(jiraExpression("issue.subtasks.map(s=>s.components.map(c=>c.name))")), =,count(subtasks()))}`	This example returns a text list with those Components who are present in all sub-tasks. To achieve this, the following functions are used: jiraExpression() subtasks() count()

Parser expression

Description

Bash

%{filterByCardinality(["tiger", "tiger", "lion", "lion", "cat", "lynx", "tiger"], <, 3)}

This example returns

["lion", "cat", "lynx"]

since these elements are occurring less than 3 times in the list.

Syntax

Bash

%{filterByCardinality(toStringList(jiraExpression("issue.subtasks.map(s=>s.components.map(c=>c.name))")), =,count(subtasks()))}

This example returns a text list with those Components who are present in all sub-tasks.

To achieve this, the following functions are used:

Additional information

Parameters used in this function

Parameter	Input (data type)	Description
`textList`	text list	Any given text list.
`operator`	operator	One of the following comparison operators: =, !=, <, <=, > and >=.
`number`	number	Any given number that will be used in combination with the operator to filter the given list.

Output

This function returns a text list .

If the number list is empty or the comparison won't be fullfilled by any element, the function returns an empty text list .

Issue list

A variant for issue lists.

Bash

filterByCardinality(issueList, operator, number) #Output: Issue list

Examples

Parser expression	Description
Bash `%{filterByCardinality(linkedIssues(), >, 1)}`	This example returns an issue list with all issues that are linked to the current issue more than once. To achieve this, the following functions are used: linkedIssues()

Parser expression

Description

Bash

%{filterByCardinality(linkedIssues(), >, 1)}

This example returns an issue list with all issues that are linked to the current issue more than once.

To achieve this, the following functions are used:

linkedIssues()

Additional information

Parameters used in this function

Parameter	Input (data type)	Description
`issueList`	issue list	Any given issue list. Usually this value is retrieved from a function (e.g. linkedIssues() or subtasks()).
operator	operator	One of the following comparison operators: =, !=, <, <=, > and >=.
`number`	number	Any given number that will be used in combination with the operator to filter the given list.

Output

This function returns an issue list .

If the number list is empty or the comparison won't be fullfilled by any element, the function returns an empty issue list .

(books) Use cases and examples

Use case
No content found.