This documentation relates to version 1.15 of Rich Filters for Jira Dashboards. Documentation for previous versions is available via the documentation index.

Configuring Smart Filters

In this section:

  1. About Smart Filters
  2. Smart Filters' Key Attributes
  3. Adding & Editing Smart Filters
  4. Using Smart Filters in Rich Filter Gadgets

 1. About Smart Filters

Smart Filters are more versatile than the two other filter types (static and dynamic). Smart filters allow the users to:

  • Filter the collection of issues displayed by gadgets based on the current Rich Filter. The smart filters can be displayed as buttons with drop-down menus in Rich Filter Controller gadgets (similar to dynamic filters).
  • Add computed columns and/or color-coding in Rich Filter Results gadgets.
  • Build statistics on configurable criteria.

2. Smart Filters' Key Attributes

You can add new and see existing smart filters and their key attributes in the Smart Filters section of your rich filter. 

The key attributes of a smart filter are:

AttributeDescription
Name

Each smart filter has a name which identifies the filter. It is mandatory and must be unique among the other smart filters within the Rich Filter.

Tag Type

Each smart filter has at least one tag type. There are two possible tag types: labels and colors. A smart filter can have any or both of these.

  • The labels tag type is necessary in order to use the smart filter in Controller gadgets for filtering (each Label is a option in the filtering drop-down menu), or in Filter Results gadgets as a computed column (each Label is a possible value of the column) or in Statistics gadgets (as statistics criteria).
  • The colors tag type is necessary in order to use the smart filter for color-coding in Filter Results and Statistics gadgets. 
Clauses

A smart filter contains a list of clauses (options), each clause is identified by a color and/or a label tag and has a JQL which is applied when the clause is used.

3. Adding & Editing Smart Filters

The Smart Filters section of your rich filter allows you do to the following operations: 

To do the following:Do this:
Add a new Smart Filter

Click on the Add smart filter button at the top-right of the page.  

Insert a name, select at least one tag type and click on the Add smart filter button.

Add clauses to the Smart Filter

Select a color and/or insert a label (depending on which Tag types you have selected for your smart filter), insert a JQL for the clause and click the Add button.

Edit the clauses of the Smart Filter

Click on the color, label or JQL of the clause to edit it and click on the update icon to save the changes.

Delete clauses from the Smart Filter

Click the trash can icon at the right of the clause.

Reorder the clauses of a Smart Filter

Hover over the vertical “grid” icon of the clause, then drag and drop up or down to the new position.

When the smart filter is displayed by Rich Filter gadgets, the smart filter options are displayed in the order as configured in this section. 

Edit a Smart Filter’s Attributes

Click the edit icon at the right of the smart filter’s name.

A dialog appears. Make your changes and click on the Save smart filter button.

Delete a Smart Filter

Click the delete icon at the right of the smart filter’s name.

Move a Smart Filter

Click on the menu at the right of the smart filter’s name.

When the smart filters of this rich filter are displayed by Controller Gadgets, by default the smart filters are displayed in the order configured in this section. 

Copy (duplicate) a Smart Filter

Click on the Copy option in the smart filter’s menu.

Choose the name of the new smart filter; you can also choose to change the Tag types setting for the copy. Click the Copy smart filter; a new smart filter identical with the first one but with the name you have inserted is created.

4. Using Smart Filters in Rich Filter Gadgets

Once configured, smart filters can be used is several rich filter gadgets:

  • The Rich Filter Controller gadget – you can use the smart filters to apply additional filtering in the other rich filter gadgets. The smart filters are displayed as drop-down menus (similar to dynamic filters).

    Have a look at The Rich Filter Controller Gadget documentation page to see how to configure the gadget

  • The Rich Filter Results gadget – the smart filters can be added in views as smart columns

    Have a look at the Configuring Views documentation page to see how to add smart filters as smart columns. Have a loot at The Rich Filter Results Gadget documentation page to see how to configure the gadget

  • The Rich Filter Statistics gadget – the smart filters can be used as statistics criteria 

    Have a look at The Rich Filter Statistics Gadget documentation page to see how to configure the gadget

  • The Rich Filter Pie Chart gadget – the smart filters can be used as statistics criteria  

    Have a look at The Rich Filter Pie Chart Gadget documentation page to see how to configure the gadget

  • The Rich Filter Two Dimensional Statistics gadget – the smart filters can be used as statistics criteria on any of the two axis or on both

    Have a look at The Rich Filter Two Dimensional Statistics Gadget documentation page to see how to configure the gadget

  • The Rich Filter Smart Counters gadget – the gadget displays one value for each of the clauses of the selected smart filter

    Have a look at The Rich Filter Smart Counters Gadget documentation page to see how to configure the gadget

  • The Rich Filter Smart Gauges gadget – the gadget displays one gauge for for each of the clauses of the selected smart filter

    Have a look at The Rich Filter Smart Gauges Gadget documentation page to see how to configure the gadget

  • The Rich Filter Date Bar Chart gadget – the smart filter can be used as data split type

    Have a look at The Rich Filter Date Bar Chart Gadget documentation page to see how to configure the gadget

When deciding under which clause an issue falls, we use a match-all criteria: the same issue can be part of multiple clauses if it matches the JQL of each clause. This means that when the smart filter is used as a computed column or statistics criteria, it behaves as a multi-select option field.

If you want your clauses to be mutually exclusive, you need to write your JQL in such a way so that an issue can match only one clause at any particular time. For instance, these are mutually exclusive clauses; an issue cannot possibly match more than one clause at a time: