This documentation relates to version 1.7 of the Rich Filters Add-on for JIRA. Documentation for previous versions is available via the documentation index.
By the end of this tutorial you'll know how to use the Rich Filter Statistics and to control the displayed data using a Controller Gadget.
How to add (1D) Statistics Gadgets
For this tutorial you need to already have created a Rich Filter with at least a Smart Filter and a dashboard with a Controller and preferably a Filter Result (with a couple of views) based on the Rich Filter. We have used the the Rich Filter and dashboard from the previous tutorial.
- In the JIRA dashboard add one Rich Filter Statistics Gadget.
- In the configuration of the gadget make sure you set the same Rich Filter you have selected in the other gadgets in the same dashboard (remember, this is what links together the gadgets in the same dashboard; a Controller controls all the gadgets that have the same Rich Filter as the Controller).
- Let's suppose we need to exclude the cancelled issues from the results (all issues having a non-empty resolution other than Fixed). In this case, in the Working Query write the JQL:
resolution in (empty, fixed).
- Pick Statistics Type Assignee
- Save the configuration
- The gadget will display the Issue Count for each Assignee excluding the cancelled issues (because we have used the Working Query).
- If you click on the filters in the Controller you'll notice that the results displayed by the Statistics Gadget are impacted (the filter of the Controller is also applied).
- Edit again the Statistics Gadget.
- Set the Title Assignee Statistics in order to use this title instead of the default one. Add one new output value - Story points.
- Save the configuration of the gadget
- You'll notice that the gadget has the title you have set and it displays two outputs: Issue Count and Story Points.
- Add a new Rich Filter Statistics gadget to the dashboard.
- In the configuration of the gadget select the same Rich Filter you have selected for the other gadget.
- In the Statistics Type list, you'll notice that you can also select the Smart Filters configured in the Rich Filter. As Statistic Type, select the Warnings Smart Filter.
- Save the configuration of the gadget.
The gadget will now display the Issue Count for each value of the Smart Filter.
Smart Filters are a very powerful mechanism. By combining smart filters, the Statistics Gadgets with all the range of possible outputs, and the Controllers you can immediately obtain statistics relevant for different contexts.
In order to know everything about Smart Filter configuration in Rich Filters, have a look at Configuring Smart Filters.
In order to know everything about Rich Filter Statistics gadget, have a look at Configuring the Rich Filter Statistics Gadget.
For the next tutorial, continue to Add Two-Dimensional Rich Filter Statistics gadgets to your interactive JIRA Dashboard.