Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


UI Text Box
sizemedium
typeinfo

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

A common use case is a text list representing the selected elements of a selectable field, e.g. components.


UI Text Box
typetip

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


Code Block
languagebash
titleSyntax
linenumberstrue
toStringList(text) #Output: Text list


UI Expand
titleExamples


Parser expressionDescription


Code Block
languagebash
linenumberstrue
toStringList(%{issue.components})


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

["ui", "portal"]


Code Block
languagebash
linenumberstrue
count(toStringList(%{issue.labels}))


This example returns the number of labels attached to the current issue, e.g.:

2

To achieve this, the following functions are used:



UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
text

Status
subtletrue
titletext

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

This function is often used in combination with Selectable field options.



UI Expand
titleOutput

The function returns a

Status
subtletrue
titletext list




UI Text Box
sizemedium
typeinfo

Variant where you can additionally define custom separators.

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


Code Block
languagebash
titleSyntax
linenumberstrue
toStringList(text, separators) #Output: Text list


UI Expand
titleExamples


Parser expressionDescription


Code Block
languagebash
linenumberstrue
toStringList("red, orange, yellow? green; blue; purple", ",?;")


This example returns the text list:

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



UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
text

Status
subtletrue
titletext

Any text with elements separated by the characters defined in the second argument.

separators

Status
subtletrue
titletext

Any separator character.



UI Expand
titleOutput

The function returns a

Status
subtletrue
titletext list



Use cases and examples

Page properties report
firstcolumnUse case
headingsJWT feature, Workflow function, Field type, Automated action, Parser functions
cqllabel = "parser_func_tostringlist" and space = currentSpace()


Page properties
hiddentrue
id1


Parser function cloudtoStringList()
Map(tick)
Notes




Page properties
hiddentrue



Status
Tech review

Status
colourGreen
titledone

Style guide

Status
colourGreen
titledone

Status
titletodo
Status
colourYellow
titleReady for review
Status
colourGreen
titledone
Status
colourRed
titleflagged



Page properties
hiddentrue


Short descriptionConverts text into a text list.
Output

Status
subtletrue
titletext list

Available since
Label