Справочник по XML-элементам ProcessTemplate

Статья
06/09/2015

Корневой файл шаблона процесса можно изменять, добавляя и изменяя файлы подключаемых модулей. Корневой файл определяет все подключаемые модули и все задачи, которые будут обрабатываться мастером создания командного проекта. В шаблонах процессов Microsoft Solutions Framework (MSF) корневой файл имеет имя ProcessTemplate и расположен в папке-контейнере для файлов шаблонов процессов. Для получения дополнительной информации см. Общие сведения о файлах шаблонов процессов.

Родительским элементом корневого файла подключаемых модулей является элемент ProcessTemplate, в котором должен быть определен только один элемент metadata и один элемент groups. Каждому шаблону процесса в коллекции командных проектов необходимо присвоить уникальное имя, а длина этого имени не может превышать 124 символов Юникода.

Предупреждение

При совпадении имен загружаемого шаблона с уже существующим, существующий шаблон будет перезаписан.

Содержание раздела

Синтаксическая структура элемента ProcessTemplate
Справочник по элементу Metadata
Справочник по элементу Groups

Синтаксическая структура элемента ProcessTemplate

Корневой подключаемый модуль шаблонов процессов должен задаваться в собственном файле в элементе-контейнере ProcessTemplate и должен удовлетворять схеме шаблонов процессов, которая определена в файлах ProcessTemplate.xsd и ProcessTemplateItem.xsd. Файлы схемы для шаблонов процессов можно загрузить на следующей странице веб-сайта Microsoft: Process Template and Work Item Schemas for Visual Studio Team Foundation.

В следующем примере показана структура корневого элемента ProcessTemplate. Более сложный пример см. в разделе Определение корневого элемента tasks с помощью файла подключаемого модуля шаблона процесса.

<?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. Элемент-контейнер, определяющий подключаемые модули для шаблона процесса.
version	`<version type="ID" major="Number1" minor="Number2 " />`	Необязательный дочерний элемент элемента 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. Задает идентификатор другой группы задач, от которой зависит данная группа. Выполнение задач другой группы должно быть завершено до запуска этой группы.
group	`<group id="TaskGroupId" description="TaskGroupDescription" completionMessage="SuccessMessage" failureMessage="FailureMessage"> <dependencies> . . . <dependencies> <taskList> . . . </taskList> </group>`	Обязательный дочерний элемент элемента groups. Указывает набор задач для выполнения подключаемым модулем при создании проекта. Для каждого атрибута допустимыми являются следующие значения: id: имя, идентифицирующее группу задач. Если другая группа задач зависит от этой, она ссылается на этот идентификатор. Необходимо присвоить идентификатору уникальное в пределах файла подключаемого модуля значение; description: сообщение, которое в процессе создания командного проекта будет указывать, что обрабатывается эта группа задач; completionMessage: сообщение, которое в процессе создания командного проекта будет указывать, что эта группа задач успешно выполнена. Максимальная длина — 256 знаков; failureMessage: сообщение, которое в процессе создания командного проекта будет указывать, что успешно выполнить группу задач не удалось.
groups	`<groups> <group> . . . </group> </groups>`	Обязательный дочерний элемент элемента ProcessTemplate. Элемент-контейнер, определяющий набор групп задач, которые будут выполняться при создании проекта.
tasklist	`<taskList filename="filePath" />`	Задает XML-файл со списком задач для выполнения. Список задач для группы всегда должен находиться в отдельном файле XML. Дополнительные сведения об указании этих файлов см. в разделе Определение элемента tasks для обработки подключаемого модуля.

См. также

Основные понятия

Общие сведения о файлах шаблонов процессов

Определение элемента tasks для обработки подключаемого модуля

Определение зависимостей для групп задач и задач в файлах подключаемых модулей

Настройка шаблона процесса

Определение корневого элемента tasks с помощью файла подключаемого модуля шаблона процесса

Поделиться через