Windows SharePoint Services 过程模板插件

项目
08/18/2008

更新：2007 年 11 月

Windows SharePoint Services 插件基于 SharePoint 站点模板定义团队的项目门户。插件的名称为 Microsoft.ProjectCreationWizard.Portal。Windows SharePoint Services XML 文件的名称为 WssTasks.xml，并位于过程模板文件夹层次结构中的 Windows SharePoint Services 文件夹中。如果需要，可以更改 XML 文件和文件夹的名称。

在 XML 文件中，指定一个或多个任务以及它们的依赖项。需要指定三个关键任务：要使用哪个站点模板、要创建哪些文档库，以及要将哪些文件夹和文件复制到文档库。有关指定简单项目门户的任务示例，请参阅 MSF for Agile Software Development 过程模板中的 WssTasks.xml 文件。

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

有关 Windows SharePoint Services 站点和 Windows SharePoint Services 管理的更多信息，请参见 Windows SharePoint Services Administrator's Guide（Windows SharePoint Services 管理员指南）。

站点模板

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

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

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

下表描述站点元素的属性。

属性	说明
template	指定要使用的模板。此模板是来自 SharePoint 服务器上的 webtemp.xml 文件中的模板名称和配置 ID 的组合。
language	指定区域设置 ID，以指示要使用的站点模板的语言版本。英文版为 1033。

以下示例演示如何引用英文版的 VSTS_MSFAgile 模板。

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

说明：
所有其他 Windows SharePoint Services 任务都依赖于此任务，因为在您创建附加文档库或复制文件之前，必须创建项目门户。

创建自定义站点模板

您可以创建自定义 SharePoint 站点模板，以便与过程模板一起使用。SharePoint 站点模板是使用 SharePoint 站点上的管理功能创建的。有关如何创建 SharePoint 站点模板的更多信息，请参阅 Microsoft Windows SharePoint Services 2.0 的帮助文件。

创建自定义 SharePoint 站点模板之后，必须将其添加到任何需要使用该模板的 Team Foundation Server 上。首先将自定义站点模板保存为 .stp 文件。有关保存站点模板的更多信息，请参见 Microsoft Windows SharePoint Services 2.0 的帮助文件。

可以使用 SharePoint 站点来添加自定义站点模板，也可以使用命令提示来添加自定义站点模板。以下步骤说明如何将自定义站点模板添加到 Team Foundation Server。

将自定义站点模板添加到 Team Foundation Server

在 Team Foundation Server 中，打开命令提示窗口。
在命令提示符下，转到 \Program Files\Common Files\Microsoft Shared\web server extensions\12\bin 目录。
键入以下命令，将自定义站点模板添加到 Team Foundation Server。

stsadm -o addtemplate -filename <custom site template filename>.stp -title <site template title>
键入 iisreset，然后按 Enter。必须重新启动 IIS 才能使用添加的站点模板。

将自定义站点模板上载到 Team Foundation Server 之后，过程模板可以使用它们来创建团队项目。以下步骤说明如何修改过程模板 XML 以使用自定义站点模板。

将自定义站点模板添加到过程模板

在 Team Foundation Server 中，打开命令提示窗口。
在命令提示符下，转到 \Program Files\Common Files\Microsoft Shared\web server extensions\12\bin 目录。
键入 stsadm -o enumtemplates，然后按 Enter。将列出可用的站点模板。需要此信息来构建相应的过程模板 XML。

例如，如果添加了一个名为 ExCustom 的站点模板，您将看到以下输出。

ExCustom - Language: 1033 - Site Template: _GLOBAL_#1 - Template Id: 1

说明：

根据服务器上站点模板的多少，模板 ID 可能会不同。
在 Visual Studio 中，在“团队”菜单上，指向“Team Foundation Server 设置”，然后单击“过程模板管理器”。
使用“过程模板管理器”下载要修改的过程模板。

有关下载过程模板的更多信息，请参见如何：下载过程模板。
在过程模板中，编辑 WSSTasks.xml。

查找相应的站点元素，并更改模板属性以匹配您在步骤 3 中检索到的站点模板名称。下面的 XML 演示 ExCustom 示例模板的站点元素的示例。
```
<site template="_GLOBAL_#1" language="1033"/>
```
上载已更新的过程模板。

有关上载过程模板的更多信息，请参见如何：上载过程模板。

说明：

已更新的过程模板不得在任何文件夹中包含 .exe 文件，否则，即使已更新的过程模板上载成功，项目创建也会失败。

说明：
根据服务器上站点模板的多少，模板 ID 可能会不同。

说明：
已更新的过程模板不得在任何文件夹中包含 .exe 文件，否则，即使已更新的过程模板上载成功，项目创建也会失败。

现在可以使用“新建团队项目向导”从自定义过程模板创建新的团队项目。新的团队项目将自定义站点模板用于它们的项目门户。

文档库

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

<documentLibraries>
   <documentLibrary name="" description=""/>
</documentLibraries>

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

下表描述 documentLibrary 元素的属性。

属性	说明
name	指定在项目门户上显示的文档库的名称。
description	提供在项目门户上显示的文档库的说明。

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

<documentLibraries>
   <documentLibrary name="Development" 
      description=" Documents for the development team "/>
</documentLibraries>

文件夹和文件

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

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

<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 和 .mpp 文件。

以下示例演示如何将名为 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 文件而 Windows SharePoint 站点不支持 .exe 文件，您将无法使用过程模板成功创建团队项目。

过程模板的性能

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

使用站点模板

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

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

使用备用网站

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

过程指南

过程指南文件是由 Windows SharePoint Services 插件安装的。所有过程指南文件都位于 Windows SharePoint Services\Process Guidance 文件夹下，并且必须为每个文件指定一个文件元素以确保将文件复制到项目门户。有关自定义过程指南的更多信息，请参见 MSF for Agile Software DevelopmentMSF for CMMI Process Improvement（MSF for Agile Software DevelopmentMSF for CMMI 过程改进）和 MSF for CMMI Process Improvement（MSF for CMMI 过程改进）。

请参见

任务

如何：验证 Windows SharePoint Services 更改

如何：下载过程模板

如何：上载过程模板

通过