Page History

Versions Compared

Old Version 10

changes.mady.by.user Christian Czaia

Saved on Jul 08, 2020

compared with

New Version Current

changes.mady.by.user Iheb Kharab

Saved on Jan 06, 2022

Key

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

UI Text Box

size	medium
type	info

This function converts the decimal representation of a number (or timestamp) into plain text.

Page properties

hidden	true

Status

Tech review

Status

colour	Yellow
title	Ready for review

StatuscolourRedtitlestaff pickStyle guide

Status

colour	Yellow
title	Ready for review

Status

title	todo

Status

colour	Yellow
title	Ready for review

Status

colour	Green
title	done

Status

colour	Red
title	flagged

Page properties

hidden	true

Short description

Converts numbers and lists to plain text.

Output Statussubtletruetitletext UI Text Box

type	tip

This is one of the most commonly used functions in JWT.

Whenever any type of list is returned by a field code or parser function (e.g. subtasks()) and you are using the Advanced advanced text parsing mode, the toString() function converts the output to a readable format.

This is especially helpful if you want to Test your expression.

UI Text Box

size	medium
type	info

This function converts the decimal representation of a number (or timestamp) to plain text. test your expression.

Code Block

language	bash
title	Syntax
linenumbers	true

 toString(number) #Output: Text

UI Expand

title	Examples

Parser expression

Description

Code Block

language	bash
linenumbers	true

toString(3.141592)

This example returns the following text:

"3.141592"

UI Expand

title	Additional information

Parameters used in this function

Parameter Input (data type) Description

number

Status


subtle	true
title	number

Any given number or numerical field code.

UI Expand

title	Output

This function returns a

Status


subtle	true
title	text

UI Text Box

size	medium
type	info

Variant where you can additionally define the number of decimal places.

Code Block

language	bash
title	Syntax
linenumbers	true

 toString(number, decimalPlaces) #Output: Text

UI Expand

title	Examples

Parser expression

Description

Code Block

language	bash
linenumbers	true

toString(3.141592, 2)

This example returns the following text:

"3.14"

UI Expand

title	Additional information

Parameters used in this function

Parameter Input (data type) Description

number

Status


subtle	true
title	number

Any given number.

decimalPlaces

Status


subtle	true
title	number

Any natural number positive number.

UI Expand

title	Output

This function returns a

Status


subtle	true
title	text

Number list

UI Text Box

size	medium
type	info

This function converts any number list to into plain text.

A comma-separated text with the decimal representation of each numeric each numeric value will be returned.

Code Block

language	bash
title	Syntax
linenumbers	true

 toString(numberList) #Output: Text

UI Expand

title	Examples

Parser expression

Description

Code Block

language	bash
linenumbers	true

toString([1, 2, 3, 4.0])

This example returns the following textthe text:

"1, 2, 3, 4"

UI Expand

title	Additional information

Parameters used in this function

Parameter

Input (data type)

Description

numberList

Status


subtle	true
title	number list

Any given number list.

UI Expand

title	Output

This function returns a

Status


subtle	true
title	text

UI Text Box

size	medium
type	info

Variant where you can additionally define the number of decimal places.

Code Block

language	bash
title	Syntax
linenumbers	true

 toString(numberList, decimalPlaces) #Output: Text

UI Expand

title	Examples

Parser expression

Description

Code Block

language	bash
linenumbers	true

toString([1.123, 2.452, 3.64612], 2)

This example returns the following text:

"1.12, 2.45, 3.65"

UI Expand

title	Additional information

Parameters used in this function

Parameter Input (data type) Description

numberList

Status


subtle	true
title	number list

Any given number list.

decimalPlaces

Status


subtle	true
title	number

Any given positive number.

UI Expand

title	Output

This function returns a

Status


subtle	true
title	text

UI Text Box

size	medium
type	info

Variant where you can additionally define a specific separator.

Code Block

language	bash
title	Syntax
linenumbers	true

 toString(numberList, decimalPlaces, separator) #Output: Text

UI Expand

title	Examples

Parser expression

Description

Code Block

language	bash
linenumbers	true

toString([1.123, 2.452, 3.64612], 2, " : ")

This example returns the following text:

"1.12 : 2.45 : 3.65"

UI Expand

title	Additional information

Parameters used in this function

Parameter Input (data type) Description

numberList

Status


