The Rich Filter Flexi Charts gadget

The Rich Filter Flexi Charts gadget replaces the previous Rich Filter Pie Chart gadget.

The Rich Filter Flexi Charts gadget displays a chart with data computed from a collection of issues. This gadget is highly customizable, providing multiple options for the type of chart and the way the data is computed and displayed. It is also based on a rich filter instead of a Jira saved filter, thus providing the following features:

the collection of issues used for the statistics can be further filtered using Rich Filter Controller gadgets;
the gadget itself can further refine the results by applying a gadget-specific JQL that we call a working query;
the gadget can break down the results by an issue field or by a smart filter;
the value type displayed by the gadget can be customized (for instance, to show the sum of Story Points instead of the Issue Count);
the gadget supports multiple display layouts;
the gadget’s title can be customized.

Example 1: Donut chart of Issue Count by Project:

Example 2: Clustered bar chart of Story Points by Status and Assignee:

Rich Filter Extensions

Rich filter extensions are separate Jira apps installed on top of the Rich Filters for Jira Dashboards app to extend the rich filters and rich filter gadgets with new specific functionality.

New statistic options are available if you add any of these extensions:

Rich Filters::Time Tracking Dashboards allows you to display charts based on work log attributes – Worklog Author and Worklog Time Spent
Rich Filters::Service Desk Dashboards allow you to display charts based on Service Desk-specific fields, such as Customer Request Type and Organizations.

Configuring the Rich Filter Flexi Chart gadget

Add a new or edit an existing Rich Filter Flexi Chart gadget in your Jira dashboard. The configuration form of the gadget will be displayed:

Edit the gadget configuration as described in the following table:

Setting	Description

Setting	Description
Title	Optionally, you can customize the title of the gadget. If left blank, the default title will be Rich Filter Pie Chart.
Rich Filter	Select the rich filter the gadget will use. Click the Rich Filter button to display the list of rich filters; you can either scroll through or use the search box to find the desired filter. The gadgets’ configuration forms only show the rich filters you can view. Check the permissions section for more details. The link in the description line below the Rich Filter button opens a new page with the configuration of the You can click the Open rich filter config link below the Rich Filter drop-down to open a new page with the configuration of the selected rich filter. When the gadget is in display mode, select the Open rich filter config option under the Menu () icon to navigate directly to its rich filter.
Working query	The working query is a JQL query combined with the rich filter's base filter before searching for issues. The working query is optional: if left empty, only the base Jira filter and the quick filters affect the issues displayed.
Chart type	Select one of the available chart types: 1D charts: Donut chart Pie chart Gauge chart Sliced bar chart Treemap chart Percentage bar Bar chart Line chart Word cloud chart 2D charts: Clustered bar chart Stacked bar chart Multi-line chart
For 2D charts, two breakdowns need to be configured, one primary and one secondary. Below we describe the breakdown settings only once.
Statistic type	Select the issue field or the smart filter on which the issues will be grouped. This setting is mandatory. For the breakdown of 1D charts and for the primary breakdown of 2D charts, there are several types of configuration, depending on the selected Statistic type: a. Statistics on option fields (e.g. Priority, Status, select custom fields, etc.) or smart filters b. Statistics on date or date time fields The secondary breakdown of 2D charts can only be based on options fields or smart filters. These options are further detailed in the sections below.

Statistics on option fields or smart filters

The following settings are applicable when the selected Statistic type is an option field (e.g. Priority, Status, select custom fields, etc.) or a smart filter:

Setting	Description

