toStringList() | Decadis App Help Center

Text

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.

If you want to test the output or 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 `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: count()

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

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

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

To achieve this, the following functions are used:

count()

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 field options.

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 field options.

Output

The function returns a text list

Text with separators

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 text list: ["red", "orange", "yellow", "green", "blue", "purple"]

Parser expression

Description

Bash

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

This example returns the 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 the characters defined in the second argument.
`separators`	text	Any separator character.

Output

The function returns a text list

(books) Use cases and examples

Use case	JWT feature	Workflow function	Field type	Automated action	Parser functions
Link to JQL query with information from issue	(input latin letters)		Text		toString() textOnStringList() toStringList()
Display reporters of linked Cloud issues	(input latin letters)		Text		executeRemoteAction() findPattern() toStringList() toString() distinct()
Add components of the epic to the current issue				Update field action
Add links to the issues in a ScriptRunner Issue Picker field				Create issue link action Delete issue link action	issueKeysToIssueList() toString() toStringList() replaceAll() previousValue()
Create sub-tasks depending on selected values in a custom field				Create issue action	toStringList()
Change the assignee to the next evaluator		Update or copy field values			first() toStringList()
Add a table with the elements of a text to an email		Send email			toString() textOnStringList() toStringList()
Clone epic, tasks and sub-tasks		Create issue			toString() toStringList() issueKeysToIssueList() replaceFirst() first() fieldValue() textOnStringList() findModify() subtasks() issuesUnderEpic()
Create a sub-task for every user in a field and assign them		Create issue			getMatchingValue() toStringList()
Create several issues combining fields		Create issue			nthElement() toStringList() modulus() count() ceil()
Create sub-tasks depending on selected values in custom field		Create issue			toStringList()
Create a sub-task for each component		Create issue			toStringList()
Add comment with the request participants' display name		Add comment			toString() textOnStringList() toStringList() userDisplayName()
Prevent external users from creating issues		Logical validator			matches() toString() textOnStringList() toStringList() userDisplayName()
Prevent a transition depending of the number of components		Logical validator Logical condition			numberOfSelectedItems()
Halt a transition if an element is not contained in a list		Logical validator Logical condition			toStringList()
Evaluate Assets objects		Logical validator Logical condition			findPattern() findReplaceAll() replaceAll() toStringList()
Reject duplicated file names in attachments		Logical validator Logical condition			count() toStringList() distinct()