The Rich Filter Results Gadget
About the Rich Filter Results gadget
The Rich Filter Results gadget displays one or multiple lists of issues. It resembles Jira’s built-in Filter Results gadget, but it is based on a rich filter instead of a Jira saved search and thus adds several new features:
the content displayed can be further filtered by using Rich Filter Controller gadgets;
the gadget itself can further refine the results by applying a gadget-specific JQL query called a working query;
the gadget can display multiple views defined in the rich filter (which can include computed columns and color coding);
the gadget can display all the issues (the default behavior) or one or multiple queues; queues are custom lists of issues configured in the rich filter;
the gadget allows the users to edit the issues directly from the dashboard using the issue dialog;
the gadget gives easy access to Jira's bulk operations on the displayed issues;
end-users can customize the layout of each view;
the content of the gadget can be exported to PDF, Excel (.xlsx), and CSV formats.
Example 1: gadget configured to display the issues using three views:
Example 2: gadget configured to display three support queues:
Example 3: the selected view displays a Gantt chart:
Configure the Rich Filter Results gadget
Add a new or edit an existing Rich Filter Results gadget in your Jira dashboard. The configuration form of the gadget will be displayed:
Edit the gadget configuration as described in the following table:
Setting | Description |
|---|---|
Rich Filter | Select the rich filter on which the gadget will be based. Click on the Rich Filter selector to display the list of rich filters; you can either scroll through or use the search box to find the filter you need. The gadgets’ configuration forms only show the rich filters you can view. For details, see the Rights and Permissions documentation page. |
Working Query | The working query is an additional JQL query that is permanently applied on top of the base Jira filter and any active quick filters in the controller to further filter the issues the gadget will work with. The working query is optional: if left empty, only the base Jira filter and the quick filters affect the issues displayed by the gadget. The working query can also contain an Note that the gadget can also display queues of issues (see below). In such a case, the order defined in queues takes precedence over all other orders by clauses. |
Display | Two options are possible:
|
Views This applies only if the display option is All issues | You can select the views (among the views defined in the Rich Filter) displayed by the gadget. By default, all views are displayed (the option Show all views is selected). Select the Customize views option to display only selected views. You can add, remove, or reorder the views to be displayed. |
Queues This applies only if the display option is Queues. | You can select the queues (among the queues defined in the selected rich filter) displayed by the gadget. By default, all the queues are displayed (the option Show all queues is selected). Select the Customize queues option to display only selected queues. You can add, remove, or reorder the queues to be displayed. The queues displayed in the same gadget are independent of the current view, page, and sort order. |
Maximum Rows | The maximum number of issues the gadget will display per page. The default is 10; it can be changed, but cannot exceed 50. |
Customize view layout
The end users can customize the layout of each view in two ways:
Adjusting the width of any column,
Choosing how the rows are displayed – two options are available:
rows of variable height, i.e., the rows are displayed on one or several lines, depending on the content and the horizontal space available in the gadget – this is the default option;
rows of the same height, i.e., the rows are always displayed with one line per row (some content will be hidden when the available horizontal space is insufficient).
To adjust the width of a column, simply drag the edge of the column header to reduce or increase its size.
The settings dropdown situated in the top-right corner of the issues table lets you customize the layout of the current view further:
One-line rows: enable you to toggle between rows of variable height (one or multiple lines per row) and rows of the same height (one line per row)
Striped rows: enable you to toggle between rows in one color and rows in stripes
Reset column: If the width of at least one column has been customized, the option removes the customizations and reverts to the default column width
The customizations are remembered at the browser level and do not impact other users of the same dashboard.
Update issues using the issue dialog
You can update issues directly from the dashboard using the issue dialog accessible from the Rich Filter Results gadget. You'll find an Open issue dialog button on the gadget's right-hand side when hovering over an issue. Clicking this button will open the issue dialog directly in the dashboard, allowing users to preview and/or update issues.
Once the user closes the issue dialog, the dashboard is automatically updated to reflect any changes made.
Bulk change issues
The issues displayed in the Rich Filter Results gadget can be modified in bulk by using the Bulk change issues... button located in the gadget's footer.
When clicking Bulk Change Issues, the button redirects you to Jira's Bulk Operation screen. This allows you to edit, move, transition, delete, watch, or stop watching multiple issues in one operation.
Use Gantt charts
A Gantt chart is a bar chart that illustrates a project schedule. Any view can be configured to display a Gantt chart in addition to normal columns like Key and Summary.
In the view configuration (see Enable Gantt chart for details), the Gantt chart is configured with:
a start and an end date based on issue fields,
optionally, a list of dependencies based on issue link types,
a choice for bar colors: predefined based on the issues' status category or customized based on a smart filter.