Setting	Description
Sort by	Select the order in which the values are displayed in the chart. The following options are available: Total: this will sort by the value computed for each Statistic type group. Alphabetical: this will use alphabetical order for the Statistic type groups. Natural: this will use the native sorting order of the issue field or smart filter selected as Statistic type, i.e. the order that has been configured for the options of the field or smart filter. This sorting option is available only for the issue fields Priority, Status, and Issue Type and for smart filters.
Reverse sort order	If checked, the sort order is reversed.
Maximum slices / bars etc.	These settings limit the number of slices / bars etc. to display. In the case of slices, the ones which are not individually displayed due to this limit are represented by one slice called Other. The user can still display all the computed slices / bars etc. by clicking on the numbers in rounded rectangles located at the bottom right of the gadget.
Value	Select the value to be computed for each Statistic type group. There are four kinds of possible values: Issue Count: computes the number of issues in each group.p. Numeric: computes the sum of a numeric field for the issues in each group. For instance, when using Jira Software, the gadget can show how many Story Points there are for each Statistic type group. Σ numeric: the same as Numeric, but it also includes the values in its sub-tasks for each issue. Time tracking: computes the sum of one of the time-tracking fields (i.e. Original Estimate, Remaining Estimate, Time Spent) for the issues in each group. Σ time tracking: the same as Time Tracking, but it also includes the values in its sub-tasks for each issue. Numeric: computes the sum of a numeric field for the issues in each group. For instance, when using Jira Software, the gadget can show how many Story Points there are for each Statistic type group.

Statistics on date fields

The following settings are applicable when the selected Statistic type is a date or a date time field:

Please note that date fields can be used as breakdown only in Bar, Clustered/Stacked bar, and Line/Multi-line charts. The other chart types are not compatible with date field configurations.

The following settings are applicable when the selected Statistic type is a date or a date time field:

Setting	Description

Setting	Description
Aggregation periods	Select the periods on which the issues will be grouped, according to their values for the date or date time field selected as Statistic type. The available options are: Days, Weeks, Months, Quarters, Years.
Time range	Together with its subsettings, this specifies the total time span for which the statistics should be computed. The time range subsettings depend on the option selected in the Time range drop-down as described below.
	Time Range	Time range subsetting	Description
	Number of days / weeks etc.	Number	Enter the number of aggregation periods to be displayed. The time range corresponds to the specified number of consecutive aggregation periods.
	Number of days / weeks etc.	Direction	Select how the periods are positioned relative to the current period. The possible options are: Past – the time range includes past periods and the current period Future – the time range includes the current period and future periods Past & Future – the time range includes past periods, the current period, and future periods, with the current period in the middle of the range Fields like Created or Resolved always contain values that are in the past. Therefore you should always select Past for these fields as you will never find any issue created or resolved in the future. Fields like Due Date contain values that can be both in the past and in the future. For this field it is more useful to select Future in order to see statistics for the issues that are due soon, or Past & Future to also see the statistics for overdue issues.
	Between dates	From / To	Enter the two dates that define the limits of the time range (both specified dates are inclusive). The inputs can be selected from a date picker or entered manually as a calendar date ("`yyyy/MM/dd`" or "`yyyy-MM-dd`").
	Contextual options		These are predefined Time range options which depend on the selected Aggregation period. Possible options are: This year, Last year, This quarter, Last quarter, This month, Last month.
Aggregation type	Select one of the following aggregation type options: Period value: this is the default option – the chart displays the values of each individual aggregation period; Cumulative trend: progressively adds the values from the previous periods, including only the issues starting with the first period of the chart; Cumulative total: progressively adds the values from the previous periods, also including the issues before the first period.

Examples of Flexi Charts

Donut chart of Issue Count by Project:
Pie chart of Story Points by Warnings:

Gauge chart of Time Spent by Status:

Bar chart of Issue Count by Issue Type:

Bar chart of Time spent by resolved:
Line chart of Issue Count by Created date:
Treemap chart of Story Points by Status:
Percentage bar chart of Business value by Issue type:
Two-dimensional chart with a stacked bar graph showing the number of resolved and unresolved issues for each priority

Quick tables in the Flexi Charts gadget

Quick tables enable users to easily display the values from charts in a tabular format. To toggle the quick table on or off, simply click the table icon ( table icon.png ) located in the gadget's footer.