| Info | ||||
|---|---|---|---|---|
| ||||
|
| Note | ||
|---|---|---|
| ||
This page documents the new Measures service that replaces the Filters service. |
The Measures service provides a way to quickly execute all kinds of queries on project measures. You can for example get:
- the recently inspected projects
- the projects with blocker and critical violations
- the projects with bad coverage on added/changed code within the 10 past days
- etc.
The search query can then be saved as a filter to be displayed on dashboards.
The Measures service can be accessed through the top bar:
Search
To add criteria to the search query, click on More criteria and select a criterion. As many criteria as you wish can be added.
Set the criteria and click on the Search button to display the results.
Available Criteria
Criteria | Description |
|---|---|
What? | Drop-down list to select the types of resource to search for: projects, views, files, developers, etc. |
Age | Same as the Date criterion but a period has to be set instead of a date. |
Components of project | If the What? criterion is empty, only direct children will be displayed. |
Date | Filters resources based on the last build date. |
Favourites only | If checked, only resources flagged as favourites will be displayed. |
Key | Filters resources whose key matches a given pattern
|
Language | Drop-down list to select the languages to filter on. |
| Metric | Filters resources whose a given measure is greater than or less than a certain threshold. Up to three "Metric" criteria can be defined. |
Name | Filters resources whose name contains a given string. |
Results Display Configuration
The results can be displayed either as list or treemap. The display can be changed through the Display as link on the top right corner:
Then by clicking on Change Columns (for list display) or Change Treemap (for treemap display), display details can be configured: list of measures (value or variation), ordering of the columns, sort, etc.
| Info | ||
|---|---|---|
| ||
Note that variations cannot be displayed at file level (as all previous data are purged at file level during an analysis). By default, data are also purged at package/module level. Thus variations cannot be displayed at this level by default. To change this behavior, log in as an administrator, go to Settings > Configuration > General Settings > Database Cleaner and set the Clean history data of directories/packages property to true. |
Filters
Saving Search Query as Measure Filter
To save a search query as a measure filter, click on the Save link on the top right corner.
To create a shared measure filter, check the
Displaying Measure Filter
Measure filters can be displayed on dashboards in the following dedicated widgets: Measure Filter as List or Measure Filter as Treemap.
Managing Measure Filters
Once several measure filters have been created, it becomes necessary to manage them: edit, copy, delete, share, flag as favourite, etc. To do so, click on the Manage link in the left menu:
