通过

为过程模板定义项目门户网站插件

  • 项目

通过使用门户网站插件，您可以定义团队项目门户网站的初始文档库、库结构和文档。 您还可以包括创建面板和 Excel 报表的任务，这些面板和报表旨在与 Team Foundation Server (TFS) 过程模板配合使用。

仅当您在创建团队项目的过程中创建 SharePoint 站点时，才能运行您在 SharePoint 产品插件中指定的任务。 有关站点要求和管理的详细信息，请参见 Team Foundation Server 对 SharePoint 产品的要求。

门户网站插件名称和位置

下表概述了 TFS 过程模板的门户网站插件文件、文件夹和插件的名称。

文件名：

WssTasks.xml

文件夹名称：

Windows SharePoint Services

插件名称：

Microsoft.ProjectCreationWizard.Portal

备注

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

门户网站创建任务与依赖项

在门户网站插件文件中，指定一个或多个任务以及它们的依赖项。 请指定以下关键任务：

  • 使用指定站点模板来创建站点

  • 创建文档库

  • 创建文件夹并将文件上载到文档库

  • 激活面板功能

有关指定简单项目门户网站的任务示例，请参见某个 TFS 过程模板中的 WssTasks.xml 文件。 您可以从 TFS 下载最新的过程模板。

创建站点并指定站点模板

您必须指定项目门户网站所基于的站点模板， 而且必须在 Team Foundation Server SharePoint 门户网站上提供相应的站点模板。 过程模板中不包括站点模板。

请使用站点元素来指定站点模板。

<site template="" language=""/>

下表描述 site 元素的特性。

特性

描述

Template — 模板

指定要使用的模板。 必须为将要创建的团队项目指定在承载 SharePoint 产品的服务器上定义的模板。

若要使用 MSF 过程模板的当前版本提供的功能，请指定以下字符串：Team Foundation Server Project Portal。

语言

指定区域设置 ID，以指示要使用的站点模板的语言版本。 英文版为 1033。

以下示例演示如何引用最新版本的 MSF Agile 过程模板（英文版），该版本提供面板支持。

<tasks>
  <task id="SharePointPortal" name="Create Sharepoint Portal" plugin="Microsoft.ProjectCreationWizard.Portal" completionMessage="Project portal site created.">
    <dependencies />
    <taskXml>
        <Portal>
           <site template="Team Foundation Server Project Portal" language="1033" />  
       . . . 
        </Portal>

备注

门户网站插件中定义的所有其他任务都依赖于站点创建任务，因为在您创建附加文档库或复制文件之前，必须创建项目门户网站。

过程模板的性能

上载过程模板时，会将您在 WssTasks.xml 中指定的文件作为过程模板的一部分包括进来。 过程模板的大小会影响创建新的团队项目所需的时间。 较大的过程模板需要花费较长的时间来创建新的团队项目。 因此，当过程模板的性能降低时，应考虑实施替换策略来提供文件。

使用站点模板

可以将文件作为 SharePoint 站点模板的一部分包括进来。 这将使文件移出过程模板并移入到站点模板中，并提高创建新团队项目时的性能。

但是，在 WssTasks.xml 中列出文件有一个优点： 可以使用前面介绍的 queryid 特性将 Microsoft Project 和 Microsoft Excel 文件绑定到查询。 这可以在团队成员打开这些文件时提供帮助，因为这些文件已经连接到正确的 Team Foundation Server 和查询。

使用备用网站

如果您有大批文件需要在多个团队项目之间共享，则可以使用备用网站承载这些文件，并在项目门户网站或网页上建立与这些文件的链接。 此策略还可以提高创建团队项目时的性能，因为这样做无需将文件复制到项目门户网站。 有关详细信息，请参阅配置或添加项目门户网站。

创建文档库

创建项目门户网站之后，可以指定创建附加文档库。 使用 documentLibrary 元素来指定文档库。

<documentLibraries>
   <documentLibrary name="" description="" isProcessGuidance="true | false" />
</documentLibraries>

备注

不能在过程模板中启用或禁用文档库的版本管理。可以通过 Windows SharePoint Services 站点模板启用或禁用版本管理，也在创建项目之后启用或禁用版本管理。

