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

Определение задач для подключаемого модуля процесса

  • Статья

Элемент tasks и его дочерние элементы служат для определения передаваемых артефактов или конкретных элементов, которые необходимо создать для подключаемого модуля.Задача определяет, что необходимо сделать для настройки чего-то определенного в процессе в командном проекте.Несколько задач, которые можно указать передачу типов рабочих элементов, запросы рабочего элемента, документы и отчеты для командных проектов.Другие доступные для определения задачи задают другие области Visual Studio Application Lifecycle Management, такие как Team Foundation Build, Visual Studio Lab Management, Test Manager и Team Foundation (подсистема контроля версий).

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

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

  • Справочник по элементу Tasks

  • Указатель элементов taskXML по функциям

  • Пример: определение типов рабочих элементов

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

В подключаемом модуле можно определить несколько задач, и эти задачи могут зависеть друг от друга.Определяемые для каждого подключаемого модуля задачи должны удовлетворять определению схемы tasks, заданному в файле Tasks.xsd, а в элементе-контейнере tasks для каждой задачи должен быть задан собственный файл.

Ниже показана высокоуровневая синтаксическая структура элемента tasks и его дочерних элементов.

<tasks>
   <task>
      <dependencies>
        <dependency />
        . . .    
      </dependencies />
      <taskXml>
        . . .    
      </taskXml>
   <task/>
</tasks>

К началу

Справочник по элементу Tasks

В следующей таблице описаны все элементы, с помощью которых можно определять задачи для подключаемого модуля.

Элемент

Синтаксис

Описание

dependencies

 
<dependencies>
<dependency>. . . </dependency>
</dependencies>

Необязательный дочерний элемент элемента task.

Задает другие группы, от которых зависит данная группа.

dependency

 
<dependency taskId="taskId" />

Необязательный дочерний элемент элемента dependencies.

Задает идентификатор другой задачи, от которой зависит данная задача.Другое задание должно быть завершено до того, как это задание может быть запущено.

ProcessTemplate

 
<ProcessTemplate Type="FileType" Filename="LocalPathAndFileName" 
   Description="FileDescription" 
   ServerPath="UploadLocation" />

Здесь к каждому атрибуту применяются следующие определения:

  • Type: тип передаваемого файла.Допустимы следующие значения: Default и Upgrade для файлов шаблонов построений и Custom для файлов шаблонов лабораторий;

  • Filename: путь к локальному каталогу и имя файла для передачи;

  • Description: короткая строка текста, описывающая файл для передачи;

  • ServerPath: путь на сервере Team Foundation Server, по которому необходимо передать файл.Единственное допустимое расположение передачи: $/$$PROJECTNAME$$/BuildProcessTemplates.

Необязательный дочерний элемент элемента taskXml подключаемых модулей построения и лабораторий.

Задает имя, расположение и назначение для передачи файла для поддержки процессов построения в командном проекте.

task

 
<task id="task id" name="name of task" 
   plugin="Microsoft.ProjectCreationWizard.<PluginName>" 
   completionMessage="SuccessfulCompletionMessage" 
   completionDescription="InProcessMessage">
    <dependencies>. . . </dependencies>
    <taskXml>. . . </taskXml>
</task>

Обязательный дочерний элемент элемента tasks.

Указывает действия, которые должны быть выполнены для настройки специфических для процесса параметров в новом командном проекте.

  • id: задает имя, идентифицирующее задачу.Если другая задача зависит от этой, она ссылается на этот идентификатор.Необходимо присвоить идентификатору уникальное в пределах файла подключаемого модуля значение;

  • name: описывает действие задачи;

  • plugin: идентифицирует подключаемый модуль для выполнения задачи;

  • completionMessage: задает сообщение, отображаемое в ходе создания проекта и указывающее, что задача выполнена успешно.Максимальная длина — 256 знаков;

  • completionDescription: задает сообщение, отображаемое в ходе создания проекта и указывающее, что задача выполняется.Минимальная длина — 1 знак.

tasks

 
<tasks>
    <task>. . . </task>
</tasks>

Обязательный дочерний элемент элемента taskXml.

Содержит коллекцию элементов task, указывающих, что необходимо сделать для настройки чего-то определенного в процессе в командном проекте.

taskXml

 
<taskXml> . . . </taskXml>

Обязательный корневой элемент файла подключаемого модуля.

Описывает действия, необходимые для выполнения задачи.Код XML, который находится внутри этого блока элементов, может быть разным и для каждого подключаемого модуля он свой.

ПримечаниеПримечание
Обработчик XML не предпринимает попыток проверки содержимого этого элемента.

К началу

Указатель элементов taskXML по функциям

Более подробные сведения о каждом элементе разметки XML, который можно задать для того или иного подключаемого модуля, см. в следующих разделах:

К началу

Пример: определение типов рабочих элементов

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

<task
   id="WITs"
   name="WorkItemType definitions"
   plugin="Microsoft.ProjectCreationWizard.WorkItemTracking"
   completionMessage="WorkItemTypes created"         
   completionDescription = "Processing work item types used by work item tracking">
   <taskXml>
   <WORKITEMTYPES>
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Bug.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\SharedStep.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Task.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\TestCase.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\UserStory.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Issue.xml" />
   </WORKITEMTYPES>
   </taskXml>
</task>

К началу

См. также

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

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

Работа с файлами шаблонов процессов