In this section:
Anchor section1 section1
1. About the Rich Filter Controller gadget
| section1 | |
| section1 |
...
| Setting | Description | ||
|---|---|---|---|
| Rich Filter | Select the rich filter the gadget will use. Click on the Rich Filter button to display the list of rich filters; you can either scroll through or use the search box to find the filter you need.
| ||
| 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 Customize shown filters 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. You can also organize your quick filters in named sections.
Besides the individual quick filters, the custom list menu also contains three “group” options: All Static, All Dynamic and All Smart. If these options are used, the gadget will display in their place all the quick filters of the specified type except those that are explicitly included. For example, you can use this to show the Priority dynamic filter first, then all static filters, and then all dynamic filters other than Priority. |
Anchor section3 section3
3. Filtering modes
| section3 | |
| section3 |
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:
The JQL generated for the example above is "component in (Admin, Architecture)", which is functionally equivalent with "component = Admin OR component = Architecture". - AND: this filtering mode is available for fields which 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:
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:
The JQL generated for the example above is "component not in (Admin, Architecture) OR component is EMPTY", which is functionally equivalent with "(component != Admin AND component != Architecture) OR".component is EMPTY
| Info |
|---|
| The AND filtering mode is available only for the fields that can have several values simultaneously (e.g. Labels, multiple selection fields). For instance, users can search for issues that have component A and component B at the same time., but it doesn't make sense to search for issues that have priority High and Low at the same time, 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. |