通过

过程模板 XML 元素引用

  • 项目

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

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

警告

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

主题内容

  • ProcessTemplate 语法结构

  • 元数据元素参考

  • 组元素引用

ProcessTemplate 语法结构

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

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

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 分配一个唯一值。

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

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

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

groups

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

ProcessTemplate 的必需子元素。

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

tasklist

 
<taskList filename="filePath" />

指定包含要运行的任务的列表的 XML 文件。 一个组的任务列表必须总是放置在一个单独的 XML 文件中。 有关如何指定这些文件的更多信息，请参见定义用于处理插件的任务。

请参见

概念

过程模板文件概述

定义用于处理插件的任务

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

自定义过程模板

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