如何在TFS的过程模板中添加报表

在新建团队项目的过程中，TFS的“新建团队项目向导”会根据用户选择的过程模板类型（CMMI, Scrum，Agile等）自动为团队项目创建一个SSRS（SQL Server Reporting Service）报表站点。在大多数情况下，这些开箱即用的报表可以满足用户的基本需求。但是也有许多企业会根据自己的管理流程特点，开发和定制许多报表。用户可以在创建团队项目以后，手动将这些定制的报表发布到每个团队项目中。但是如果团队项目比较多，每次手动发布报表就比较耗时耗力，还容易出现错误。实际上TFS的过程模板支持自定义的报表，只需要通过修改过程模板，并将自己新建的报表包含在过程模板中，在新建团队项目的时，系统会自动将这些报表发布到TFS的报表站点中。下面我就来介绍如何修改过程模板，实现自定义报表的自动化部署。

过程模板结构

首先将现有的过程模板下载到本地，这里以CMMI过程模板为列。

建流程模板的所有文件添加到一个空的项目中（如下图），这样可以方便的通过Visual Studio来修改流程模板文件。

通过分析，我们发现TFS的报表文件保存在一个叫做Reports的文件夹中，其中所有的.rdl文件是报表文件，ReportsTasks.xml文件是在创建团队项目过程中，TFS执行的任务文件，用来自动创建报表站点和报表。

增加报表文件(.rdl)

将我们自定义的报表复制到Reports目录中即可。这里，用于测试，我把自己自定义开发的一个用于统计团队项目任务的报表复制到Reports目录中。

修改报表任务

在Visual Studio中打开报表任务的文件ReportsTask.xml：

1. 需要增加新的报表节点:reports，最简单的方法就是复制之前已经存在的节点。但是需要注意，如果你的报表中不需要参数ExplicitProject，应该将这个节点删除（我的示例报表就不需要这个参数）。

2. 需要指定报表的目录，如果打算放在报表站点的根目录中，保持folder属性的值为空就可以。

3. 需要指定数据源datasources，name是指报表系统中的已经存在的数据源，dsname是指报表中的数据源名称。

更新流程模板，并新建团队项目

通过团队资源管理器上传流程模板，以更新模板（如下图）。更新流程模板以后，可以使用新建的模板创建一个团队项目。在创建团队项目的过程中，如果所必须的配置没有完成，可能会出现错误，这时可以通过错误详细信息排查问题。

验证新增报表

团队项目创建成功以后，在报表站点中会看到自己定制的报表（如下图1），这是你就可以验证自己的报表了（如图2）

图1

图2

常见问题

1. 报表文件的XML版本不正确

在创建团队项目的过程中提示下面的错误，原因是使用Visual Studio 2015编辑或者开发报表，报表文件的Schemal自动被修改成了2016，而TFS 2013不支持这种格式。

异常消息:  System.Web.Services.Protocols.SoapException: 此报表的定义无效或不受此版本的 Reporting Services 支持。该报表定义可能是使用以前版本的 Reporting Services 创建的，或包含格式不符合 Reporting Services 架构或无效的内容。

2. 必须的数据源不存在

需要在创建团队项目前，将报表的数据源创建好，并配置好数据库连接。