This article focuses on another powerful feature of Rich Filters for Jira Dashboards: dynamic filters. These filters allow for fine-grained filtering of issues by individual values available in different fields. For example, you could filter for issues with a particular assignee, status, or label.
Contents:
| Table of Contents | ||
|---|---|---|
|
Prerequisites
A basic understanding of Jira dashboards and rich filters, as explained in Get started with Rich Filters for Jira Dashboards.
An understanding of static filters.
...
If you've already worked through other tutorials in this series, you can base any gadgets you create while following this article on a previously created rich filter. Check that you have one available (find existing rich filters under Apps > Rich Filters). If not, follow the instructions in Get started with Rich Filters for Jira Dashboards to create a new rich filter before continuing.
Create a new dashboard (Dashboards > Create dashboard).
Make sure it uses the Two-column layout. This is usually the default setting, but you can select it if required using the Change layout menu at the top of the dashboard.
| Info |
|---|
If you want a more detailed explanation of creating a new dashboard, see Create a simple dashboard. |
...
Add a Rich Filter Controller gadget to your dashboard and configure it based on your rich filter (Create a simple dashboard explaining how to do this).
Ensure your new gadget is in the left-hand column of your dashboard; you can drag and drop it if necessary.
Open your rich filter config (described in Easier configuration with the Rich filter menu).
Select the Dynamic Filters tab.
Add a dynamic filter based on the Assignee field.
Start typing "Assignee" into the Pick a field... text input.
Select Assignee from the list of options presented to you.
An Assignee dynamic filter will appear above the text input.
In the same way as before, add dynamic filters based on the Priority, Status, Labels, and Resolution fields.
Go back to your dashboard and refresh it; you should now see the dynamic filters on your controller.
Filter the issues in a Rich Filter Results gadget.
...
Add a Rich Filter Results gadget to your dashboard.
Ensure your new gadget is in the right-hand column of your dashboard; you can drag and drop it if necessary.
In the gadget config form, ensure the Rich filter is set to the same rich filter as your controller, then click Submit.
Try clicking some of the dynamic filters in the controller, selecting a few values, clicking Apply filters, and seeing how the list of issues displayed in your Rich Filter Results gadget changes based on your selections. Note also how the dynamic filters display a number to tell you how many values you have selected inside each one.
| Info |
|---|
Unlike static filters, which apply automatically when toggled on or off, dynamic filter changes aren't used to your dashboard until you click the Apply filters button in the controller when changes have been made. This is because dynamic filter settings usually involve selecting several options; the controller allows you to wait until you are happy with your filter selections before applying them. |
...
| Tip |
|---|
Search and range selection are powerful in combination. You can filter the displayed options down to a subset that interests you and then select all of them with one click. |
Search and range selection is powerful in combination — you can filter the displayed options down to a subset that interests you and then select all of them with one click.
...
Open your rich filter config and select the Dynamic Filters tab.
Add a dynamic filter based on the Created field (or another appropriate date/datetime field).
Return to your dashboard, refresh it, and play with your new dynamic filter to see how it updates the listed issues.
Clear all the filters by clicking the X button in the bottom-right corner of the controller.
| Tip |
|---|
The selected date values are inclusive, meaning that they are included in the filter range. |
...
Open your rich filter config and select the Dynamic Filters tab.
Add a dynamic filter based on the Summary field (or another appropriate text field).
Return to your dashboard, refresh it, and play with your new dynamic filter to see how it updates the listed issues.
Clear all the filters by clicking the X button in the bottom-right corner of the controller.
Advanced syntax details about text dynamic filters:
...
Open your rich filter config and select the Dynamic Filters tab.
Add a dynamic filter based on an appropriate numeric field like Story Points.
Return to your dashboard, refresh it, and play with your new dynamic filter to see how it updates the listed issues.
Clear all the filters by clicking the X button in the bottom-right corner of the controller.
...
Your final result should look like this:
...
Next steps
You are advised to can work through the Fundamentals articles in order, but each one works as a standalone topic, so you can jump to specific topics of interest if that suits you better.
...