fieldValue()

Number list

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

Bash
fieldValue(numberField, issueList) #Output: Number list

Examples

Parser expression

Description

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

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

To achieve this, the following functions are used:

Bash
%{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:

Additional information

Parameters used in this function

Parameter

Input (data type)

Description

numberField

text

Any field code representing a number field.

issueList

issue list

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

Output

This function returns a number list

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


Text list

Variant for text fields.

Bash
fieldValue(textField, issueList) #Output: Text list

Examples

Parser expression

Description

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

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

To achieve this, the following functions are used:

Additional information

Parameters used in this function

Parameter

Input (data type)

Description

textField

text

Any field code representing a text field.

issueList

issue list

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

Output

This function returns a text list

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

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().


(books) Use cases and examples