sort() | Decadis App Help Center

Number list

This function sorts a given number list in a specified order. Available orders are ASC (for ascending order) and DESC (for descending order).

Bash

sort(numberList, order) #Output: Number list

Examples

Parser expression	Description
Bash `sort([2, 4, 3, 1], ASC)`	This example returns: [1, 2, 3, 4]
Bash `sort(fieldValue({issue.cf10110}, linkedIssues()), DESC)`	This example returns a number list with e.g. the Story Points of all linked issues in descending order. To achieve this, the following functions are used: fieldValue() linkedIssues() Note that `{issue.cf10110}` is the field code for Story Points. It might differ on your instance.

Parser expression

Description

Bash

sort([2, 4, 3, 1], ASC)

This example returns:

[1, 2, 3, 4]

Bash

sort(fieldValue({issue.cf10110}, linkedIssues()), DESC)

This example returns a number list with e.g. the Story Points of all linked issues in descending order.

To achieve this, the following functions are used:

Note that {issue.cf10110} is the field code for Story Points. It might differ on your instance.

Additional information

Parameters used in this function

Parameter	Input (data type)	Description
`numberList`	number list	Any given number list.
`order`	text	Available orders are ASC (for ascending order) and DESC (for descending order).

Output

The function returns a number list

Text list

Variant for text lists.

Bash

sort(textList, order) #Output: Text list

Examples

Parser expression	Description
Bash `sort(["red", "blue", "green"], ASC)`	This example returns: ["blue", "green", "red"]
Bash `sort(fieldValue(%{issue.assignee}, subtasks()), ASC)`	This example returns a text list with all sub-tasks's assignees in ascending order. To achieve this, the following functions are used: fieldValue() subtasks()

Parser expression

Description

Bash

sort(["red", "blue", "green"], ASC)

This example returns:

["blue", "green", "red"]

Bash

sort(fieldValue(%{issue.assignee}, subtasks()), ASC)

This example returns a text list with all sub-tasks's assignees in ascending order.

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.
`order`	text	Available orders are ASC (for ascending order) and DESC (for descending order).

Output

The function returns a text list

Issue list

Variant for issue lists.

In this case, a field has to be provided that should be used for the sort order. Available orders are ASC (for ascending order) and DESC (for descending order).

Bash

sort(issueList, field, order) #Output: Issue list

Examples

Parser expression	Description
Bash `sort(linkedIssues("is blocked by"), {issue.dueDate}, ASC)`	This example returns an issue list of issues blocking current issue, sorted in ascending order by Due date. To achieve this, the following functions are used: linkedIssues()
Bash `sort(subtasks(), %{issue.assignee}, ASC)`	This example returns an issue list of sub-tasks, sorted in ascending order by their assignee. To achieve this, the following functions are used: subtasks()

Parser expression

Description

Bash

sort(linkedIssues("is blocked by"), {issue.dueDate}, ASC)

This example returns an issue list of issues blocking current issue, sorted in ascending order by Due date.

To achieve this, the following functions are used:

linkedIssues()

Bash

sort(subtasks(), %{issue.assignee}, ASC)

This example returns an issue list of sub-tasks, sorted in ascending order by their assignee.

To achieve this, the following functions are used:

subtasks()

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() ).
`field`	text	Any field code representing a number, text or selectable field .
`order`	text	Available orders are ASC (for ascending order) and DESC (for descending order).

Parameter

Input (data type)

Description

issueList

issue list

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

linkedIssues()

subtasks()

field

text

Any field code representing a number, text or

selectable field