Page History

Versions Compared

Key

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

UI Text Box

size	medium
type	info

This function returns a number list with values of a given field from the given issues.

Code Block

language	bash
title	Syntax
linenumbers	true

fieldValue(numberField, issueList) #Output: Number list

UI Expand

title	Examples

Parser expression

Description

Code Block

language	bash
linenumbers	true

fieldValue({issue.dueDate}, subtasks())

This example returns a number list of the sub-tasks' Due Dates.

To achieve this, the following functions are used:

subtasks()

Code Block

language	bash
linenumbers	true

sum(fieldValue({issue.cf10203}, subtasks()))

This example returns the sum of all story point estimates (with the custom field ID 10203) of all subtasks.

To achieve this, the following functions are used:

UI Expand

title	Additional information

Parameters used in this function

Parameter Input (data type) Description

numberField

Status


subtle	true
title	text

Any field code representing a number field or a selectable field.

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	number list

If the issue list is empty or there are no values for the field in the given issue list, the function returns an empty

Status


subtle	true
title	number list

UI Text Box

size	medium
type	info

Variant for text fields.

Code Block

language	bash
title	Syntax
linenumbers	true

fieldValue(textField, issueList) #Output: Text list

UI Expand

title	Examples

Parser expression

Description

Code Block

language	bash
linenumbers	true

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

This example returns the text list of the sub-tasks' reporters.

To achieve this, the following functions are used:

subtasks()

UI Expand

title	Additional information

Parameters used in this function

Parameter Input (data type) Description

textField

Status


subtle	true
title	text

Any field code representing a text field or a selectable field.

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 list

If the issue list is empty or there are no values for the field in the given issue list, the function returns an empty

Status


subtle	true
title	text list

UI Text Box

type	tip

This function always returns a list, even when only a single issue is read. The easiest way to return this single value then, is the usage of first().

Use cases and examples

Page properties report

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

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

Returns a number or text list with field values.

Output

Status


subtle	true
title	number list

Status


subtle	true
title	text list

Label

Status


colour	Red
title	staff pick

Content

Space Tools

Versions Compared

Old Version 19

New Version 20

Key

Use cases and examples