Page History
Page properties | |||||
---|---|---|---|---|---|
| |||||
Tech review |
| ||||
Style guide |
|
Status | ||
---|---|---|
|
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
size | medium |
---|---|
type | info |
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).
Configuration
Math expression
Info | ||
---|---|---|
| ||
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"
Configuration
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
icon | false |
---|
.
UI Steps | ||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Use cases and examples
Page properties report | ||||||
---|---|---|---|---|---|---|
|
Excerpt Include | ||||||
---|---|---|---|---|---|---|
|
Page properties | ||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||
|
Example 2: Calculated Number Field "Time to Due Date"
Info | ||
---|---|---|
| ||
In this example we configure a calculated number field that will show the remaining time for Due Date following the same previous step in the first example, except at step 4 use the following math-time expression : where To achieve this, the following functions are used:
We select duration as display format, since the numeric value being calculated, a number of milliseconds, represents a time duration. This way the value is represented like We also check parameter "Uninitialized when calculated value is zero", since we don't want the field to be shown once Due Date has been reached. Finally, the configuration of the new custom field should look like this: |
Example 3: Field to show time since issue creation resolution
Info | ||
---|---|---|
| ||
In this example we configure a calculated number field for showing the time elapsed since issue creation to issue resolution. For issues which are still not resolved, the field will be uninitialized, thus it won't be shown in the view screen, following the previous steps in the first example, except at step 4 use the following math-time expression:
To achieve this the following functions are used:
We select "Duration with short format" as display mode. This way, the string value of the field will be something easily readable, like Other display options are available:
Finally, the configuration of the new custom field should look like this: |