报告过程模板插件

项目
08/18/2008

更新：2007 年 11 月

报告插件定义团队项目的初始报告。插件的名称为 Microsoft.ProjectCreationWizard.Reporting。报告 XML 文件的名称为 ReportsTasks.xml，并位于过程模板文件夹层次结构的 Reports 文件夹中。如果需要，可以更改 XML 文件和文件夹的名称。

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

说明：
Team Foundation Server 并不包括用于部署客户端插件、策略或其他修改的机制。如果您希望将插件、策略或其他修改部署到团队资源管理器，则必须使用您自己的分发和安装程序。

报告站点

要正确运行报告，必须创建一个报告站点。该报告站点将在标记为“报告”的项目门户主页上提供一个指向报告的链接。若要创建报告站点，请使用以下示例中显示的 site 元素。

<task 
   id="Site"
   plugin="Microsoft.ProjectCreationWizard.Reporting"
   completionMessage="Project Reporting site created.">
   <dependencies/>
   <taskXml>
      <ReportingServices>
         <site />
      </ReportingServices>
   </taskXml>
</task>

文件夹

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

<folder path=""/>

下面的示例在报告站点上创建一个 Public 文件夹。

   <task id="Populate Reports"
          plugin="Microsoft.ProjectCreationWizard.Reporting"
          completionMessage="Project site created.">
        <dependencies>
            <dependency taskId="Site"/>
        </dependencies>
        <taskXml>
            <ReportingServices>
         <folders>
            <folder path="Public"/>
         </folders>
      </ReportingServices>
   </taskXml>
</task>

报告

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

<report name=""
        filename=""
        folder=""
        cacheExpiration ="30">

下表介绍 report 元素的属性。

属性	说明
name	要在报告站点上和团队资源管理器中显示的报告的名称。
filename	从本地 Reports 文件夹下获取 .rdl 报告文件的相对路径。
folder	将报告添加到报告站点上的位置的相对路径名。
cacheExpiration	设置缓存报告的默认分钟数。

可以在报告中指定参数的值。这通常用于将 Project 元素映射到当前团队项目。如果不引用当前团队项目，大部分报告都无法正确运行。若要将 Project 参数映射到当前团队项目，请将该值指定为 $$PROJECTNAME$$。

<parameters>
   <parameter name="" value=""/>
</parameters>

下表介绍 property 元素的属性。

属性	说明
name	报告中要绑定的参数的名称。
value	要将该参数绑定到的值。

必须将每个报告中的每个数据源名称都映射到实时 Team Foundation Server 数据源。使用 reference 元素指定数据源。

<datasources>
   <reference name="" dsname=""/> 
</datasources>

下表介绍 reference 元素的属性。

属性	说明
name	报告中数据源的名称。
dsname	Team Foundation Server 数据源的名称。通常，此值为 TfsReportDS 或 TfsOlapReportDS。

下面的示例说明如何添加工作项报告。Project 参数将绑定到当前团队项目，而报告将绑定到 TfsReportDS 数据源。

<report name="Work Items" 
        filename="Reports\Work Items.rdl" 
        folder="" 
        cacheExpiration ="30">
   <parameters>
      <parameter name="Project" value="$$PROJECTNAME$$"/>
   </parameters>
   <datasources>
      <reference name="/TfsOlapReportDS" dsname="TfsOlapReportDS"/> 
      <reference name="/TfsReportDS" dsname="TfsReportDS"/>
   </datasources>
</report>

请参见

通过

报告过程模板插件

报告站点

文件夹

报告

请参见

任务

概念

其他资源

其他资源