Breadcrumbs

fieldValue()

Number field

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 or a selectable 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 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 field

Variant for text fields.

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

Examples

Parser expression

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

This example returns the text list 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 or a selectable 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 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().

📚 Use cases and examples

Use case Workflow function Field type Automated action Parser functions
Sum of field value from issues in JQL query

Number

sum()

fieldValue()

issuesFromJQL()
Total remaining estimate in an epic (no sub-tasks)

Number

sum()

fieldValue()

issuesUnderEpic()
Clone epic, tasks and sub-tasks

Create issue

toString() toStringList() issueKeysToIssueList() replaceFirst() first() fieldValue() textOnStringList() findModify() subtasks() issuesUnderEpic()
Ensure that all issues linked with a certain issue link type have "Due Date" field set

Logical validator

Logical condition

count()

linkedIssues()

fieldValue()
Set Due Date with latest value among sub-tasks

Update or copy field values

fieldValue()

max()

siblingSubtasks()
Highest ranked custom field value among all linked issues

Text

first()

sort()

fieldValue()

linkedIssues()
Total time logged on an epic

Number

sum()

fieldValue()

issuesUnderEpic()
Sum up value in parent issue on field change in sub-tasks

Update field action

fieldValue()

sum()

subtasks()
Difference between the current date and the earliest due date

Number

min()

fieldValue()

subtasks()
Components from all sub-tasks

Text

toString()

distinct()

fieldValue()

subtasks()
Total remaining estimate in an epic (all linked issues)

Number

sum()

fieldValue()

issuesUnderEpic()

subtasks()
Add components of the epic to the current issue

Update field action
Total of all story points in an epic

Number

sum()

fieldValue()

issuesUnderEpic()
Link to the linked epic from the current issue

Text

toString()

fieldValue()

issueKeysToIssueList()
Inherit value from parent in Advanced Roadmaps hierarchy

Update field action

fieldValue()

first()

parent()
Creation date of the linked epic

Date-time

first()

fieldValue()

linkedIssues()