Breadcrumbs

sort()

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:

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:

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:
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:

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).

Output

The function returns an issue list

📚 Use cases and examples