Versions Compared

Key

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



UI Text Box
sizemedium
typeinfo

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


Code Block
languagebash
titleSyntax
linenumberstrue
fieldValue(numberField, issueList) #Output: Number list


UI Expand
titleExamples


Parser expressionDescription


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


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

To achieve this, the following functions are used:


Code Block
languagebash
linenumberstrue
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
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
numberField
Page properties
hiddentrue
Status
Tech review

Status
titletodo

Style guide

Status
titletodo

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

Page properties
hiddentrue
Short descriptionReturns the 

Status
subtletrue
titletext

number list of values stored in the argument field in those issues in the argument issues.Output
Any field code representing a number field or a selectable field.
issueList

Status
subtletrue
title

number

issue list

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



UI Expand
titleOutput

This function returns a

UI Text Box
sizemedium
typeinfo

The function returns the 

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

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
.




UI Text Box
sizemedium
typeinfo

Variant for text fields.


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


UI Expand
titleExamples


of Due Dates of sub-tasks.{00012} is code for the numeric value of Due date.


Parser expressionDescription


Code Block
languagebash
linenumberstrue
fieldValue(%{00012issue.reporter}, subtasks()) 
The function returns the
Status
subtletrue
titlenumber list

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

To achieve this, the following functions are used:



UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
<parameter>textField

Status
subtletrue
titledata type

Parameter description.

text

Any field code representing a text field or a selectable field.
issueList<parameter>

Status
subtletrue
title

data type
issue list

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



UI Expand
titleOutput

The This function returns a

Status
subtletrue
titlenumber text list

UI Text Box
sizemedium
typeinfo

.

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

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

.


UI Text Box
typetip

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



Image AddedUse cases and examples

Page properties report
firstcolumnUse case
headingsJWT feature, Workflow function, Field type, Automated action, Parser functions
cqllabel = "parser_func_fieldvalue" and space = currentSpace()


Page properties
hiddentrue
id1


Parser function cloud
Map(question)
Notes

Workaround

Code Block
let issues = issue.links;
issues.map(i=>i.linkedIssue.summary)

This expression will allow us to access the summary of all the current issue's linked issues. This linked issues can be filtered, but I don't think it's possible to access issues which are not linked to the current issue.




Page properties
hiddentrue



Status
Tech review

Status
colourGreen
titledone

Style guide

Status
colourGreen
titledone

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 field values.

Output
Code Block
languagebash
titleSyntax
linenumberstrue
fieldValue(text field field, issue list issues) #Output: Text list
UI Expand
titleExamples
Parser expressionDescription
Code Block
languagebash
linenumberstrue
fieldValue(%{00006}, subtasks()) 
The function returns the Statussubtletruetitletext list of reporter users of sub-tasks. %{00006} is field code for Reporter.
UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description<parameter> Statussubtletruetitledata typeParameter description.<parameter>

Status
subtletrue
title

data typeParameter description.
ui-expand

number list
 
Status
subtletrue
title

Output

text list

Label
The function returns a

Status

subtle

colour

true

Red
title

number list

staff pick