toStringList()

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.

Syntax

toStringList(text) #Output: Text list

Parser expression

Description

%{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

Parameter Input (data type) Description

text

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 TEXT LIST

Variant where you can additionally define custom separators.

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

Syntax

toStringList(text, separators) #Output: Text list

Parser expression	Description
%{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

Parameter	Input (data type)	Description
text	TEXT	Any text with elements separated by one of the separators defined in the second argument.
`separators`	TEXT	Any separator characters.

The function returns a TEXT LIST