Versions Compared

Key

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

In this sectionContents:

...

Table of Contents
stylenone

Anchor
section1
section1

...

About the Rich Filter Controller gadget

The The Rich Filter Controller gadget  gadget controls what the other rich filter gadgets display (on the same dashboard and based on the same rich filter as the controller). The controller does not display any issue data; it only displays only shows the quick filters that have been defined in the rich filter.Image Removed

...

The quick filters can be reordered and organized in sections. Additionally, the Rich Filter Controller gadget also allows the users to organize the quick filters under sections and to customize their order. export the dashboard content to PDF or Excel files – for more details, see the Exporting data documentation page.  

Anchor
section2
section2

...

Configuring the Rich Filter Controller gadget

Add a new or edit an existing Rich Filter Controller gadget in your Jira dashboard. The configuration form of the gadget will be displayed:Image Removed

...

Edit the gadget configuration as described in the following table:

Setting

Description

Rich Filter

Select the rich filter the gadget will use.

Click

on the 

the Rich Filter

 button

 button to display the list of rich filters; you can either scroll through or use the search box to find the desired filter

you need

.

Info

The gadgets’ configuration forms only show the rich filters you

are allowed to

can view.

 See

 For details, see the Rights and Permissions documentation page

for details

.

Quick Filters & sections

Once you have selected a rich filter for your gadget, you can customize which quick filters you want to display in your controller. By default, controllers show all available quick filters. You can use the radio buttons to change this and display only JQL filtering, or you can choose to customize in detail which quick filters to show and in what order using the last option.

If you choose

the 

the Customize shown filters

 option

 option, the configuration form will change to display the list of quick filters. You can add, remove, or reorder (drag and drop the vertical “grid” icon) the quick filters to be displayed. 

Image Added

You can also organize your quick filters in named sections. 

Image Removed
Image Added

Besides the individual quick filters, the custom list menu

also

contains three “group” options: All Static, All Dynamic

 and 

, and All Smart. If these options are used, the gadget will display

in their place

all the quick filters of the specified

type except 

type in their place except those that are explicitly included. For example, you can use this to show the

 Priority dynamic

Labels dynamic filter first, then all static filters, and then all dynamic filters other than

 Priority

Labels, if any.

Image Added

Anchor
section3
section3

...

Filtering modes

For The user can select a filtering mode alongside the values for the dynamic filters that display dropdowns (e.g., Assignee, Components, Status, Labels), the user can select a filtering mode alongside the values. The filtering modes correspond to the logical operators used to combine the selected values when generating the JQL filtering condition:

  • OR: this is the default filtering mode – when multiple values are selected in a dynamic filter, they are combined with OR, which means that the filter returns the issues that match any (at least one) of the selected values:

    Image RemovedImage Added


    The JQL generated for the example above is "component in (Admin, Architecture),"

    ,

    which is functionally equivalent

    with

    to "component = Admin OR component = Architecture."

    .

  • AND: this filtering mode is available for fields

    which

    that can have several values simultaneously (e.g., Labels, multiple selection fields) – when multiple values are selected in a dynamic filter, they are combined with AND, which means that the filter returns the issues that match all the selected values simultaneously:

    Image RemovedImage Added


    The JQL generated for the example above is "component = Admin AND component = Architecture".

  • NOT: available for all fields – the selected values are negated and combined with AND, which means that the filter returns the issues that don't match any of the selected values:

    Image RemovedImage Added


    The JQL generated for the example above is "component not in (Admin, Architecture) OR component is EMPTY,"

    ,

    which is functionally equivalent

    with

    to "(component != Admin AND component != Architecture) OR component is EMPTY."

    .

Info

The AND filtering mode is available only for

the

fields

that can have

with several values simultaneously (e.g., Labels, multiple selection fields). For instance, users can search for issues

that have component

with components A and

component

B

at the same time

simultaneously.

, but it doesn't make sense to search for issues that have

Still, searching for issues with priority High and Low

at the same time,

simultaneously doesn't make sense because the priority field can have only one value at a time. For fields that cannot have several values simultaneously, only the OR and NOT filtering modes are available.

Dashboard state permalinks are URLs that encode the current state of the Rich Filter Controller gadgets in the dashboard. Later, the generated URL can open the dashboard and restore the quick filters to the same state.  

The permalink can be generated by clicking the corresponding icon in the footer of the Rich Filter Controller gadget. It will then be automatically copied to the clipboard.

...

The generated URL can be bookmarked or sent to another user. When the URL is opened, the rich filter gadgets are restored to the same state as when the link was generated—the same quick filters are selected in the Rich Filter Controller gadgets.