Page History

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

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

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

-step UI Step Create a new Calculated Number Field custom field called "Number of Blocking Issues" Head over to Administration → Issues Image Removed → Custom fields → Add custom Field → Advanced → Calculated Number field (by JWT) Image Removedcustom field and name it properly. ui -text-box type tip Providing a description will help you to identify what the custom field does but this step is optional. On the configuration screen of the newly created custom field go to Actions and click on Configure Image Removed UI Step Click on Edit Math/Time Expression Image Removed Math/Numeric expression Add a valid parser expression which will "calculate" the output. Usually field codes will be used for this purpose. Code Block language bash title Expression linenumbers true %{issue.links.count} #This example simply returns the number of linked issues. UI Step Configure the field by entering a math/time expression. Learn more about JWT expression parser. After the configuration, click on Save Image Removed UI Text Box type info The math expression used in this example is: count(filterByResolution(linkedIssues("is blocked by"), "")) To achieve this, the following functions are used: count() filterByResolution() linkedIssues() UI Step Finally, the configuration of the new custom field should look like this: Image Removed tip 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

Example 2: Calculated Number Field "Time to Due Date"

Example 3: Field to show time since issue creation resolution

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:

{00112} != null ? {00112} - {00009} : null , where {00112} is code for Date and time of resolution, and {00009} is code for Date and time of creation.

To achieve this the following functions are used:

• Conditional operator ?:

We select "Duration with short format" as display mode. This way, the string value of the field will be something easily readable, like 1d 11h 30m, but the numerical value will be the duration expressed in milliseconds.

Other display options are available:

• Duration with long format: we get something like, 1 day, 11 hours, 30 minutes.
• Use time tracking settings: we get duration displayed using the number of working hours per day, and the number of working days per week as configured in time tracking, instead of 24 hours per day and 7 days per week.

Finally, the configuration of the new custom field should look like this:

Image Removed