In this section:
Overview
The Coverage Explorer allows you to navigate the source tree to see file- and method-level coverage information. Click on a coverage widget in the Report Center dashboard view to access the coverage explorer (see Widgets). The Coverage Explorer is divided into five sections:
- Search panel; see Using the Search Panel
- Coverage tree panel; see Navigating the Coverage Tree Panel
- Source panel; see Viewing Source Coverage
- Details panel; see Viewing Details
- Tests table; see Viewing Test Information
Using the Search Panel
The Coverage Explorer opens using the settings of the coverage widget you clicked as search parameters, but you can easily change the search to learn about the state of coverage in your application. Click Change Search to open the Search Options.
You can configure the following search settings:
Filter and Target Build
Choose a filter from the Filter drop-down menu. A filter represents a set of run configurations that enable custom views of the data stored in DTP. Run configuration represents of series of test execution and/or code analysis runs. Runs with the same engine (e.g., Jtest, C++test, dotTEST, SOAtest), DTP project, test configuration, and session tag are grouped into the same run configuration. See Creating and Managing Filters to learn more about filters in Report Center.
Choose a build from the Target Build drop-down menu to set as the target build. This drop-down menu lists build IDs associated with the filter.
Coverage Image
Coverage images are identifiers for the coverage data associated with a test run. Coverage images are automatically created when test data is reported to DTP with the report.coverage.images
setting configured. Choose a coverage image from the drop-down menu. See Associating Coverage Images with Filters for additional information.
Coverage Threshold
You can set a range in the coverage threshold search option to constrain which files or methods appear in the search results based on the reported coverage. Enable either File or Method to specify the scope of the threshold and move the sliders to define the range.
The coverage tree panel may show nodes that are outside the defined threshold. In the following example, the coverage threshold setting is configured to show methods with 50% coverage or less:
The overall coverage for the file containing the methods is 53.33%. This is because the combined coverage of all methods in the file raise the coverage above 50%. The file contains other methods that are filtered out per the coverage threshold setting with higher levels of coverage. If the scope is changed from Method to File, the file with 53.33% coverage in the same package is filtered out.
Showing nodes that are outside the range of coverage specified in the coverage threshold setting is expected behavior when the elements are necessary to render the tree per the defined scope.
Resource Groups
If resource groups have been configured, you can click on a group to include it within the search scope. A resource group is a collection of resources (files and/or folders) defined by a set of one or more Ant file patterns. Resource groups enable you to efficiently view development analytics for specific subsets of the code. See Adding Resource Groups to Projects for additional information.
Include and Exclude File Pattern
In addition to other filtering mechanisms available in the Search Options panel, you can specify Ant-style file patterns in the Include File Pattern and/or Exclude File Pattern fields to further refine your search. See Using File Patterns in DTP for more information about configuring file patterns.
Navigating the Coverage Tree Panel
The coverage trees panel displays a hierarchical view of the files within the search parameters. Each node in the hierarchy shows how much of each file or directory is covered in brackets.
You can perform the following actions:
Click on a disclosure triangle to navigate the tree. When an item is loaded that does not have any siblings, its children are automatically loaded and displayed. This behavior will cascade until the tree reaches a branch with multiple items at the same level (a decision point) or until the branch cannot be expanded any further. The coverage tree panel will not automatically expand nodes again if it has been previously expanded and collapsed unless the search criteria has changed or the page has been reloaded.
Click on a file or directory view the information about the file or directory in the details panel; see Viewing Details.
Click on a file to view the contents in the source panel; see Viewing Source Coverage.
Viewing Source Coverage
Click on a file or function in the search results panel to view it in the source panel. You must have permissions to view source code in Report Center explorer views (see Permissions for additional information).
Line-by-line coverage information is color coded:
green lines are lines that are covered with a test.
red lines are not covered.
When you make a selection in the coverage tree panel, the file name and the component that opened the file appears in the code panel.
Viewing Details
The details panel shows information about the selected directory, file, function, or method selected in the search results panel.
Viewing Test Information
The test information table shows all the tests that covers one or more lines of the selected source code. Click on a file that contains covered functions to view test information.
You can perform the following actions:
Click on a column header to sort the table
Click on a test in the Test Name panel to view the test in the test explorer; see Test Explorer.
Click the View all tests link to open all tests shows in the table in the test explorer; see Test Explorer.