向过程模板添加报告

项目
06/09/2015

通过使用“报表”插件，可以指定出现在新团队项目的 **“报表”**节点下的文件夹结构和报表集合。

重要

“报表”插件要求从中创建团队项目的团队项目集合已配置了 SQL Server Analysis Services 和 SQL Server Reporting Services。有关详细信息，请参阅向团队项目中添加报表。

通过使用“报表”插件来指定两项主要任务。首先，通过使用 site 元素创建报告站点。其次，通过使用 folder 元素和 report 元素指定要上载到网站的文件夹结构和报表。你上载的报表的扩展名为 .rdl，它们专用于 Reporting Services。有关 TFS 过程模板提供的报表的概述，请参见报告 (SQL Server Reporting Services)。

从过程模板创建团队项目后，你可以添加、删除、重命名和更改报表的文件夹结构。有关详细信息，请参阅查看、上载和组织报表（Reporting Services 报表）。

报告插件名称和位置

下表总结了 MSF 过程模板的文件名、文件夹名称和插件名称。

文件名：	ReportsTasks.xml
文件夹名称：	报表
插件名称：	Microsoft.ProjectCreationWizard.Reporting

备注

可以更改 XML 文件和文件夹的名称，但不能更改插件名称。Visual Studio Team Foundation Server 并不包括用于部署客户端插件、策略或其他修改的机制。如果你希望部署此类功能，则必须使用你自己的分发和安装程序。

在 XML 文件中，指定一个或多个任务以及它们的依赖项。有关指定一组报表的任务的示例，请参见 MSF for Agile Software Development 过程模板中的 ReportsTasks.xml 文件。

报告插件语法结构

“报表”插件文件必须符合 Rosetta.xsd 文件中定义的 ReportingServices 架构定义，并且在自己的文件中指定。

下面的语法演示了“报表”插件的结构。有关每个元素的说明，请参见本主题后面的 ReportingServices 子元素。

<?xml version="1.0" encoding="utf-8"?>
<tasks>
  <task id="Site" plugin="Microsoft.ProjectCreationWizard.Reporting" completionMessage="Project Reporting site created.">
    <dependencies />
    <taskXml>
      <ReportingServices>
        <site> </site>
      </ReportingServices>
    </taskXml>
  </task>
  <task id="Populate Reports" plugin="Microsoft.ProjectCreationWizard.Reporting" completionMessage="Project reports uploaded.">
    <dependencies>
      <dependency taskId="Site" />
    </dependencies>
    <taskXml>
      <ReportingServices>
        <folders> . . . </folders>
        <reports> . . . </reports>
      </ReportingServices>
    </taskXml>
  </task>
</tasks>

创建报告站点

要正确运行报表，必须创建一个报告站点。该报告站点在项目门户网站主页上具有一个指向自身的链接，该链接标记为 “报表”。若要创建报告站点，请使用 site 元素，如以下示例所示：

<taskXml>
   <ReportingServices>
        <site></site>
   </ReportingServices>
</taskXml>

定义文件夹

可以使用 folder 元素在报告站点上创建文件夹。使用 path 特性指定新文件夹的相对路径名称。新建的文件夹显示在项目站点上和团队资源管理器中的 Reports 文件夹下。

下面的示例在报告站点上创建四个顶级文件夹和两个子文件夹。顶级文件夹分别标记为“Bugs”、“Builds”、“Project Management”和“Tests”。两个子文件夹位于“Project Management”下，且分别标记为“Visual Studio”和“Visual Studio ALM”。

<taskXml>
   <ReportingServices>
      <folders>
         <folder path="Bugs" />
          <folder path="Builds" />
          <folder path="Project Management" />
          <folder path="Project Management/Visual Studio" />
          <folder path="Project Management/Visual Studio ALM" />
          <folder path="Tests" />
      </folders>
   </ReportingServices>
</taskXml>

指定要上载的报表

报表由 .rdl 文件定义。若要向报告站点添加报表，请将 .rdl 报表文件复制到过程模板中的 Reports 文件夹下的某个文件夹中。然后使用 report 元素描述用于报表的必要属性和数据源。

下面的示例指定将 Remaining Work.rdl 文件上载到 Project Management 文件夹。你必须为每个报表指定 ExplicitProject 参数和数据源。以下示例中的数据源对应于自动分配给 Analysis Services 多维数据集和数据仓库关系数据库的名称。

备注

Reporting Services 数据源的名称为 Tfs2010ReportsDS 和 Tfs2010OlapReportsDS。即使你可能已安装或已升级到 TFS 2012 或 TFS 2013，仍将继续使用分配给数据源用于 TFS 2010 安装的名称。

