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

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

  • Статья

Элемент 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>

К началу

См. также

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

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

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