Versions Compared

Key

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

Page properties
hiddentrue
Tech review

Status
titletodo

Style guide

Status
titletodo

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

UI Text Box
sizemedium
typeinfo

This type of read-only custom field has a value which is dynamically calculated from a custom math/numeric expression.

It can be used to obtain a numeric value depending on the value of other fields in the current issue or in any other issues (linked issues, sub-tasks, epics, stories, JQL selected issues, etc).

Image AddedConfiguration

Configuring a calculated number field is straightforward. You have to configure a valid parser expression, which will "calculate" the output, and optionally a custom display format.

UI Steps
UI Step

Create a new Calculated Number Field (by JWT) custom field and name it properly.

UI Text Box
typetip

Providing a description will help you to identify what the custom field does but this step is optional.

UI Step

Math/Numeric expression

Add a valid parser expression which will "calculate" the output.

Usually field codes will be used for this purpose.

Code Block
languagebash
titleExpression
linenumberstrue
%{issue.links.count} #This example simply returns the number of linked issues. 
UI Text Box
typetip

The result of the calculation must be a valid number. 

UI Step

Display format

Optionally choose a custom display format format. This is extremely useful to enhance usability for end users.

Read more about the available Display formats.


Image AddedUse cases and examples

Page properties report
headingsField type, JWT feature, Label
sortByTitle
cqllabel = "calculated-field" and space = currentSpace() and ancestor = currentContent()


Excerpt Include
DECADIS:Contact support
DECADIS:Contact support
nopaneltrue

Page properties
hiddentrue
Tech review

Status
colourGreen
titledone

Style guide

Status
colourGreen
titledone

Page status

Status
colourGreen
titlecomplete

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

Configuration

Math expression

Info
iconfalse

This parameter contains a valid math expression that will be calculated each time the value of the field is required.

Example 1 : Calculated Number Field "Number of Blocking Issues"

Info

In this step by step example we show how to create a calculated number field called "Number of Blocking Issues" that will return the number of unresolved issues, the current issue is linked to "is blocked by" issue link type.

Create a new Calculated Number Field custom field called "Number of Blocking Issues"

Administration > Issues > Custom fields > Add Custom Field > Advanced > Calculated Number Field (by JWT)

UI Steps
UI Step