ProcessTemplate XML 元素引用

更新: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 文件中。 有关如何指定这些文件的更多信息,请参见定义用于处理插件的任务

返回页首

请参见

概念

使用过程模板文件

定义用于处理插件的任务

在插件文件中定义任务组和任务的依赖项

使用过程模板插件文件定义根任务

其他资源

自定义过程模板

修订记录

日期

修订记录

原因

2011 年 4 月

已添加信息(例如,所有 ProcessTemplate 子元素的语法)并已删除指向已删除主题的链接。

信息补充。