下表描述 documentLibrary 元素的特性。

特性

描述

name

指定在项目门户网站上显示的文档库的名称。

description

提供在项目门户网站上显示的文档库的说明。

isProcessGuidance

指定是否使用文档库支持过程指南内容。

下面的示例演示如何创建一个名为 Development 的文档库，开发团队可使用该文档库存储文档。

<documentLibraries>
. . .
   <documentLibrary name="Process Guidance" description="How to make best use of the Team Foundation Server tools and process" isProcessGuidance="true" />
. . .
</documentLibraries>

创建文档库的文件夹结构

创建项目门户网站之后，可以指定要创建的附加文件夹。 也可以指定要复制的文件，例如模板文件。

使用 folder 元素来创建新的文件夹。

<folders>
   <folder documentLibrary="" name=""/>
</folders>

下表描述文件夹元素的特性。

特性

描述

documentLibrary

标识要在其中创建文件夹的文档库。

name

指定文件夹的名称。

下面的示例演示如何在 Development 文档库中创建一个名为 Trip Reports 的文件夹，开发人员可以在该文件夹中存储有关参加会议或访问客户的差旅报告。

<folders>
   <folder documentLibrary="Development"
           name="Trip Reports"/>
</folders>

指定要上载到文档库的文件

您还必须将文件复制到文档库和文件夹中。 源文件位于 Windows SharePoint Services 文件夹中。 必须在项目门户网站上指定一个目标。

<files>
   <file source="" documentLibrary="" target="" queryId="" /> 
</files>

下表描述文件元素的特性。

特性

描述

source

文件的本地副本的相对路径。 通常，源路径名称总是以 Windows SharePoint Services 开头，该名称是定义门户网站插件所在的文件夹的名称。

documentLibrary

将要向其中复制文件的文档库的名称。

target

将要向其中复制文件的项目门户网站上的目标的相对路径。

queryId

指定要绑定到文件的工作项查询的名称。 第一次打开文件时，将使用运行查询的结果来填充文件。 此特性是可选的，且指定的查询必须存在于 workitems.xml 文件中。

备注

queryId 仅应用于 .xls 文件。

以下示例演示如何将名为 Project Checklist 的模板文件复制到 Project Management 文件夹中。 此示例还指定当第一次打开文件时，应使用 Project Checklist 工作项查询的结果来填充文件。

<files>
   <file source="Windows SharePoint Services\Templates\Project Checklist.xls" 
      documentLibrary="Project Management" 
      target="Project Checklist.xls" 
      queryId="Project Checklist" />
</files>

备注

您可以将文件夹和文件作为站点模板的一部分包括进来，不需要在 XML 中列出它们。

备注

如果指定 .exe 文件而 SharePoint 站点不支持 .exe 文件，您将无法使用过程模板成功创建团队项目。

过程指南内容和支持文件

过程指南是记录过程的内容，处理软件项目的团队成员应遵循这些过程。 工作项、报表和查询都可在团队项目生命周期中更改，并且在不同团队项目中可能不同。 过程指南内容提供关于团队项目的详细信息，例如有关如何完成工作项字段、正常和不正常报表示例以及查询说明等信息。 过程指南还提供有关要在团队项目中遵循的过程的详细信息，例如要担当的角色和要完成的活动。

通过 MSDN 库，你可以访问由每个默认 TFS 过程模板定义的大多数项目的过程指南内容。 可从下列主题之一浏览 MSDN 上提供的内容：Visual Studio Scrum、MSF for Agile 和 MSF for CMMI。

若要支持从团队资源管理器中的工作项窗体访问过程指南，可将一组 .htm 文件上载到 SharePoint 文档库中的“过程指南”文件夹中。 这些文件指定 MSDN 内容的 URL，当团队成员选择工作项窗体中的过程指南 为工作项打开过程指南 图标时，将打开这些内容。 这些文件基于门户网站插件中定义的 file 任务上载。 例如，Agile 过程模板定义以下 file 任务：

