This documentation relates to version 1.8 of the Rich Filters Add-on for JIRA. Documentation for previous versions is available via the documentation index.
The Smart Filters are the last type of filter you can define in Rich Filters. By the end of this tutorial you'll be able to add drop-down buttons that allow you to filter by criteria you have defined. You'll also be able to display in Rich Filter Results gadget (colored) computed columns (we call these smart columns) based on the same criteria.
How to add smart filters and smart columns
For this tutorial you need to already have created a Rich Filter and a dashboard with a Controller and 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.
- Open the configuration page of your Rich Filter.
- Once you are on the Rich Filter configuration page, click on Smart Filters link on the left of your screen.
- Add a new Smart Filter. Give it the name Warnings and check only Labels Tag Types (more about this in a second).
- Add the three clauses below:
- Label: High Priority, JQL:
priority in (1,2) and status = Open
- Label: Past Due Date, JQL:
duedate < now() and status != Closed
- Label: No Due Date, JQL:
duedate = empty and status not in (Resolved, Closed)
- Label: High Priority, JQL:
- Open/refresh the dashboard you already have and which is based on your Rich Filter. You'll notice that a new drop-down filter has been added in the Controller containing the three options you have configured. Clicking any option will trigger the other gadgets based on the same Rich Filter in the dashboard to apply the JQL you have configured for each option.
- Go back to the Smart Filters section of your Rich Filter configuration page. Edit the Warnings smart filter.
- Add the Colors Tag Type.
- For each clause of the Warnings Smart filter add a color like in the picture below.
- Go in the Views section of the Rich Filter.
- In the Requester View, you'll notice that it is now possible to use the Smart Filter as a computed column (we call this a Smart Column). Add the Warnings Smart Column to your view.
- Once added, edit the Warning Smart Column.
- Make sure you select: Show tags as - Colored Labels and Column Heading - Smart Filter Name.
- Open/refresh the dashboard you already have and which is based on your Rich Filter. You'll notice that the Requester view of the Filter Results Gadget now displays a new column called Warnings, just the way you have configured.
- Go back to the Smart Filters section of your Rich Filter configuration page. Create a new Smart Filter called Risk and which has only the Tag Type Colors.
- Add the JQL:
priority in (1,2) and assignee = empty
Make sure you click on the Add button.
- Go to the View section of your Rich Filter. In the Delivery view add the Smart Column Risk you have just created.
- Drag & drop the Risk Smart Column after the Priority column.
- Edit the Risk Smart Column
- Make sure you select Column Heading - None (we want this column to be as compact as possible).
- Open/refresh the dashboard you already have and which is based on your Rich Filter. You'll notice that in the Delivery view of the Filter Results Gadget, next to the Priority field, unassigned issues in Priority 1 or 2 are highlighted.
Smart Filters are a very powerful mechanism that allow you to create complex filtering groups, to add computed columns to your views and highlight issues using color coding.
To follow through with the tutorial, continue to Add Rich Filter Statistics gadgets to your interactive JIRA Dashboard.
In order to know everything about Smart Filters, have a look at Configuring Smart Filters.