Documentation

This is the documentation for the Atlassian Jira app Quick Filters for Jira.

Installation

Head to the settings within Jira. Note that administrator privileges are required to access the settings.

In the menu on the left side, navigate to “Find new apps” under the “apps” category. Search for “Quick Filters”, wait until the entry “Quick Filters for Jira Dashboards” is shown and proceed to “Install” the app.

Setting up your Dashboard

To start using Quick Filters for Jira Dashboards, navigate to a Jira Dashboard that you can modify. Then, use the “Add Gadget” button to add your first Quick Filter:

Make sure to “Load all gadgets” to make sure the Quick Filters are visible:

Now, get started by adding the “Quick Filter results” gadget:

This gadget works similar to Jira’s “Filter results” gadget, but allows more fine-grained configuration. You can show issues by selecting a Filter, a Project or just type in your Advanced JQL query:

After saving the configuration of the “Quick Filter Results” gadget, go ahead and add the “Quick Controller” gadget, repeating the steps above. You can now add filters that allow you to dynamically adjust the “Quick Filter Results” gadgets on the same dashboard by adding toggle buttons or dropdowns:

After saving the “Quick Controller” gadget, you can try out how the two gadgets work together:

Remember that a “Quick Controller” can dynamically filter many other “Quick Filter Results” gadgets at once, so try adding more of those! Also, you can define different “Groups” to even combine multiple “Quick Controller” gadgets and dynamically filter only one group of other Quick gadgets on the same dashboard.

Other gadgets

 

Quick Issue Statistics

The Quick Issue Statistics gadget displays the collection of issues returned from a specified project or saved filter, grouped by a specified field – in this example the Assignee.

We built this gadget based on the model of Atlassian’s “Issue Statistics”. You can follow the Atlassian documentation in order to configure the gadget.

Besides being interactive, this gadget has another advanced functionality which is not available in the Atlassian gadget. It is possible to aggregate values of any number field which is available in the displayed issues.

Quick Pie Chart

The Quick Pie Chart gadget displays statistical data from a filter grouped by a configurable field – in this example by the Issue Type.

We built this gadget based on the model of Atlassian’s “Pie Chart”. You can follow the Atlassian documentation in order to configure the gadget.

 

Quick Two Dimensional Filter Statistics

The Quick Two Dimensional Filter Statistics gadget displays statistical data based on a specified issue filter, in a configurable table format – In this example the axes are configured to show the number of Issue Types per Assignee.

We built this gadget based on the model of Atlassian’s “Two Dimensional Filter Statistics”. You can follow the Atlassian documentation in order to configure the gadget.

Besides being interactive, this gadget has another advanced functionality which is not available in the Atlassian gadget. It is possible to aggregate values of any number field which is available in the displayed issues.

Quick Issues In Progress

The Quick Issues In Progress gadget displays all issues that are In Progress and assigned to the current user.

Quick Activity Stream

This gadget lists recent activities (issue created, edited, commented, etc.) grouped by users and ordered by date.

Besides being interactive, this gadget has other advanced functionalities which are not available in the Atlassian gadget. 

• It is possible to filter activities by projects, favorite filters and JQL queries.
• The activity stream shows the actual values of custom fields that have been updated.

 

Aggregate values of Jira number fields

The Quick Gadgets “Quick Issue Statistics” and “Quick Two Dimensional Filter Statistics” have advanced functionality which is not available in the Atlassian gadgets, besides being interactive.

Per default the gagdets aggregate the number of issues. In the gadget settings you can edit the “Values shown” to any Jira number field, e.g. Original Estimate. Changing that you can aggregate e.g. the Original Estimate of all issues which are displayed in the gadget.

 

More gadgets?

We’re planning to support many more gadgets in the future and make them compatible with the “Quick Controller” gadget. Since we’re not sure which gadgets would be most useful for our customers, we’ve added a “Quick Other gadgets” gadget, where you can vote which other gadgets you’d most likely combine with the “Quick Controller”. Thanks for your feedback!

Support

If you encounter any issues, feel free to contact our support team. We usually reply within one business day.

 

Thanks for using Quick Filters for Jira Dashboards!