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

Статья
06/09/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, каждый из которых задает файл определения для передачи.

См. также

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

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

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

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

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