通过

过程模板 XML 元素引用

你可以自定义过程模板的根文件，以便添加或删除插件文件。 根文件定义所有用于在 Visual Studio Online 或本地 Team Foundation Server 中创建团队项目的插件和任务。 名为 ProcessTemplate 的根文件位于过程模板文件的容器文件夹内。 有关详细信息，请参阅过程模板文件概述。

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

备注

对于 Visual Studio Online：如果将具有相同名称和 GUID 的过程模板作为现有的进程导入，则现有进程将与引用该进程的所有团队项目一起更新。

对于本地 TFS：如果上载具有相同名称的过程模板作为现有模板，则将覆盖现有模板。

主题内容

  • ProcessTemplate 语法结构

  • 元数据元素引用

  • 组元素参考

ProcessTemplate 语法结构

过程模板的根插件必须在 ProcessTemplate 容器元素中其自己的文件内指定，并且符合过程模板的架构，该过程模版是在 ProcessTemplate.xsd 和 ProcessTemplateItem.xsd 文件中定义的。 你可从 Microsoft 网站上的以下页面中下载过程模板的架构文件：Visual Studio Team Foundation 的过程模板和工作项架构。

下面的示例演示根 ProcessTemplate 元素的结构。 更多扩展性示例，请参阅使用过程模板插件文件定义根任务。

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

元数据元素引用

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

<metadata>
    <name>ProcessTemplateName</name>
    <description>ProcessTemplateDescription </description>
    <version type="ID" major="Number1" minor="Number2" />
    <plugins>
      <plugin name="Microsoft.ProjectCreationWizard.pluginID" wizardPage="true | false" />
. . .
    </plugins>
</metadata>

元素

语法

说明

description

 
<description>ProcessTemplateDescription</description>

metadata 的必需子元素。

定义在过程模板的“新建团队项目向导”中显示的说明文本。

metadata

 
<metadata>
    <name> . . . </name>
    <description> . . . </description>
    <version type="ID" major="Number1" minor="Number2/>
    <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 的必需子元素。

定义过程模板插件的容器元素。

version

 
<version type="ID" major="Number1" minor="Number2 " />

metadata 的必需子元素。

指定一个唯一 ID 以及主要版本号和次要版本号，用于确定过程模板的版本。

组元素参考

下面的语法演示了 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 分配一个唯一的值。

  • 说明：指定团队项目创建期间指示正在处理任务组的消息。

  • completionMessage：指定团队项目创建期间指示任务组已成功完成的消息。 最大长度为 256 个字符。

  • failureMessage：指定团队项目创建期间指示任务组无法成功完成的消息。

groups

 
<groups>
    <group> . . . </group>
</groups>

ProcessTemplate 的必需子元素。

定义将在项目创建期间运行的任务组集的容器元素。

tasklist

 
<taskList filename="filePath" />

指定包含要运行的任务列表的 XML 文件。 组的任务列表必须始终位于单独的 XML 文件中。 有关如何指定这些文件的详细信息，请参阅定义用于处理插件的任务。

请参见

概念

过程模板文件概述

定义用于处理插件的任务

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

自定义过程

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

  • Last updated on