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

Статья
06/09/2015

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

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