Creating new TFS reports

Is the TFS Database(s) schema documented and how do I create new reports?


The seven TFS databases created by Team foundation Server should not be used directly for reporting but rather the TFS Data Warehouse is created for this purpose. Team Foundation Server includes a data warehouse where data from work item tracking, source control, builds, testing tools, and third-party tools (if any) are stored. This data is used by Team Foundation for its built-in reporting functionality. The warehouse includes both a relational and an OLAP database.

The relational database is organized in an approximate star schema, and the OLAP database is a data cube derived from the relational database. Each Team Foundation tool contributes one or more facts to the data warehouse. Each type of fact has a primary relational table and a cube in the OLAP database that draws from that table. Each fact is composed of dimensions, measures, and details. Dimensions are properties that are used to slice the data in a report. For example the Work Item facts include Type and State dimensions. Dimensions are realized in the relational database as tables, with foreign key references to the dimension tables from the primary fact table. Measures are properties that are aggregated (counted, added, and so on) to provide the quantitative values in reports. The Code Churn cube provided by the source control tool, for example, includes Lines Added, Lines Deleted, and Lines Modified measures. Measures are columns in the primary fact table. Details are columns that appear in the relational database only. They are generally longer text strings like work item titles that are primarily used in list reports that can be drawn as efficiently from a relational database as it can from an OLAP database. Details are columns in the primary fact table that do not appear in the OLAP cube. All the facts have a project dimension that can be used to slice the data in the warehouse by team project. 

To create a new report open Visual Studio 2005 and create a new “Business Intelligence” project of type “Report Server Project Wizard” In the wizard change the data source type to “Microsoft SQL Server Analysis Services”.   Choose edit on the connection string and type the name of your TFS Server, under the databases drop down you should see “TFSWarehouse” selecting this will now enable to see all the measures and dimensions to create custom reports.

TFS Reporting features

Data Warehouse Architecture:

Understanding the Cube

Relational schema ref.:     

Fact tables:                   

Dimension tables:                  


OLAP design:                    

Data warehouse admin:     

Customizing work item types

Work item type schema ref

Additional Reports

Directions for modifying reports

Building Reports in Excel

Comments (2)

  1. Charles Sterling has a great post up on creating new TFS Reports. What’s nice about the post is…

  2. The Visual Studio Team System User Education blog on Ne w help topic on configuring team foundation build…

Skip to main content