Versions Compared

Key

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

In this sectionContents:

...

Table of Contents
stylenone

Anchor
section1
section1

...

About Custom Ratios

Custom ratios are computed user-defined outputs which that can be used in rich filter gadgets. They are defined as ratios, with a numerator and a denominator, which can be based on issue count or numeric & time tracking fields. Optional JQL filtering conditions can be used to filter the contributing issues for the numerator and/or the denominator. Custom ratios can thus be used to compute ratios of different values.

Below is an example of a Rich Filter Simple Gauges gadget which that displays two gauges based on two custom ratios: Completion rate and Work ratio.Image Removed

...

Anchor
section2
section2

...

Custom Ratios' Key Attributes

You can add new and see existing custom ratios and their configuration in the The Custom Ratios   section of your rich filter allows you to add new custom ratios and view existing ones and their configurations.Image Removed

...

The key attributes of a custom ratio are:

Attribute

Description

Name

Each custom ratio has a name which must be unique among the custom ratios within the rich filter.

Color

The selected color will be used to display the ratio in some of the rich filter gadgets.

Numerator

Base value

The value on which the numerator of your custom ratio is based

,

is selected among Issue Count or numeric and time-tracking fields.

Image Removed
Image Added

Numerator

JQL

You can optionally define a JQL query to filter the issues

which contribute

contributing to the numerator of the custom ratio. Only the issues

which satisfy

satisfying this query will be taken into account when calculating the numerator.

Denominator

Base value

The value on which the denominator of your custom ratio is based. The numerator and the denominator can be based on the same field or

on

two different fields of the same type. The denominator can also be a constant (fixed value), which you enter when defining the custom ratio.

The available options for the denominator base value depend on the selected numerator base value:

If the numerator base value isThen the possible options for the denominator base value are
Issue Count

Same as numerator

Issue Count

Constant (fixed value)

A numeric field

Same as numerator

Constant (fixed value)

Any numeric field

A time-tracking field

Same as numerator

Any time-tracking field

Image Removed
Image Added

Denominator

JQL

You can optionally define a JQL query to filter the issues

which contribute

contributing to

the denominator of

the custom ratio's denominator. Only the issues

which

that satisfy this query will be

taken into account

considered when calculating the denominator.

Display format

Specifies the format used to display custom ratios in the rich filter gadgets. The available options are:

  • Percentage – for example, if the value is 3/10, the gadget displays 30%

  • Ratio – for example, if the value is 3/10, the gadget displays 0.3

If the Ratio option is selected, you

have the possibility to

can further select how many decimals to display:

none

none or

exactly

exactly 3, 2, or 1 decimals.

Image Removed
Image Added
Info
Custom

Independent of this setting, custom ratios are always displayed as percentages in gauge gadgets

, independently of this setting

.

Anchor
section3
section3

...

Adding & Editing Custom Ratios

The The Custom Ratios section  section of your rich filter allows you to perform the following operations:

To achieve this:

Do the following:

Add a new custom ratio

Click on the Create

custom ratio

Custom Ratio button at the top-right of the page.

Image Modified

Type a name, select a color, configure the numerator and

the

denominator, choose the display format,

then

and click

on

the Create button.

Image Removed
Image Added
Info

You can add up to 50 custom ratios in each rich filter.

View or edit a custom ratio

Click

Depending on your rights, click on any custom ratio to view or edit its configuration

, depending on your rights

Image Modified

Reorder the custom ratios

Hover over the vertical “grid” icon, then drag and drop the custom ratio up or down to the new position.

Image Modified

Delete a custom ratio

Click on the delete icon located at the right of the custom ratio.

Image Modified

Anchor
section4
section4

...

Using Custom Ratios in Rich Filter Gadgets

Below, we provide the list of rich filter gadgets that can display custom ratios:

  • The Rich Filter Simple Gauges gadget

    displaying

    displays gauges based on three custom ratios: Completion rate, Work ratio, and SLA %Met:

...

...

Check the Rich Filter Simple Gauges Gadget documentation page to see how to configure the gadget.

  • The Rich Filter Smart Gauges gadget

    displaying

    displays for each team (defined in a smart filter) a gauge representing a custom ratio named Work ratio:

Image Removed

...

Check the Rich Filter Smart Gauges Gadget documentation page to see how to configure the gadget.

  • The Rich Filter Statistics gadget

    displaying

    displays two custom ratios

    :

    , Completion rate, and Work ratio, aggregated by the issue field Priority:

...

...

Check the Rich Filter Statistics Gadget documentation page to see how to configure the gadget.

  • The Rich Filter Two-Dimensional Statistics gadget

    displaying

    displays a custom ratio named SLA %Met, aggregated by the issue field Priority and a smart filter named Team:

...

...

Check the Rich Filter Two Dimensional Statistics Gadget documentation page to see how to configure the gadget.

  • The Rich Filter Flexi Chart gadget

    displaying

    displays the Completion rate custom ratio broken down by assignees. 

...

...

Check the  Rich Filter Flexi Charts Gadget documentation page to see how to configure the gadget.

  • The Rich Filter Time Series Chart gadget

    displaying

    displays two time series: Work ratio and Resolved issues.

...

...

Check the Rich Filter Time Series Chart Gadget documentation page to see how to configure the gadget.