subtle	true
title	number list

Any given number list.

decimalPlaces

Status


subtle	true
title	number

Any natural positive number.

separator

Status

subtle	true
title	text

Any separator character.

UI Expand

title	Output

This function returns a

Status


subtle	true
title	text

Text list

UI Text Box

size	medium
type	info

This function converts any text list to into plain text.

A comma-separated text with each value will be returned.

Code Block

language	bash
title	Syntax
linenumbers	true

 toString(textList) #Output: Text

UI Expand

title	Examples

Parser expression

Description

Code Block

language	bash
linenumbers	true

toString(["Hello", " ", "world", "!"])

This example returns the following text:

"Hello, , world, !"

Code Block

language	bash
linenumbers	true

toString(fieldValue(%{issue.reporter}, subtasks()))

This example returns the user names of all sub-task reporters, e.g.:

"b.smith, a.grant"

To achieve this the following functions are used:

UI Expand

title	Additional information

Parameters used in this function

Parameter

Input (data type)

Description

textList

Status


subtle	true
title	text list

Any given text list.

UI Expand

title	Output

This function returns a

Status


subtle	true
title	text

UI Text Box

size	medium
type	info

Variant where you can additionally define a specific separator.

Code Block

language	bash
title	Syntax
linenumbers	true

toString(textList, separator) #Output: Text

UI Expand

title	Examples

Parser expression

Description

Code Block

language	bash
linenumbers	true

toString(["blue", "red", "green"], "; ")

This example returns the following text:

"blue; red; green"

UI Expand

title	Additional information

Parameters used in this function

Parameter Input (data type) Description

textList

Status


subtle	true
title	text list

Any given text list.

separator

Status

subtle	true
title	text

Any separator character.

UI Expand

title	Output

This function returns a

Status


subtle	true
title	text

Issue list

UI Text Box

size	medium
type	info

Converts an issue list to into a comma-separated text containing issue keys.

Code Block

language	bash
title	Syntax
linenumbers	true

toString(issueList) #Output: Text

UI Expand

title	Examples

Parser expression

Description

Code Block

language	bash
linenumbers	true

toString(subtasks())

This example might return:

"CRM-5, CRM-6 "

To achieve this the following functions are used:

subtasks()

UI Expand

title	Additional information

Parameters used in this function

Parameter

Input (data type)

Description

issueList

Status


subtle	true
title	issue list

Any given issue list. Usually this value is retrieved from a function (e.g. linkedIssues() or subtasks()).

UI Expand

title	Output

This function returns a

Status


subtle	true
title	text

UI Text Box

size	medium
type	info

Variant where you can additionally define a specific separator.

Code Block

language	bash
title	Syntax
linenumbers	true

toString(issueList, separator) #Output: Text

UI Expand

title	Examples

Parser expression

Description

Code Block

language	bash
linenumbers	true

 toString(subtasks(), " " )

This example might return:

"CRM-5 CRM-6 CRM-7"

Code Block

language	bash
linenumbers	true

 toString(subtasks(), ";" )

This example might return:

"CRM-5;CRM-6;CRM-7"

UI Expand

title	Additional information

Parameters used in this function

Parameter Input (data type) Description

issueList

Status


subtle	true
title	issue list

Any given issue list. Usually this value is retrieved from a function (e.g. linkedIssues() or subtasks()).

separator

Status


subtle	true
title	text

Any separator character.

UI Expand

title	Output

This function returns a

Status


subtle	true
title	text

Image AddedUse cases and examples

Page properties report

firstcolumn	Use case
headings	JWT feature, Workflow function, Field type, Automated action, Parser functions
cql	label = "parser_func_tostring" and space = currentSpace()

Page properties

hidden	true
id	1

Parser function cloud	toString()
Map
Notes

Page properties

hidden	true

Status

Tech review

Status

colour	Green
title	done

Style guide

Status

colour	Green
title	done

Status

title	todo

Status

colour	Yellow
title	Ready for review

Status

colour	Green
title	done

Status

colour	Red
title	flagged

Page properties

hidden	true

Short description

Converts numbers and lists into plain text.

Output

Status


subtle	true
title	text

Available since

Label

Status


colour	Red
title	staff pick

Content

Space Tools

Versions Compared

Old Version 10

New Version Current

Key

Number list

Text list

Issue list

Image AddedUse cases and examples