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


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

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

Структура артефактов гибкого командного проекта

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

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

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

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

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

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

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

Ниже показана высокоуровневая синтаксическая структура элемента 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>

К началу

См. также

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

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

Другие ресурсы

Подключаемые модули шаблона процесса

Журнал изменений

Дата

Журнал

Причина

Апрель 2011

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

Улучшение информации.