This function converts a comma-separated text into a text list.

A common use case is a text list representing each of the selected elements of a selectable field like an issue picker.


If you need the actual text instead of a list, wrap your expression in a toString() function.


toStringList(text) #Output: Text list



Parser expressionDescription


%{toStringList(%{issue.components})}


This example returns a text list with each of the components selected in the current issue, e.g.:

ui,portal


%{toString(toStringList(%{issue.labels}))}


This example returns a text with each of the labels selected in the current issue, e.g.:

web, customer, mobile

To achieve this, the following functions are used:



Parameters used in this function

ParameterInput (data type)Description
text

Any comma-separated text satisfying the format: "Element1, Element2".

This function is often used in combination with selectable fields like an issue picker.



The function returns a



Variant where you can additionally define custom separators.

Leading and trailing spaces around each list element are automatically removed.


 toStringList(text, separators) #Output: Text list



Parser expressionDescription


%{toStringList("red, orange, yellow? green; blue; purple", ",?;")}


This example returns the following text list:

["red", "orange", "yellow", "green", "blue", "purple"]



Parameters used in this function

ParameterInput (data type)Description
text

Any text with elements separated by one of the separators defined in the second argument.
separators

Any separator characters.



This function returns a


Use cases and examples



Short descriptionConverts text to a text list.
Output