Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 18 Next »

Table of Contents

Since version 3.4

Icon

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 issues
  • 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.

The first 1,000 results are retrieved

Icon

Note that only the first 1,000 results of the query are retrieved.

Available Criteria

Criteria

Description

What?

Drop-down list to select the types of component 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.
Example: only display components that have not been analyzed within the last 30 days.

Components of project

If the What? criterion is empty, only direct children will be displayed.
If the What? criterion is not empty, all the sub-components (of any sub-levels) of the What? type will be displayed.

Date

Filters components based on the last build date.
Format: YYYY-MM-DD (2012-01-31)
Example: only display components that have been analyzed since January 31st, 2012.

Favourites only

If checked, only components flagged as favourites will be displayed.

Key

Filters components whose key matches a given pattern

  • * to match zero or more characters
  • ? to match any single character

Language

Drop-down list to select the languages to filter on.

MetricFilters components to those where a specific measure is greater than or less than a certain threshold.
Up to three "Metric" criteria can be defined.

Name

Filters components 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.

 

Limitation on variations

Icon

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 Filter

To save a search query as a filter, click on the Save link on the top right corner.

To create a shared filter, check the 

Displaying Filter

Filters can be displayed on dashboards in the following dedicated widgets: Measure Filter as List or Measure Filter as Treemap.

Managing Filters

Once several 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:

 

  • No labels