toStringList()

Text

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.

Bash
toStringList(text) #Output: Text list

Examples

Parser expression

Description

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

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

ui,portal

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

Additional information

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.

Output

The function returns a text list

Text with defined seperators

Variant where you can additionally define custom separators.

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

Bash
 toStringList(text, separators) #Output: Text list

Examples

Parser expression

Description

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

This example returns the following text list:

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

Additional information

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.

Output

This function returns a text list


(books) Use cases and examples