View source for Metrics/Bugzilla Dashboards

All the Bugzilla dashboards are built from a common template where all functionality is implemented. Afterwards customizations for each team are put in place. The most up to date version of the template is [https://metrics.mozilla.com/pentaho/content/pentaho-cdf-dd/Render?solution=metrics&path=bugzilla/solr/Template2&file=Template.wcdf here]. 

= Menus and filters  =

The menu on the left has all dimensions that can be used to filter results: products, components, priorities, etc. In each menu the '''current''' bug count for each item is also displayed in parenthesis. In each menu the user can select a specific set of items and all charts will only display bugs that match that set of filters. The applied filters, those that are currently affecting the charts, are displayed below the menus. 

== All and None options  ==

Each menu has two special options, ''All'' and ''Remove Filter''. As multiple selections are "or" conditions, selecting all options or selecting none (meaning, no filtering) have, usually, the same result. But not always. If the menu lists only some of the options (e.g., the Assignee menu only displays the top 20), selecting All will filter the top 20 assignees only. It may be useful to filter by "all but one", for example, clicking on All then clicking on nobody@mozilla.org to chart only assigned bugs.<br> 

== Custom input fields  ==

Some dimensions have a custom text input box instead of a set of options (flags, status whiteboard and keywords). These input boxes allow the user to enter free text and also wildcards and solr expressions. Special Solr chars need to be escaped using backslashes.&nbsp;Special Solr chars are: ( ) [ ] { } * -&nbsp;? \ + &amp;&nbsp;! ^ " ~&nbsp;: 

=== Some Solr expression examples<br>  ===

*Wildcards:&nbsp;? and * are wildcards, meaning "any char" and "any number of chars" (more than 1) 
*Ranges: [x TO y] (inclusive) and {x TO y } (exclusive) mean "all matches from x to y" (alphabetical or date ordering) 
*Unbounded ranges: to specify unbounded ranges, for example "all values up to x" use [* TO x]

= Charts  =

Each chart will display a specific metric or set of metrics. Charts may be hidden (show/hide button on upper right corner) and they all have an export button to download the data as a CSV file. In each chart clicking on a caption will toggle the respective data series. 

Open bugs and closed bugs are, respectively, 

*Open bugs: bugs with status NEW, UNCONFIRMED, ASSIGNED or REOPEN; 
*Closed bugs: resolved bugs, regardless of resolution.

The following charts are already implemented: 

*Open bugs evolution: All open bugs, Confirmed bugs only (open but not Unconfirmed) or Unconfirmed bugs. Uses date range specified on the header 
*Current bugs by priority: Displays a breakdown of open bugs (at the end of the date range specified on the header) and allows a second breakdown by one of the other dimensions 
*Current bugs by severity: same as above, but broken down by severity 
*Bug state modifications:&nbsp;number of bugs entering or leaving a given status: Open vs. Closed, Unconfirmed/Accepted/Rejected, New vs. Reopen (to be implemented)

*Bug age distribution charts:
**Current open bugs: number of days a bug was open (for all Open bugs at the end of the date range) 
**Current unconfirmed bugs: number of days a bug was Unconfirmed (for all Unconfirmed bugs at the end of the date range) 
**Unconfirmed bugs (time to reject): number of days a bug was unconfirmed before being rejected (resolved), for all bugs that were rejected in the date range 
**Unconfirmed bugs (time to accept): number of days a bug was unconfirmed before being accepted (got a status of New, Assigned or Reopen), for all bugs that were accepted in the date range. 
**Resolved bugs (time to close): number of days a bug was open before being resolved, for all bugs resolved in the date range.

= Saved views =

Each dashboard has different default values for all filters and options. However, users may save a specific set of filters/options as its preferred settings. In order to save the state of the dashboard to use as default, click on the "Save view" button on the header.

The information being saved is:

*Filters list
*Visible and hidden chart list
*Open and closed menus

Date ranges are not saved..


The Reset View button restores default values and the dashboard will load next time using the original settings.

'''Future development''': the feature roadmap includes the possibility of saving multiple views and an easy way to toggle between them, allowing the users to set up as many custom views as needed.