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


fieldValue(numberField, issueList) #Output: Number list



Parser expressionDescription


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


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

To achieve this, the following functions are used:


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



Parameters used in this function

ParameterInput (data type)Description
numberField

Any field code representing a number field.
issueList

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



This function returns a

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 




Variant for text fields.


fieldValue(textField, issueList) #Output: Text list



Parser expressionDescription


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



Parameters used in this function

ParameterInput (data type)Description
textField

Any field code representing a text field.
issueList

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



This function returns a

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 



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




Status
Tech review

Style guide




Short description

Returns a number or text list with field values.

Output

 

Available since2.7.0
Label