<taskXml>
   <ReportingServices>
     <reports>
        <report name="Remaining Work" filename="Reports\Remaining Work.rdl" folder="Project Management" cacheExpiration="30">
       <parameters>
          <parameter name="ExplicitProject" value="" />
       </parameters>
       <datasources>
          <reference name="/Tfs2010OlapReportDS" dsname="TfsOlapReportDS" />
          <reference name="/Tfs2010ReportDS" dsname="TfsReportDS" />
       </datasources>
    </report>
 . . . 
     </reports>
   </ReportingServices>
</taskXml>

ReportingServices 元素参考

下面的语法演示了 ReportingServices 元素及其子元素的结构。在 taskXml 容器元素中指定这些元素，并且只为“报表”插件指定这些元素。

<ReportingServices>
   <folders>
      <folder />
 . . . 
   </folders>
   <reports>
      <report>
         <parameters>
            <parameter />
         </parameters>
         <datasources>
            <reference />
         </datasources>
      </report>
 . . . 
   </reports>
</ReportingServices>

下表介绍了一些元素，这些元素用于指定要上载到团队项目的报表，可通过 SQL Server Reporting Services 访问这些元素。

元素	语法	描述
datasources	`<datasources> <reference /> </datasources>`	report 的必需子元素。包含 reference 元素的集合，每个元素指定报表使用的一个数据源。
folder	`<folder path="FolderName" />`	folders 的必需子元素。定义要在团队项目的“报表”节点下创建的文件夹的名称。
folders	`<folders> <folder path="FolderName" /> </folders>`	ReportingServices 的可选子元素。包含 folder 元素的集合，每个元素指定要创建的文件夹的名称。
parameter	`<parameter name="ParameterName" value="ParameterValue" />` 其中，每个特性具有以下定义： name：要指定的参数的名称。 value：要分配给参数的值。你必须至少定义以下参数，以使你的报表自动使用包含你的报表项目： `<parameter name="ExplicitProject" value="" />`	parameters 的必需子元素。指定报表参数的名称以及分配给该参数的值。
parameters	`<parameters> <parameter /> </parameters>`	report 的必需子元素。定义报表的 parameter 元素集合。
properties	`< properties > < property /> </ properties >`	report 的可选子元素。
property	`<property name="PropertyName" value="PropertyValue" />` 其中，每个特性具有以下定义： name：要指定的属性的名称。有关详细信息，请参阅使用报表管理器查看、组织和配置报表。 value：要分配给属性的值。	properties 的必需子元素。
reference	`<reference name="RelationalDBName" dsname="OLAPDBName" />` 其中，每个特性具有以下定义： name：Team Foundation Server 中的数据源的名称。在 Team Foundation Server 2010 中，此值为 Tfs2010OlapReportDS（对于 Analysis Services 多维数据集）或 Tfs2010ReportsDS（对于关系数据仓库）。 dsname：数据库资源的名称。为 Analysis Services 多维数据集指定 TfsOlapReportDS，为关系数据仓库指定 TfsReportsDS。有关报表数据源的名称的更多信息，请参见升级到 Team Foundation Server 2010 后定位报表。	datasources 的必需子元素。为数据仓库关系数据库和 Analysis Services 多维数据集指定在 Team Foundation Server 中分配的名称。
report	`<report name="ReportName" filename="ReportFilePathName" folder="FolderName" cacheExpiration="CacheDuration"> <folders> <parameters>. . .</parameters> <datasources>. . .</datasources> <properties>. . .</properties > </report>` 其中，每个特性具有以下定义： name：要在报告站点上和团队资源管理器中显示的报表的名称。 filename：从本地 Reports 文件夹下获取 .rdl 报表文件的相对路径。 folder：将报表添加到报告站点上的位置的相对路径名。 cacheExpiration：缓存报表的默认分钟数。	reports 的必需子元素。指定报表的名称、包含 .rdl 定义的文件以及将报表上载到的文件夹。 Team Foundation Server
reports	`<reports> <report /> . . . </reports>`	ReportingServices 的必需子元素。包含 report 元素的集合，每个元素指定要上载的报表文件的名称。
ReportingServices	`<ReportingServices> <folders>. . .</folders> <reports>. . .</reports> </ReportingServices>`	“报表”插件的 taskXml 元素的必需子元素。介绍定义 SQL Server Reporting Services 的报表和文件夹所需的任务。
site	`<site> </site>`	“报表”插件的必需元素。指定将创建团队项目的报告站点。

请参见

概念

自定义过程模板

过程模板文件概述