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

С помощью подключаемого модуля отслеживания рабочих элементов можно определить начальные объекты командного проекта для отслеживания работы. К этим объектам относятся типы рабочих элементов, запросы рабочих элементов, категории, типы связей, глобальные списки и экземпляры рабочих элементов. После создания командного проекта эти объекты можно изменить с помощью средства командной строки 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.

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

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

<?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 в файле подключаемого модуля отслеживания рабочих элементов. Дополнительные сведения об элементах task, dependency и taskXml см. в разделе Определение задач для подключаемого модуля процесса.

Элемент	Синтаксис	Описание
CATEGORIES	<CATEGORIES fileName="CategoriesFilePathName" />	Необязательный дочерний элемент элемента taskXml подключаемого модуля отслеживания рабочих элементов. Задает путь и имя файла, содержащего определения категорий, которые должны передаваться при обработке задачи подключаемого модуля отслеживания рабочих элементов.
FIELD	<FIELD refname="FieldReferenceName" value="Value" />	Обязательный дочерний элемент элемента WI. Определяет значение поля в экземпляре рабочего элемента.
GLOBALLISTS	<GLOBALLISTS fileName="GlobalListFilePathName" />	Необязательный дочерний элемент элемента taskXml подключаемого модуля отслеживания рабочих элементов. Задает путь и имя файла, содержащего определения глобальных списков, которые должны передаваться при обработке задачи подключаемого модуля отслеживания рабочих элементов.
HYPERLINK	<HYPERLINK URL="URL" relativePath="false" />	Необязательный дочерний элемент элемента WI. Определяет гиперссылку для экземпляра рабочего элемента.
LINKTYPE	<LINKTYPE fileName="LinkTypeFilePathName" />	Обязательный дочерний элемент элемента LINKTYPES. Задает путь и имя файла, содержащего определение типа связи для передачи.
LINKTYPES	<LINKTYPES>    <LINKTYPE />  . . . </LINKTYPES>	Необязательный дочерний элемент элемента taskXml подключаемого модуля отслеживания рабочих элементов. Содержит коллекцию элементов 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 подключаемого модуля отслеживания рабочих элементов. Указывает, какие файлы определения запросов использовать для создания запросов по умолчанию.
WI	<WI type="WorkItemType">    <FIELD> . . .</FIELD>    <HYPERLINK> . . .</HYPERLINK> </WI>	Обязательный дочерний элемент элемента WORKITEMS. Определяет тип рабочего элемента для создания и значения, присваиваемые конкретным полям.
WORKITEMS	WORKITEMS>    <WI>       <FIELD> . . .</FIELD>       <HYPERLINK> . . .</HYPERLINK>    </WI> </WORKITEMS >	Необязательный дочерний элемент элемента taskXml подключаемого модуля отслеживания рабочих элементов. Содержит коллекцию элементов WI, каждый из которых определяет экземпляр рабочего элемента.
WORKITEMTYPE	<WORKITEMTYPE fileName="WITFilePathName" />	Обязательный дочерний элемент элемента WORKITEMTYPES. Задает путь и имя файла, содержащего определение типа для передачи.
WORKITEMTYPES	<WORKITEMTYPES>    <WORKITEMTYPE />  . . . </WORKITEMTYPES>	Обязательный дочерний элемент подключаемого модуля отслеживания рабочих элементов. Содержит коллекцию элементов WORKITEMTYPE, каждый из которых задает файл определения для передачи.

К началу

См. также

Задачи

Проверка изменений в определении типа рабочего элемента

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

Пошаговый процесс настройки

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

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

Настройка функциональных областей внутри шаблона процесса

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

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

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

Дата	Журнал	Причина
Апрель 2011	Добавлен справочник по элементам и ссылки на конкретные разделы, в которых описывается каждый из типов объектов отслеживания. Убраны ссылки на удаленные разделы.	Улучшение информации.