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 be able to split your list of issues in two groups: cancelled and non-cancelled issues issues. Each group will be displayed by a different Rich Filter Results Gadget and both of them controlled by the same Controller.
In this example we consider cancelled all the issues that have a non-empty resolution different from Fixed. Depending on your JIRA configuration, you might have different resolutions and conventions.
How to use the Working Queries
For this tutorial you need to already have created a Rich Filter and a dashboard with a Controller and Filter Result based on the Rich Filter. We have used the Rich Filter and dashboard created in the previous tutorial.
- Open the configuration of the Rich Filter Gadget you already have in your dashboard
- In the Working Query add the JQL
resolution in (Empty, Fixed). This JQL fragment will always be applied (
ANDed) to the JQL filter that feeds the gadget. Therefore, this gadget will display only issues having no resolution or the resolution Fixed (this is what we consider to mean not-cancelled in this example).
- Customize the title of your gadget: write Not Cancelled so that users easily understand what the gadget displays.
- Save the configuration of your gadget.
- You’ll now see that the gadget has the name Not Cancelled as configured. Also, it displays only issues whose resolution is Fixed or empty (“Unresolved”).
Click on the Closed static filter button. The filter results gadget reloads, and only fixed issues are displayed.
- Add a new Rich Filter Results gadget to your dashboard. Base this new Rich Filter Result on the same Rich Filter as the two other gadgets. Add the working query
resolution not in (empty, Fixed). Set the title of the gadget to Cancelled so that users can tell easily what the gadget displays.
Optionally, set a different color for this gadget.
- Click on Customize Views. Select only the Delivery view—the gadget will display only this view for the Cancelled issues.
- Save the configuration of you gadget. The gadget will have the title Cancelled and will display only the cancelled issues (non-empty resolution different than Fixed) using the Delivery view.
- Click on the Closed static filter in your Controller. This will impact both Filter Results Gadgets (all gadgets based on the same rich filter in the dashboard). The first one will show the Closed/Fixed issues and the second one will show the Closed issues having a resolution other than Fixed.
The Working Query is a powerful mechanism allowing you to split your issues in as many groups an you want (overlapping or not). All Rich Filter Gadgets support this feature (except for the Controller, for which this setting is not relevant).
Also, if you use the Order By clause in a Working Query, this will overwrite the Order By clause of the base filter, allowing you to customize the default ordering of issues.