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


Справочник по всем XML-элементам WITD

Можно настроить существующий тип рабочего элемента (WIT) или создать новый WIT для соответствия требованиям отслеживания проекта. WIT определяет правила, поля, состояния и переходы для рабочего элемента, который будет отслеживаться в командном проекте, например для ошибки, требования или риска.

WIT не может быть пустым. Корневым элементом каждого определения WIT является элемент WITD, в котором должен быть определен только один элемент WORKITEMTYPE. Имя каждого WIT должно быть уникально в пределах командного проекта и не должно превышать 254 символа Юникода. Для получения дополнительной информации см. Соглашения об именовании объектов отслеживания рабочих элементов.

Чтобы настроить или создать определение WIT, необходимо изменить XML-файл определений типов. Управление определениями типов рабочих элементов осуществляется на уровне командного проекта.

Структура синтаксиса WITD

В следующем примере показана высокоуровневая структура определения WIT.

<WITD application="work item type editor" version="1.0">
    <WORKITEMTYPE name="bug">
        <DESCRIPTION>Bug work item types are used to track defects in the code.</DESCRIPTION>
        <GLOBALLISTS> . . . </GLOBALLISTS>
        <FIELDS> . . . </FIELDS>
        <WORKFLOW> . . . </WORKFLOW>
        <FORM> . . . </FORM>
    </WORKITEMTYPE>
</WITD>

Небольшое количество XML-элементов отображается между тегами WORKITEMTYPE на наивысших уровнях определения WIT. Определение WIT начинается с указания имени и описания. Также используется определенные стандартные XML-теги для оборачивания определения WIT.

Дочерние элементы WITD

Ниже описаны структурные элементы, использованные в предыдущем примере.

Элемент

Описание

WITD

Полное определение WIT заключается в тег WITD. В качестве имени приложения можно использовать любое имя. Версия определяет схему типа рабочего элемента, которая меняется от одного выпуска к другому. Используйте значение "1.0".

<WITD application="Work item type editor" version="1.0 [1]">
   <WORKITEMTYPE> . . .</WORKITEMTYPE>
</WITD>

WORKITEMTYPE

Имена WIT должны быть уникальными в конкретном командном проекте. Во время выполнения используется имя, указанное этим элементом. Например, оно может отображаться как пункт меню. В этом случае пользователь может выбрать пункт Ошибка в меню Новый рабочий элемент.

<WORKITEMTYPE name="WorkItemTypeName">
    <DESCRIPTION>Text</DESCRIPTION>
    <GLOBALLISTS> . . .</</GLOBALLISTS>
    <FIELDS> . . . </FIELDS>
    <WORKFLOW> . . . </WORKFLOW>
    <FORM> . . .</</FORM>
</WORKITEMTYPE>

DESCRIPTION

Задает строку, описывающую тип определяемого рабочего элемента. Это описание может быть полезным для любого пользователя, настраивающего WIT.

Примечание

Описание отображается только в XML-определении.Оно не отображается где-либо в пользовательском интерфейсе и не имеет отношения к полю System.Definition.

<DESCRIPTION> DescriptionOfWorkItemType</DESCRIPTION>

Задается строка текста, описывающая тип определяемого рабочего элемента.

GLOBALLISTS

Содержит определения глобальных списков, используемые типом рабочего элемента. Глобальные списки необходимы для совместного использования нескольких элементов списка несколькими типами рабочих элементов в коллекции командных проектов. Использование глобальных списков обеспечивает поддержку более простого обслуживания и совместной работы групп.

<GLOBALLIST name="globalListName">
    <LISTITEM> . . . </LISTITEM>
</GLOBALLIST>

Для получения дополнительной информации см. Определение глобальных списков.

FIELDS

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

<FIELDS>
   <FIELD> . . . </FIELD>
</FIELDS>

Для получения дополнительной информации см. Определение и изменение полей рабочих элементов.

WORKFLOW

Содержит набор элементов STATE и TRANSITION, которые вместе определяют рабочий процесс. Рабочий процесс представляет собой набор допустимых переходов между состояниями и конкретные условия, связанные с каждым переходом.

<WORKFLOW>
   <STATES> . . . </STATES>
   <TRANSITIONS> . . . </TRANSITIONS>
</WORKFLOW>

Для получения дополнительной информации см. Изменение рабочего процесса для типа рабочего элемента.

FORM

Содержит элементы LAYOUT, CONTROL, GROUP, TAB, TABGROUP, SPLITTER и другие элементы, определяющие, какие поля и элементы управления должны отображаться в форме типа рабочего элемента.

<FORM>
   <Layout> . . . </Layout>
</FORM>

Для получения дополнительной информации см. Разработка формы рабочего элемента.

Типы рабочих элементов шаблона процесса

В TFS есть три шаблона процесса по умолчанию. Эти файлы расположены в следующем каталоге:

%programfiles%/Microsoft Team Foundation Server 12.0/Tools/Deploy/ProcessTemplateManagerFiles/1033

Определения типов рабочих элементов расположены в папке WorkItem Tracking\TypeDefinitions. Для получения дополнительной информации см. Работа с артефактами командного проекта, выбор шаблона процесса.

Настраивать или создавать новые файлы определений типов можно в папке TypeDefinitions. После этого новый тип рабочего элемента можно импортировать в отдельный проект или добавить в шаблон процесса и отправить измененный шаблон на сервер Team Foundation Server. Для получения дополнительной информации см. Добавление определений типов рабочих элементов в шаблон процесса.

См. также

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

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

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

witAdmin. Настройка объектов для отслеживания рабочих элементов и управление этими объектами