Versions Compared

Key

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

In this sectionContents:

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

Anchor
section1
section1

...

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.

...

Anchor
section2
section2

...

Smart Filters' Key Attributes

You can The Smart filters section of your rich filter allows you to add new smart filters and see view existing smart filters ones and their key attributes in the Smart Filters section of your rich filterImage Removed

...

The key attributes of a smart filter are:

Attribute

Description

Name

Each smart filter has a name

 which

 that identifies

the filter

it.

It

This name 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
  • an 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

. Each clause is identified by a color and/or a label tag and has a JQL

which

that is applied when the clause is used.

Anchor
section3
section3

...

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.  

Image Modified

Insert a name, select at least one tag type, and click

on

the Add smart filter button.

Image Modified

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.

Image Modified

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.

Image Modified

Delete clauses from the Smart Filter

Click

To delete clauses, click on the

trash can icon at the right of the clause

Trash icon.

Image Modified

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.

Image Modified
Info

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

on

the

edit

Edit icon at the right of the smart filter’s name.

Image Modified

A dialog appears as shown below. Make your changes and click on the Save smart

filter button

filter button.

Image Modified

Delete a Smart Filter

Click

on

the

delete

Delete icon at the right of the smart filter’s name.

Image Modified

Move a Smart Filter

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

Image Modified
Info

When the smart filters of this rich filter are displayed by Controller Gadgets,

by default the smart filters

they are displayed in the order configured in this section by default

Copy (duplicate) a Smart Filter

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

Image Modified

Choose the name of the new smart filter

; you

. You can also

choose to

change the Tag types setting for the copy. Click the Copy smart filter; a new smart filter identical

with

to the first one but with the name you have inserted

is

will be created.

Image Modified

Anchor
section4
section4

...

Using Smart Filters in Rich Filter Gadgets

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

  • The Rich Filter Controller gadget –

    you

    You can use the smart filters to apply additional filtering

    in

    to the other rich filter gadgets. The smart filters are displayed as drop-down menus (similar to dynamic filters).

    Image Modified

    Have a look at The


    Learn more: 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

    Image ModifiedHave a look at the Configuring Views documentation page to see how to add smart filters as smart columns. Have a loot at The


See also:

Configuring Views

Rich Filter Results Gadget

...


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

    Image Modified

    Have a look at The



    Learn more: 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  

    Image Modified

    Have a look at The


    Learn more: 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

    Image Modified

    Have a look at The


    Learn more: 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

    Image Modified

    Have a look at The



    Learn more: 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

    Image Modified

    Have a look at The


    Learn more: 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 a data split type

    Image Modified

    Have a look at The


    Learn more: Rich Filter Date Bar Chart Gadget 

    documentation page to see how to configure the gadget



Info

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:

Image Modified