Status
Tech review

Style guide



Short descriptionConverts text to a text list.
Output




If you want to test the output or need the actually text instead of a list, wrap your expression in a toString() function.


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.


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.



The function returns a