Versions Compared

Old Version 3

changes.mady.by.user David Claudia

Saved on

compared with

New Version 4

changes.mady.by.user Danut M [StonikByte]

Saved on

Key

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

...

Setting

Description

Setting

Description

Gadget Title

Choose what to display in the title bar of the gadget.

Variables

Select the variable(s) 'a', 'b', 'c', 'd', 'e' or 'f' that you need and specify how they are calculated. For each of them, choose the Formula (SUM, MIN, MAX, COUNT or AVG) that is applied against the selected Field of the issues returned by the selected Filter or JQL string.

Info

  • On Jira Server and Data Center, the scripted fields added via the ScriptRunner app are also available for selection here, but only if they are configured as numerical fields in the Custom Fields area of Jira Administration. More exactly, their Search Template must be set to Number Search.

  • On Jira Service Management, select the Satisfaction field to calculate, for example, the average Customer Satisfaction (CSAT) based on the feedback provided by your customers after their ticket is closed.

Data To Display

Decide what numbers to display in the gadget by entering Math Formulas that combine one or more of the selected variables. For each formula, enter a Label and specify with how many Decimals the formula result shall be displayed.
Optionally, for each value displayed, you can specify a Prefix and/or Suffix of up to 10 chars representing the unit of measure. The prefix, for instance '$', will be displayed before the calculated value (ex. '$8500.50'), while the suffix, for instance '%', will be displayed after the calculated value (ex. '55.69%'). If you check Format with commas, values like '$8500.50' will be displayed like '$8,500.50'.

...

  • You have to create two filters:

    • a filter that returns all the issues from the project.

    • a filter that returns only the issues from the project that are done.

  • Then, you have to define two variables:

    • 'a' that will be calculated as the SUM of Story Points field of the issues from the first filter. This represents the total estimated work, in story points.

    • 'b' that will be calculated as the SUM of Story Points field of the issues from the second filter. This represents the total amount of work done, in story points.

  • Finally, display the numbers by entering the following math formulas:

    • 'a' - to display the value of 'a' variable representing the total estimated work.

    • 'b' - to display the value of 'b' variable representing the total work done.

    • '(b / a) * 100' - to calculate and display the percent of work done

...

  • Proceed in the same way to calculate and display other project key-numbers.

Info

The gadget displays 'NaN' (Not a Number) if the result of the formula cannot be calculated. This can happen in case of division by zero or when one of the variables cannot be calculated (for example, the AVG or MAX for a filter that returns no issues).

...