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


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

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

Добавлен справочник по элементам и ссылки на конкретные разделы, в которых описывается каждый из типов объектов отслеживания. Убраны ссылки на удаленные разделы.

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