Ultimate Filter Counts
- Ultimate Dashboard for Jira
The Ultimate Filter Counts gadget is a standard “filter counts” type of gadget where the purpose of this gadget is simply to display the “big numbers” that hold some sort of value or meaning that everyone using the dashboard wants to know about.
Each individual “count” displayed can be either the total number of issues matching the current filtering and Ultimate Controller settings, or, the value displayed is a statistic for a specific numerical field (such as “Story Points”).
For example, it’s useful to know the average story points per issue when determining if the average issue seems more complicated than necessary and so needs to be broken down into more finite stories or tasks.
The remainder of this tutorial will walk through setting up a few filter counts while configuring and demonstrating the Ultimate Filter Counts gadget.
Step #1 - Add a the gadget to a dashboard
Start by filtering the gadget list on the word “Ultimate”…
and look for the Ultimate Filter Counts gadget, then click “Add”
A new instance of the Ultimate Filter Counts gadget should appear on the dashboard, much like this one.
Because this is a newly created gadget, the settings panel is displayed with a new filter count item ready for setting up
Step #2 - Configure the new Filter Count Label
For this demonstration, let’s create an “Avg. Story Points” filter count and we’ll start that with labeling it something concise yet obvious
Step #3 - Configure the issue filtering section
Next is the filtering section, which is where the scope of the Jira queries are narrowed down by either an available Jira filter or a Custom JQL statement…
In this example, we’re going to specifically work with only issues that actually have story points set by selecting Custom JQL from the Custom Filter dropdown and typing "Story Points" > 0 in the Secondary JQL text field
If the Jira organization has a lot of issues (1,000+ for example), this is really a good idea for performance reasons.
Step #4 - Configure the value displayed section
The next section is specifying what the filter count value actually is, which by default is just the total number of issues matching the filtering criteria.
To change this, select the checkbox and the user interface changes to include two new selectors: one for the type of operation and the other selector is for the specific issue field to use (ie: “Story Points”)
Step #5 - Configure the optional threshold indicator
The only section left is an optional threshold configuration and for this demonstration we need to have the value decorated with a success-themed indication when the average story points are less than or equal to “8”
Once that’s all configured, click “Save”…
Step #5 - Saved the first filter count
Once the first filter count has been saved, the gadget returns to the overall filter counts settings panel, displaying a sort-able list of all the configured filter counts and an additional setting to configure the gadget’s Auto Refresh cycle.
With the first filter count saved, click “Save” on the gadget settings so we can see what this looks like!
Step #Finished!
…and when the mouse cursor is hovering over the filter count, there is a tooltip with some extra information presented…
Ta-da!