<!-- Process Guidance -->
          <file source="Windows SharePoint Services\Process Guidance\ProcessGuidance.html" documentLibrary="Process Guidance" target="ProcessGuidance.html" />
          <file source="Windows SharePoint Services\Process Guidance\ProcessGuidance.html" documentLibrary="Process Guidance" target="ProcessGuidance.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\AboutWorkItems.htm" documentLibrary="Process Guidance" target="Supporting Files/AboutWorkItems.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\AboutWorkItems.htm" documentLibrary="Process Guidance" target="Supporting Files/AboutWorkItems.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Bug.htm" documentLibrary="Process Guidance" target="Supporting Files/Bug.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Bug.htm" documentLibrary="Process Guidance" target="Supporting Files/Bug.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Issue.htm" documentLibrary="Process Guidance" target="Supporting Files/Issue.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Issue.htm" documentLibrary="Process Guidance" target="Supporting Files/Issue.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\ProcessGuidance.html" documentLibrary="Process Guidance" target="Supporting Files/ProcessGuidance.htm" />
          <file source="Windows SharePoint Services\Process Guidance\ProcessGuidance.html" documentLibrary="Process Guidance" target="Supporting Files/ProcessGuidance.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\SharedSteps.htm" documentLibrary="Process Guidance" target="Supporting Files/Shared Steps.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\SharedSteps.htm" documentLibrary="Process Guidance" target="Supporting Files/Shared Steps.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Task.htm" documentLibrary="Process Guidance" target="Supporting Files/Task.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Task.htm" documentLibrary="Process Guidance" target="Supporting Files/Task.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\TestCase.htm" documentLibrary="Process Guidance" target="Supporting Files/Test Case.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\TestCase.htm" documentLibrary="Process Guidance" target="Supporting Files/Test Case.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\UserStory.htm" documentLibrary="Process Guidance" target="Supporting Files/User Story.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\UserStory.htm" documentLibrary="Process Guidance" target="Supporting Files/User Story.aspx" />

可以对这些文件进行自定义，使其指向过程指南的其他资源。 还可以添加文件，以便支持访问您为团队创建的其他过程指南。 有关详细信息，请参阅配置或添加项目门户网站。

激活面板功能

面板显示项目数据、支持调查，并帮助团队快速执行常见任务。 面板可显示多个 Excel 报表和 Team Web Access Web 部件。

应使用 activateFeatures 元素来创建面板和 Excel 报表。 必须在门户网站插件文件的 Portal 元素中包括以下代码，以便为团队项目激活对面板和 Excel 报表的创建功能。

激活旨在用于 Visual Studio Scrum 的过程模板的面板功能：

      <Portal>
    . . . 
<activateFeatures>
         <!-- TfsDashboardScrumWss -->
          <feature featureId="71EC0D67-21AB-4560-A825-9D976DA09D04" />
          <!-- TfsDashboardAgileQuickLaunch -->
          <feature featureId="1D363A6D-D9BA-4498-AD1A-9874ACA5F827" />
        </activateFeatures>
    . . . 
      </Portal>

激活旨在与 MSF for CMMI Process Improvement 过程模板一起使用的面板功能：

      <Portal>
    . . . 
        <activateFeatures>
          <!-- TfsDashboardAgileMoss -->
          <feature featureId="0D953EE4-B77D-485b-A43C-F5FBB9367207" />
          <!-- TfsDashboardAgileQuickLaunch -->
          <feature featureId="1D363A6D-D9BA-4498-AD1A-9874ACA5F827" />
        </activateFeatures>
    . . . 
      </Portal>

激活旨在与 MSF for CMMI Process Improvement 过程模板一起使用的面板功能：

      <Portal>
    . . . 
<activateFeatures>
          <!-- TfsDashboardCmmiMoss -->
          <feature featureId="3D0BA288-BF8E-47F0-9680-7556EDEF6318" />
          <!-- TfsDashboardCmmiProcessDocLibraries -->
          <feature featureId="8610B95B-063F-4FB5-837C-BCF2FE9423C6" />
        </activateFeatures>
    . . . 
      </Portal>

请参见

概念

自定义过程模板

过程模板文件概述