Определение объектов для отслеживания рабочих элементов с помощью подключаемого модуля отслеживания рабочих элементов

Статья
11/18/2015

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

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

Важно!

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

Имя и расположение подключаемого модуля

В таблице ниже приведены имена и расположения файлов для шаблонов процессов в Microsoft Solutions Framework (MSF), а также имена подключаемых модулей.

Имя файла:	WorkItems.xml
Расположение файла:	Папка WorkItem Tracking
Имя подключаемого модуля:	Microsoft.ProjectCreationWizard.WorkItemTracking

Примечание

Вы можете изменять имя и расположение XML-файла, но не имя подключаемого модуля.Visual Studio Team Foundation Server не содержит механизма развертывания клиентских подключаемых модулей, политик или других модификаций.Если требуется развернуть функциональность этого типа, необходимо использовать собственную программу распространения и установки.

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

Структура синтаксиса подключаемого модуля отслеживания рабочих элементов

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

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

Описание каждого элемента см. ниже в подразделе Справочник по элементам.

<?xml version="1.0" encoding="utf-8"?>
<tasks>
  <task id="LinkTypes" name="LinkType definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item link types created">
    <taskXml>
      <LINKTYPES>
        <LINKTYPE />
   . . . 
      </LINKTYPES>
    </taskXml>
  </task>
  <task id="WITs" name="WorkItemType definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item types created">
    <dependencies>
      <dependency taskId="LinkTypes" />
    </dependencies>
    <taskXml>
      <WORKITEMTYPES>
        <WORKITEMTYPE />
   . . . 
      </WORKITEMTYPES>
    </taskXml>
  </task>
  <task id="Queries" name="Stored Query Definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item queries uploaded">
    <dependencies>
      <dependency taskId="WITs" />
    </dependencies>
    <taskXml>
      <QUERIES>
        <Permission />
   . . . 
        <QueryFolder >
          <Query />
   . . . 
        </QueryFolder>
   . . . 
      </QUERIES>
    </taskXml>
  </task>
  <task id="Categories" name="Categories definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item type categories created">
    <dependencies>
      <dependency taskId="WITs" />
    </dependencies>
    <taskXml>
      <CATEGORIES fileName="WorkItem Tracking\Categories.xml" />
    </taskXml>
  </task>
</tasks>

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

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

Элемент	Синтаксис	Описание
CATEGORIES	`<CATEGORIES fileName="CategoriesFilePathName" />`	Необязательный дочерний элемент элемента taskXml подключаемого модуля WorkItemTracking. Задает путь и имя файла, содержащего определения категорий, которые должны передаваться при обработке задачи подключаемого модуля отслеживания рабочих элементов.
FIELD	`<FIELD refname="FieldReferenceName" value="Value" />`	Обязательный дочерний элемент элемента WI. Определяет значение для поля в экземпляре рабочего элемента.
HYPERLINK	`<HYPERLINK URL="URL" relativePath="false" />`	Необязательный дочерний элемент элемента WI. Определяет гиперссылку для экземпляра рабочего элемента.
LINKTYPE	`<LINKTYPE fileName="LinkTypeFilePathName" />`	Обязательный дочерний элемент элемента LINKTYPES. Задает путь и имя файла, содержащего определение типа связи для передачи.
LINKTYPES	`<LINKTYPES> <LINKTYPE /> . . . </LINKTYPES>`	Необязательный дочерний элемент элемента taskXml подключаемого модуля WorkItemTracking. Содержит коллекцию элементов LINKTYPE, каждый из которых задает файл определения для передачи.
Permission	`<permission allow="ListOfPermissions" identity="GroupName" />`	Необязательный дочерний элемент элемента Query. Задает разрешения по умолчанию, назначаемые командным запросам. Подробнее см. в разделе Назначение разрешений для запросов рабочих элементов.
Query	`<Query name="QueryName" fileName="QueryFilePathName" />`	Обязательный дочерний элемент элемента QUERIES. Указывает имя и путь для WIQ-файла, определяющего передаваемый запрос.
QueryFolder	`<QueryFolder name=" FolderName ">`	Необязательный дочерний элемент элемента QUERIES. Указывает имя папки запроса.
QUERIES	`<QUERIES> . . . </QUERIES>`	Необязательный дочерний элемент элемента taskXml подключаемого модуля WorkItemTracking. Указывает, какие файлы определения запросов следует использовать для создания запросов по умолчанию.
WI	`<WI type="WorkItemType"> <FIELD> . . .</FIELD> <HYPERLINK> . . .</HYPERLINK> </WI>`	Обязательный дочерний элемент элемента WORKITEMS. Определяет тип создаваемого рабочего элемента и значения, которые нужно назначить определенным полям.
WORKITEMS	`WORKITEMS> <WI> <FIELD> . . .</FIELD> <HYPERLINK> . . .</HYPERLINK> </WI> </WORKITEMS >`	Необязательный дочерний элемент элемента taskXml подключаемого модуля WorkItemTracking. Содержит коллекцию элементов WI, каждый из которых определяет экземпляр рабочего элемента.
WORKITEMTYPE	`<WORKITEMTYPE fileName="WITFilePathName" />`	Обязательный дочерний элемент элемента WORKITEMTYPES. Задает путь и имя файла, содержащего определение типа для передачи.
WORKITEMTYPES	`<WORKITEMTYPES> <WORKITEMTYPE /> . . . </WORKITEMTYPES>`	Обязательный дочерний элемент подключаемого модуля отслеживания рабочих элементов. Содержит коллекцию элементов WORKITEMTYPE, каждый из которых задает файл определения для передачи.

См. также

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

Настройка процесса

Настройка объектов отслеживания работ для поддержки командных процессов

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

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