Supported list types


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


sort(numberList, order) #Output: Number list



Parser expressionDescription


%{sort([2, 4, 3, 5, 1], ASC)}


This example returns

[1, 2, 3, 4, 5]


%{sort(toNumberList(%{issue.description}), DESC)}


This example returns a number list in the description sorted by descending order:

[4, 3, 2, 1, -6]

To achieve this, the following functions are used:



Parameters used in this function

ParameterInput (data type)Description
numberList

NUMBER LIST

Any given number list.
order

TEXT

Available orders are ASC (for ascending order) and DESC (for descending order).



This function returns a



Text list

Variant for text lists.


sort(textList, order) #Output: Text list



Parser expressionDescription


%{sort(["red", "blue", "green"], ASC)}


This example returns

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


%{sort(toStringList(%{issue.components}), DESC)}


This example returns a  text list of the components of the current issue sorted in descending order, e.g. 

["UX", "UI", Cloud"]
 

To achieve this, the following functions are used:



Parameters used in this function

ParameterInput (data type)Description
textList

TEXT LIST

Any given text list.
order

TEXT

Available orders are ASC (for ascending order) and DESC (for descending order).



This function returns a



Issue list

Variant for issue lists.

The list is sorted by Issue key. Available orders are ASC (for ascending order) and DESC (for descending order).


sort(issueList, order) #Output: Issue list



Parser expressionDescription


sort(linkedIssues("is blocked by"), ASC)


This example returns an issue list of issues blocking current issue, sorted in ascending order by their Issue key.

To achieve this, the following functions are used:


sort(subtasks(), ASC)


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

To achieve this, the following functions are used:



Parameters used in this function

ParameterInput (data type)Description
issueList

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

Available orders are ASC (for ascending order) and DESC (for descending order).



The function returns an



Use cases and examples




Status
Tech review

Style guide




Short description

Sorts a given list in a specific order.

Output

  

Available since

Label