ProcessTemplate XML 元素引用

项目
08/12/2011

更新：2011 年 4 月

可以自定义过程模板的根文件以添加或删除插件文件。根文件将定义所有插件以及“新建团队项目向导”将处理的所有任务。对于 Microsoft Solutions Framework (MSF) 过程模板，根文件名为 ProcessTemplate 且位于过程模板文件的容器文件夹中。有关更多信息，请参见使用过程模板文件。

根插件文件的父元素是 ProcessTemplate 元素，该元素只能定义一个 metadata 元素和一个 groups 元素。您必须为团队项目集合中的每个过程模板分配一个唯一名称，并且该名称的长度不能超过 124 个 Unicode 字符。

警告

如果上载与现有模板名称相同的模板，则将覆盖现有模板。

主题内容

ProcessTemplate 语法结构
Metadata 元素参考
Groups 元素参考

ProcessTemplate 语法结构

过程模板的根插件必须在其自己的文件中的 ProcessTemplate 容器元素中指定，并且必须遵循 ProcessTemplate.xsd 和 ProcessTemplateItem.xsd 文件中定义的过程模板架构。您可以从 Microsoft 网站上的以下页面下载过程模板的架构文件：Process Template and Work Item Schemas for Visual Studio Team Foundation（Visual Studio Team Foundation 的过程模板和工作项架构）。

下面的示例演示了根 ProcessTemplate 元素的结构。有关更丰富的示例，请参见使用过程模板插件文件定义根任务。

<?xml version="1.0" encoding="utf-8"?>
<ProcessTemplate>
   <metadata> . . . </metadata>
   <groups> . . .</groups>
</ProcessTemplate>

返回页首

Metadata 元素参考

下面的语法演示了 metadata 元素及其子元素的结构。

<metadata>
    <name>ProcessTemplateName</name>
    <description>ProcessTemplateDescription </description>
    <plugins>
      <plugin name="Microsoft.ProjectCreationWizard.pluginID" wizardPage="true | false" />
. . .
    </plugins>
</metadata>

元素	语法	说明
description	`<description>ProcessTemplateDescription</description>`	metadata 的必需子元素。为过程模板定义在“新建团队项目向导”中显示的说明的文本。
metadata	`<metadata> <name> . . . </name> <description> . . . </description> <plugins> . . . </plugins> </metadata>`	ProcessTemplate 的必需子元素。要由“新建团队项目向导”处理的用于指定插件的所需信息的容器元素。
name	`<name>ProcessTemplateName</name>`	metadata 的必需子元素。定义过程模板的名称，该名称在团队项目集合中必须是唯一的。该名称的最大长度为 124 个字符。
plugin	`<plugin name="Microsoft.ProjectCreationWizard.PluginName wizardPage="true \| false" />`	plugins 的必需子元素。指定要在过程模板创建中包含的插件文件的名称，并指定“新建团队项目向导”中是否为该插件显示一个页面。
plugins	`<plugins> <plugin> . . . </plugin> </plugins>`	metadata 的必需子元素。定义过程模板的插件的容器元素。

返回页首

Groups 元素参考

下面的语法演示了 groups 元素及其子元素的结构。

<groups>
   <group id="groupId" description="GroupDescription" completionMessage="SuccessMessage">
      <dependencies> 
         <dependency groupId="dependentGroupId" />
. . .
      </dependencies>
      <taskList filename="RelativePathAndFileName" />
   </group>
. . .
</groups>

元素	语法	说明
dependencies	`<dependencies> <dependency>. . . </dependency> </dependencies>`	group 的必需子元素。指定该组对其他组的依赖项。
dependency	`<dependency groupId="groupId" />`	dependencies 的可选子元素。指定该组依赖的其他任务组的 ID。该组只有在其他组完成其任务后才能启动。
group	`<group id="TaskGroupId" description="TaskGroupDescription" completionMessage="SuccessMessage" failureMessage="FailureMessage"> <dependencies> . . . <dependencies> <taskList> . . . </taskList> </group>`	groups 的必需子元素。标识用于使插件在项目创建期间运行的一系列任务。以下值对每个特性均有效： id：指定标识任务组的名称。如果其他任务组依赖该组，则它将引用此 ID。您必须为插件文件中的 ID 分配一个唯一值。 description：指定在创建团队项目期间用于指示正在处理任务组的消息。 completionMessage：指定在创建团队项目期间用于指示已成功完成任务组的消息。最大长度为 256 个字符。 failureMessage：指定在创建团队项目期间用于指示未成功完成任务组的消息。
groups	`<groups> <group> . . . </group> </groups>`	ProcessTemplate 的必需子元素。定义在创建项目期间将运行的任务组集合的容器元素。
tasklist	`<taskList filename="filePath" />`	指定包含要运行的任务的列表的 XML 文件。一个组的任务列表必须总是放置在一个单独的 XML 文件中。有关如何指定这些文件的更多信息，请参见定义用于处理插件的任务。