Page History

Versions Compared

Old Version 3

changes.mady.by.user Iheb Kharab

Saved on Jun 15, 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.

Page properties

hidden	true

Status

Tech review

Status

title	todo

Style guide

Status

title	todo

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

Returns a text

Output Statussubtletruetitletext UI Text Box

size	medium
type	info

This function returns a text with a comma-separated list of decimal representation of the numeric values in lconverts the decimal representation of a number (or timestamp) into plain text.

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 text parsing mode, the toString() function converts the output to a readable format.

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

Code Block

language	bash
title	Syntax
linenumbers	true

 toString(number list l) #Output: Text

UI Expand

title	Examples

Parser expression

Description

Code Block

language	bash
linenumbers	true

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

This example returns the following text:

"1, 2, 3, 43.141592"

UI Expand

title	Additional information

Parameters used in this function

Parameter Input (data type) Description

lnumber

Status


subtle	true
title	number list

Any given number listor numerical field code.

UI Expand

title	Output

This function returns a

Status


subtle	true
title	text

UI Text Box

size	medium
type	info

This function returns a text with a comma-separated list of issue keysVariant where you can additionally define the number of decimal places.

Code Block

language	bash
title	Syntax
linenumbers	true

 toString(issue list lnumber, decimalPlaces) #Output: Text

UI Expand

title	Examples

Parser expression Description

Code Block

language	bash
linenumbers	true

toString(subtasks())3.141592, 2)

This example returns "CRM-5, CRM-6 ", being CRM-5 and CRM-6 the keys of current issue's sub-tasks.the text:

"3.14"

UI Expand

title	Additional information

Parameters used in this function

Parameter Input (data type) Description

lnumber

Status


subtle	true
title	issue listnumber

Any given number.

decimalPlaces

Status


subtle	true
title	number

Any positive numberA given issue list.

UI Expand

title	Output

This function returns a

Status


subtle	true
title	text

Image AddedNumber list

UI Text Box

size	medium
type	info

This function returns a text with a list of issue keys separated by parameter separatorconverts any number list into plain text.

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

Code Block

language	bash
title	Syntax
linenumbers	true

 toString(issue list l, string separatornumberList) #Output: Text

UI Expand

title	Examples

Parser expression Description

Code Block

language	bash
linenumbers	true

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

This example returns "CRM-5, CRM-6 ", being CRM-5 and CRM-6 the keys of current issue's sub-tasks.the text:

"1, 2, 3, 4"

UI Expand

title	Additional information

Parameters used in this function

Parameter Input (data type) Description

lnumberList

Status


subtle	true
title	issue number list

A Any given issue list.

separator

Status

subtle	true
title	data type

Parameter descriptionnumber list.

UI Expand

title	Output

This function returns a

Status


subtle	true
title	text

UI Text Box

size	medium
type	info

This function returns a text with a comma-separated list of decimal representations of the numeric values in l, with the number of characters in the decimal part specified by parameter decimalsVariant where you can additionally define the number of decimal places.

Code Block

language	bash
title	Syntax
linenumbers	true

 toString(number list lnumberList, number decimalsdecimalPlaces) #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

lnumberList

Status


subtle	true
title	number list

A Any given number list.

decimalsdecimalPlaces

Status


subtle	true
title	data type	number

Any positive numberParameter description.

UI Expand

title	Output

This function returns a

Status


subtle	true
title	text

UI Text Box

size	medium
type	info

This function returns a text with a list of decimal representations of the numeric values in l, with the number of characters in the decimal part specified by parameter decimals and separated by parameter Variant where you can additionally define a specific separator.

Code Block

language	bash
title	Syntax
linenumbers	true

 toString(number list lnumberList, number decimalsdecimalPlaces, text 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

lnumberList

Status


subtle	true
title	number list

A Any given number list.

decimalsdecimalPlaces

Status


subtle	true
title	number

Parameter descriptionAny positive number.

separator

Status

subtle	true
title	text

Parameter descriptionAny separator character.

UI Expand

title	Output

This function returns a

Status


subtle	true
title	text

Image AddedText list

UI Text Box

size	medium
type	info

This function converts any text list into plain text.

A comma-separated text with each value will be returned.This function returns a text with the decimal representation of the numeric value in n. Numeric value of a Date_Time field is number of milliseconds elapsed since January 1, 1970, 00:00:00 GMT.

Code Block

language	bash
title	Syntax
linenumbers	true

 toString(number ntextList) #Output: Text

UI Expand

title	Examples

following text: "3.141592"

Parser expression

Description

Code Block

language	bash
linenumbers	true

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

This example returns the 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

ntextList

Status


subtle	true
title	numbertext list

Any given numbertext list.

UI Expand

title	Output

This function returns a

Status


subtle	true
title	text

UI Text Box

size	medium
type	info

This function returns a text with the decimal representation of the numeric value in n limiting the fractional part to the number of digits in parameter decimalsVariant where you can additionally define a specific separator.

Code Block

language	bash
title	Syntax
linenumbers	true

 toString(number ntextList, number decimalsseparator) #Output: Text

UI Expand

title	Examples

Parser expression Description

Code Block

language	bash
linenumbers	true

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

This example returns the following text:

"blue; red; green"3.14"

UI Expand

title	Additional information

Parameters used in this function

Parameter Input (data type) Description

ntextList

Status


subtle	true
title	numbertext list

Any given numbertext list.

decimalsseparator

Status

subtle	true
title	numbertext

Any given number smaller or equal than nseparator character.

UI Expand

title	Output

This function returns a

Status


subtle	true
title	text

Image AddedIssue list

UI Text Box

size	medium
type	info

This function returns a text with a commaConverts an issue list into a comma-separated list of text values in ltext containing issue keys.

Code Block

language	bash
title	Syntax
linenumbers	true

 toString(string list lissueList) #Output: Text

UI Expand

title	Examples

Parser expression Description

Code Block

language	bash
linenumbers	true

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

This example returns the following text: "Hello, , world, !"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

lissueList

Status


subtle	true
title	text issue list

Any given text 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

This function returns a text from the list of text values in l separated by parameter Variant where you can additionally define a specific separator.

Code Block

language	bash
title	Syntax
linenumbers	true

toString(text list lissueList, text separator) #Output: Text

UI Expand

title	Examples

returns the following text: " blue; red; green

Parser expression

Description

Code Block

language	bash
linenumbers	true

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

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

lissueList

Status


subtle	true
title	text issue list

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

separatorseperator

Status


subtle	true
title	text

Parameter descriptionAny 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 3

New Version Current

Key

Image AddedNumber list

Image AddedText list

Image AddedIssue list

Image AddedUse cases and examples