Versions Compared

Key

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


Page properties
hiddentrue



Status
Tech review

Status
colourYellow
titletodoReady for review

Style guide

Status
colourYellow
titletodoReady for review

Status
titletodo
Status
colourYellow
titleReady for review
Status
colourGreen
titledone
Status
colourRed
titleflagged



Page properties
hiddentrue


Short description

Returns a number or text list with values of the given field from the given issues.

Output

Status
subtletrue
titlenumber/ text list




Panel

Supported list types

Table of Contents
exclude(Supported list types).*
stylecircle
typeflat
separatorpipe


Image AddedNumber list

UI Text Box
sizemedium
typeinfo

This function returns the number list with values of values stored in the argument field in those issues in the argument issues.

The argument field has format {nnnnn}. The number of values in output is the number of issues in argument issues with field set.

given field from the given issues.


Code Block
languagebash
titleSyntax
linenumberstrue
fieldValue(numeric field fieldnumberField, issue list issuesissueList) #Output: Number list


UI Expand
titleExamples


Parser expressionDescription


Code Block
languagebash
linenumberstrue
fieldValue({00012issue.dueDate}, subtasks())


This example returns the number list of Due Dates of sub-tasks.{00012} is code for the numeric value of Due datethe sub-tasks' Due Dates.




UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
xxxnumberField

Status
subtletrue
titledata type

Parameter description.

text

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

Status
subtletrue
titledata typeissue list

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



UI Expand
titleOutput

This function returns a

Status
subtletrue
titlenumber 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
subtletrue
titlenumber list
.



Image Added Text list

UI Text Box
sizemedium
typeinfo

This function returns the text list stored in argument field in those issues in the argument issues.

Argument field has format %{nnnnn}, or %{nnnnn.i} for cascading select fields. The number of values in output is the number of issues in argument issues with field set, except for multi-valued fields, for which a value is returned for each selected value in the field.

Multi-valued fields are fields of types: Multi-Select, Checkboxes, Components, Versions, Multi-User Picker, Multi-Group Picker, Issue Pickers, Attachments, and Labels.

a text list with values of the given field from the given issues.


Code Block
languagebash
titleSyntax
linenumberstrue
fieldValue(string field fieldtextField, issue list issuesissueList) #Output: Text list


UI Expand
titleExamples


Parser expressionDescription


Code Block
languagebash
linenumberstrue
fieldValue(%{00006issue.reporter}, subtasks()) 


This example returns the text list of reporter users of sub-tasks. %{00006} is field code for Reporterthe sub-tasks' reporters.



UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
xxxtextField

Status
subtletrue
titledata type

Parameter description.

text

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

Status
subtletrue
titledata typeissue list

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



UI Expand
titleOutput

This function returns a

Status
number list
subtletrue
titletext 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
subtletrue
titletext list
.