Teams who are responsible for testing software can use the Testing Gaps report to help determine where there are deficiencies in their test plans, test configurations, and test coverage. The Testing Gaps report provides the following five reports based on test results and builds that have been defined and run for a team project.
User Story Status: Helps the team identify gaps in test coverage for each user story. This report requires that team members link test cases to user stories.
User Story Status by Config: Helps the team identify gaps in test coverage for each test configuration for each user story. This report requires that team members link test cases to user stories.
Test Status by Area: Helps the team identify gaps in test coverage of product areas. This report requires that team members assign test cases to product areas.
Tests Not Executed: Helps the team identify test cases that have never been run for each test configuration.
Code Coverage: Helps the team determine which builds and build assemblies have low or high code coverage.
The first four reports are available only when the team creates test plans and starts to run tests by using Microsoft Test Manager. For information about how to define test suites and test plans, see Defining Your Testing Effort Using Test Plans.
Note
You can access the Testing Gaps report from the Test Team Management folder that is located under the Excel Reports folder for the team project in Team Explorer. You can access this folder only if your team project portal has been enabled and is provisioned to use SharePoint Products. For more information, see Access a Team Project Portal and Process Guidance.
To view the report, you must be assigned or belong to a group that has been assigned the Read permissions in SharePoint Products for the team project.
To modify or customize the report, you must be a member of the TfsWarehouseDataReaders security role in SQL Server Analysis Services. You must also be assigned or belong to a group that has been assigned the Members permissions in SharePoint Products for the team project. For more information, see Grant Access to the Databases of the Data Warehouse for Visual Studio ALM and Managing Permissions.
Data in the Reports
The Testing Gaps reports show the cumulative count of test results for the test plans, test configurations, and test cases that are defined for a team project. All reports are based on PivotTables that access data that is stored in the data warehouse.
Test Coverage of User Stories
The User Story Status report indicates how many tests are passing or failing for each user story. It provides a horizontal bar chart that shows the count of test results for each test case and test configuration combination that the team has defined for each user story. The report presents the cumulative outcome of tests run for all test cases that are linked to user stories. The report displays results that are filtered by the following outcomes: Passed (green), Failed (red), Never Run (blue), or Blocked (yellow).
The User Story Status by Config report presents the test results for each user story, grouped by test configuration.
The following table describes the report filters and fields that are used in the PivotTables that generate the reports that are focused on test coverage of user stories.
Filters
Fields
Team Project - Team Project Hierarchy: Includes test results that were collected for the selected team project.
Test Result - Iteration Hierarchy: Includes test results that were run from test cases that were assigned to the selected iterations.
Test Result - Area Hierarchy: Includes test results that were run from test cases that were assigned to the selected product areas.
Test Plan - Test Plan Name: Includes test results that were run from test cases that belong to the selected test plans.
Work Item Linked - Work Item Linked.Work Item Type: Includes test results that were run from test cases that are linked to the selected work item type. The report counts test results for test cases only if they are linked to a user story.
Filter specific to the User Story Status by Config report:
Test Suite - Test Suite Hierarchy: Includes test results that were run from test cases that belong to the selected test suites.
Test Result- Outcome: The outcome of the test. The report uses this field to define the column labels and to filter the test results to include Passed, Failed, Blocked, or Never Run.
(Measure) Test - Point Count Trend: Counts the most recent version of each test result in a particular build. If a test is run multiple times against a build, the Point Count Trend counts the most recent result for that test using that build.
Work Item Link- Title: The title of the work item that is linked to the test case. In this report, the title of the user story is listed.
Field specific to the User Story Status by Config report:
Test Configuration - Configuration Name: The name of the test configuration to list in the report.
Test Coverage by Product Area
The Test Status by Area report indicates how many test cases are passing or failing for a team project by product area. The following table describes the report filters and fields that are used in the PivotTable reports that generate the Test Status by Area report.
Filters
Fields
Team Project - Team Project Hierarchy: Includes test results that are collected for the selected team project.
Test Result - Iteration Hierarchy: Includes test results that were run from test cases that were assigned to the selected iterations.
Test Plan - Test Plan Name: Includes test results that were run from test cases that belong to the selected test plans.
Test Result- Outcome: The outcome of the test. The report uses this field to define the column labels and to filter the test results to include Passed, Failed, Blocked, or Never Run.
(Measure) Test - Point Count Trend: Counts the most recent version of each test result in a particular build. If a test is run multiple times against a build, the Point Count Trend counts the most recent result for that test using that build.
Test Result - Area Hierarchy: The set of test results to include in the report based on the area paths that are assigned to the test cases that were run.
Tests Cases That Have Never Run
The Tests Not Executed report indicates how many test cases have never run. The test cases are grouped by test configuration and test result owner. The following table describes the report filters and fields that are used in the PivotTable reports that generate the Test Status by Area report.
Filters
Fields
Team Project - Team Project Hierarchy: Includes test results that were collected for the selected team project.
Test Result - Iteration Hierarchy: Includes test results that were run from test cases that were assigned to the selected iterations.
Test Result - Area Hierarchy: Includes test results that were run from test cases that were assigned to the selected product areas.
Test Plan - Test Plan Name: Includes test results that were run from test cases that belong to the selected test plans.
Test Suite - Test Suite Hierarchy: Includes test results that were run from test cases that belong to the selected test suites.
Test Result- Outcome: Includes test results with the selected outcome. The report uses this field to filter the count of test cases to include only those with an outcome of Never Run.
(Measure) Test - Point Count Trend: Counts the most recent version of each test result in a particular build. If a test case is not included in the build, it is counted as "Never Run."
Test Configuration - Configuration Name: The name of the test configuration to list in the report.
Test Case- Title: The title of the test case.
Test Result - Owner: The name of the team member who ran the test.
Code Coverage
The Code Coverage report lists the lines of code that are covered, not covered, or only partially covered for each build and build assembly. You can use this report to determine which builds and assemblies have the lowest and highest code coverage. The following table describes the report filters and fields that are used in the PivotTables that generate the Code Coverage report.
Filters
Fields
Team Project - Team Project Hierarchy: Includes builds that are defined for the selected team project.
Build - Build Definition Name: Includes builds that are associated with the selected build definitions.
Build Coverage - Lines Covered: The number of lines that are covered in the selected build.
Build Coverage - Lines Not Covered: The number of lines that are not covered in the selected build.
Build Coverage - Lines Partially Covered: The number of lines that are partially covered in the selected build.
Note
If multiple runs are performed against a build, the build coverage reflects the combined coverage of the runs, taking into consideration that there might be overlap in the lines covered across the runs.
Build - Build Name: The name of the build. Each time that a build is run, it is assigned a name that contains the build definition name as its prefix.
Assembly - Assembly: The assembly name against which the coverage statistics were generated.
Required Activities for Monitoring Testing Gaps
For the Testing Gaps reports to be useful and accurate, the team must perform the activities that are described in the following table:
Run tests, and, for manual tests, mark the results of each validation step in the test case as passed or failed. For more information, see Running Tests.
User Story Status
User Story Status by Config
Define user stories, and link test cases to user stories. The recommended link type to use is Tested By.
(Optional) To support filtering, assign Iteration and Area paths to each test case. The Test Result - Iteration Hierarchy and Test Result - Area Hierarchy fields get their values from the Iteration and Area paths that are assigned to their corresponding test cases.
User Story Status
User Story Status by Config
Test Status by Area
Tests Not Executed
Code Coverage
Configure a build system. To use Team Foundation Build, you must set up a build system.
Create build definitions. You can create several build definitions and then run each of them to produce code for a different platform. Also, you can run each build for a different configuration.
Define tests to run automatically as part of the build. As part of the build definition, you can define tests to run as part of the build or to fail if the tests fail.
Although a team member can manually rate a build by using Build Explorer, this rating is not reflected in the Build Quality Indicators report. The build rating appears in the Build Summary report. For more information, see Rate the Quality of a Completed Build and Build Summary Report.
Updating and Customizing the Report
You can update the Testing Gaps report by opening it in Office Excel and changing the filter options for the PivotTable report for one of the worksheets. You can customize each report to support other views, as the following table describes.
Worksheet
View
Action
User Story Status
User Story Status by Config
Test Status by Area
Tests Not Executed
Testing gaps for an iteration
Change the filter for Iteration (default=All)
User Story Status
User Story Status by Config
Test Status by Area
Tests Not Executed
Testing gaps for a product area
Change the filter for Area (default=All)
User Story Status
User Story Status by Config
Test Status by Area
Tests Not Executed
Testing gaps for a specific test plan or set of test plans
Change the filter for Test Plan (default=All)
User Story Status by Config
Tests Not Executed
Testing gaps for a specific test suite
Change the filter for Test Suite Hierarchy (default=All)
Code Coverage
Code coverage for a specific build definition or set of build definitions
Change the filter for Build Definition Name (default=All)
User Story Status
User Story Status by Config
Test Status by Area
Tests Not Executed
Code Coverage
Testing gaps or code coverage that includes data from the most recent six, eight, or more weeks
In the Columns PivotTable Field List, add the Date - Sets field, and specify @@Last 6 weeks@@ or other set
For more information about how to work with and customize PivotTable and PivotChart reports, see the following pages on the Microsoft Web site:
.png "User Story Test Status Excel Report")