Versions Compared

Key

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

Here are the key concepts:

What is a

Contents:

Table of Contents
stylenone

Rich Filter

Unlike the native Jira gadgets

which are

based on native Jira filters, all the gadgets added by the Rich Filters for the Jira Dashboards app are based on a data source called Rich Filter. A rich filter is a Jira native filter wrapper, extending the Jira native filter to include additional definitions for extra filtering capabilities on top of the native filter, issue highlighting, multiple views for the results, computed fields, and other settings that

can be used by

the Rich Filter Gadgets can use.

What is a

Rich Filter Gadget

The gadgets provided by the Rich Filters for the Jira Dashboards app are called Rich Filter Gadgets. All rich filter gadgets are based on rich filters and have one particular property – two or more rich filter gadgets are linked together in a dashboard if they share the same rich filter. For example, a Rich Filter Controller gadget can change the data displayed by a Rich Filter Results gadget if both the Rich Filter Controller and the Rich Filter Results are based on the same rich filter. 

There are twelve types of rich filter gadgets grouped

in

into five categories:

1. Controlling the dashboard content

Rich Filter Controller Gadget
The Rich Filter Controller gadget is particular

as

because it controls all the other rich filter gadgets in the dashboard. It displays buttons and selectors

which

that allow the user to change

in real-time

the data displayed by the other rich filter gadgets within the same dashboard in real-time.


2. Displaying issues

Rich Filter Results Gadget
Like the Jira built-in Filter Results gadget, this gadget displays a list of issues. The Rich Filter Results gadget also brings new functionality, including

: display of

multiple views of the issue list,

highlight

highlighting and color-

code of

coding issues that match certain criteria,

display of

displaying computed columns, and more.


3. Statistics gadgets

Rich Filter Statistics Gadget
Like the Jira built-in Issues Statistics gadget, the Rich Filter Statistics gadget displays a collection of issues broken down by

a

specified criteria. In addition to statistics based on issue fields, the Rich Filter Statistics gadget can also display statistics based on user-defined criteria (computed fields) or

on

date fields

and

. It can aggregate multiple result types (Issue Count, Story Points, Time Tracking, etc.).

Rich Filter Pie Chart Gadget
Like the Jira built-in Pie Chart gadget, the Rich Filter Pie Chart gadget displays issues returned from a specified filter, grouped by

a

specified criteria. In addition to statistics based on issue fields, the Rich Filter Pie Chart gadget can also display statistics based on user-defined criteria (computed fields)

and

. It can aggregate different result types (Issue Count, Story Points, Time Tracking, etc.).

Rich Filter Two Dimensional Statistics Gadget
Like the Jira built-in Two Dimensional Issue Statistics gadget, the Rich Filter Two Dimensional Statistics gadget displays a collection of issues broken down by specified criteria on two dimensions. In addition to statistics based on issue fields, the Rich Filter Two Dimensional Statistics gadget can also display statistics based on user-defined criteria (computed fields) or

on

date fields

and

. It can aggregate different result types (Issue Count, Story Points, Time Tracking, etc.).


4. Gauges and counters

Rich Filter Simple Counter Gadget
The Rich Filter Simple Counter gadget

simply

aggregates and displays different result types (Issue Count, Story Points, Time Tracking, etc).

Rich Filter Simple Gauge Gadget
The Rich Filter Simple Gauge gadget displays issue count and field sum gauges. Gauge levels are based on predefined criteria or

on

user-defined filters.

Rich Filter Smart Counters Gadget
The Rich Filter Smart Counters gadget displays multiple counters based on user-defined filters. The gadget can aggregate and output different result

types 

types (Issue Count, Story Points, Time Tracking, etc.).

Rich Filter

Smart Gauges

Smart Gauges Gadget
The Rich Filter, Smart Gauges gadget, displays multiple gauges based on user-defined filters.

The gadget

It can aggregate and output different result

types 

types (Issue Count, Story Points, Time Tracking, etc.).

5. Time-based charts

Rich Filter Created vs. Resolved Chart Gadget
Like the Jira built-in Created vs. Resolved Chart gadget, the Rich Filter Created vs. Resolved Chart gadget displays statistics based on the number of issues created versus

the number of issues

those resolved over

a given period of

time. The gadget can compute results based

either

on the number of issues (Issue Count) or

on

the values of any numeric field (Story Points, etc).

Rich Filter Time Series Chart Gadget
The Rich Filter Time Series Chart gadget displays line charts based on date fields, which can point out

trends and

trends and hint at correlations between

these

them.

 The

The gadget can display results based

either

on the number of issues (Issue Count) or

on

the values of any numeric field (Story Points, etc.).

Rich Filter Date Bar Chart Gadget
This gadget is a more powerful version of the Jira built-in Recently Created Chart gadget. The Rich Filter Date Bar Chart gadget is highly customizable and can display a bar chart based on any date field

, it

. It can split the results based on predefined or user-defined criteria (computed rules)

, it

. It supports stacked and clustered layouts and can aggregate different result types (Issue Count, Story Points, etc.).

Learn More

Visit these pages for more about the Rich Filters for Jira Dashboards app:

Getting Started – a series of step-by-step tutorials showing each of the features in turn


. – detailed documentation for creating and managing rich filters. – in-depth explanations of each gadget.