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

项目
03/12/2013

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

重要事项
仅当您在创建团队项目的过程中创建了 SharePoint 站点时，才能运行您在 SharePoint 产品插件中指定的任务。

主题内容

门户插件名称和位置
门户网站创建任务与依赖项
创建站点并指定站点模板
创建文档库
创建文档库的文件夹结构
指定要上载到文档库的文件
激活面板功能

门户插件名称和位置

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

文件名：	WssTasks.xml
文件夹名称：	Windows SharePoint Services
插件名称：	Microsoft.ProjectCreationWizard.Portal

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

返回页首

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

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

使用指定站点模板来创建站点
创建文档库
创建文件夹并将文件上载到文档库
激活面板功能

有关指定简单项目门户网站的任务示例，请参阅 MSF for Agile Software Development 过程模板中的 WssTasks.xml 文件。

有关站点要求和管理的更多信息，请参见 SharePoint Products and Team Foundation Server。

返回页首

创建站点并指定站点模板

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

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

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

下表描述 site 元素的特性。

特性	描述
Template — 模板	指定要使用的模板。必须为将要创建的团队项目指定在承载 SharePoint 产品的服务器上定义的模板。若要使用随 MSF 过程模板的最新版本提供的功能，请指定以下字符串之一： TFS2010 Agile Dashboard TFS2010 CMMI Dashboard
语言	指定区域设置 ID，以指示要使用的站点模板的语言版本。英文版为 1033。

Template — 模板

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

若要使用随 MSF 过程模板的最新版本提供的功能，请指定以下字符串之一：

TFS2010 Agile Dashboard
TFS2010 CMMI Dashboard

语言

指定区域设置 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="TFS2010 Agile Dashboard" language="1033" />  
       . . . 
        </Portal>

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

过程模板的性能

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

使用站点模板

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

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

使用备用网站

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

返回页首

创建文档库

创建项目门户网站之后，可以指定创建附加文档库。使用 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	将要向其中复制文件的文档库的名称。
目标	将要向其中复制文件的项目门户网站上的目标的相对路径。
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 library，可以访问每个定义的大多数项目的过程指南内容该默认值处理 Team Foundation Server 提供的模板。可以浏览该内容可用在从以下主题之一的 MSDN: Visual Studio scrum 2.0、MSF for agile 6.0和 MSF for CMMI 6.0。

若要支持访问处理从工作项窗体的指南。团队资源管理器，设置 .htm 文件上载到中的过程指南文件夹 SharePoint 文档库。这些文件指定 URL 打开的 MSDN 内容，当团队成员选择工作项窗体中的过程指南为工作项打开过程指南图标。这些文件上载根据"门户"插件中定义的 file 任务。例如，敏捷过程模板定义了以下 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 报表的创建功能。

激活旨在用于 MSF 过程模板（适用于敏捷软件开发）的面板功能：

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

激活旨在用于 MSF 过程模板（适用于 CMMI）的面板功能：

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

返回页首

请参见

概念

其他资源

Retrieve and Restore Missing Site Templates