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

Статья
11/18/2015

Можно настроить существующий тип рабочего элемента (WIT) или создать новый WIT для соответствия требованиям отслеживания проекта. Тип рабочего элемента определяет поля, правила, состояния и переходы рабочего процесса для рабочего элемента, который будет отслеживаться в командном проекте, например для ошибки, требования или риска. Командный проект создается в Visual Studio Online или в локальном развертывании Team Foundation Server (TFS).

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

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

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

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

<witd:WITD application="Work item type editor" version="1.0" xmlns:witd="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef">
    <WORKITEMTYPE name="bug" refname="Microsoft.VSTS.WorkItemTypes.Bug">
        <DESCRIPTION> Describes a divergence between required and actual behavior, and tracks the work done to correct the defect and verify the correction.</DESCRIPTION>
        <GLOBALLISTS> . . . </GLOBALLISTS>
        <FIELDS> . . . </FIELDS>
        <WORKFLOW> . . . </WORKFLOW>
        <FORM> . . . </FORM>
    </WORKITEMTYPE>
</witd:WITD>

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

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

Элемент	Описание
WITD	Полное определение WIT заключается в тег WITD. В качестве имени приложения можно использовать любое имя. Версия определяет схему типа рабочего элемента, которая может изменяться в разных выпусках. Используйте значение "1.0". `<witd:WITD application="Work item type editor" version="1.0" xmlns:witd="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef"> <WORKITEMTYPE> . . .</WORKITEMTYPE> </witd:WITD>`
WORKITEMTYPE	Имена WIT должны быть уникальными в конкретном командном проекте. Во время выполнения используется имя, указанное этим элементом. Например, оно может отображаться как пункт меню. В этом случае пользователь может выбрать пункт Ошибка в меню Новый рабочий элемент. `<WORKITEMTYPE name="WorkItemTypeName" refname="WITReferenceName" > <DESCRIPTION>Text</DESCRIPTION> <GLOBALLISTS> . . .</</GLOBALLISTS> <FIELDS> . . . </FIELDS> <WORKFLOW> . . . </WORKFLOW> <FORM> . . .</</FORM> </WORKITEMTYPE>` Понятное имя. Это имя отображается в раскрывающихся меню запросов рабочих элементов. Понятное имя должно быть уникальным для всех типов рабочих элементов, определенных в командном проекте. Укажите имя не длиннее 128 символов Юникода, содержащее буквы, цифры, символы подчеркивания и дефисы. Ссылочное имя. Укажите имя не длиннее 70 символов Юникода, содержащее буквы, цифры, символы подчеркивания и дефисы. Ссылочное имя должно содержать как минимум одну точку (.), но точка не может находиться в начале или в конце имени. Кроме того, ссылочное имя не может начинаться с цифры или символа подчеркивания, и в нем не может быть нескольких последовательных дефисов, например (--). Не указывайте имя, пересекающееся с зарезервированными пространствами имен System. XXX и Microsoft. XXX. См. раздел Соглашения об именовании объектов отслеживания рабочих элементов.
ОПИСАНИЕ	Задает строку, описывающую тип определяемого рабочего элемента. Это описание может быть полезным для любого пользователя, настраивающего WIT. Примечание Описание отображается только в XML-определении.Оно не отображается где-либо в пользовательском интерфейсе и не имеет отношения к полю System.Definition. `<DESCRIPTION> DescriptionOfWorkItemType</DESCRIPTION>` Задается строка текста, описывающая тип определяемого рабочего элемента.
GLOBALLISTS	Содержит определения глобальных списков, используемые типом рабочего элемента. Глобальные списки необходимы для совместного использования списков выбора несколькими типами рабочих элементов в коллекции командных проектов. Использование глобальных списков обеспечивает поддержку совместной работы групп и более простое обслуживание. `<GLOBALLIST name="globalListName"> <LISTITEM> . . . </LISTITEM> </GLOBALLIST>`
ПОЛЯ	Определяет поля, используемые для отслеживания данных типа рабочего элемента. В элементе FIELDS определяются все поля, необходимые для отслеживания данных. Это включает поля, используемые для выполнения запросов и создания отчетов. `<FIELDS> <FIELD> . . . </FIELD> </FIELDS>`
WORKFLOW	Определяет элементы рабочего процесса, которые помогают отслеживать состояние рабочего элемента при его переходе из состояния "Новый" в состояние "Закрыт" или "Выполнен". Этот элемент содержит набор элементов STATE и TRANSITION, которые определяют рабочий процесс. Рабочий процесс представляет собой набор допустимых переходов между состояниями и конкретные условия, связанные с каждым переходом. `<WORKFLOW> <STATES> . . . </STATES> <TRANSITIONS> . . . </TRANSITIONS> </WORKFLOW>`
ФОРМА	Задает структуру формы рабочего элемента путем определения полей и элементов управления, которые отображаются на форме, и их порядка. Содержит элементы LAYOUT, CONTROL, GROUP, TAB, TABGROUP, SPLITTER и другие элементы. `<FORM> <Layout> . . . </Layout> </FORM>`

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

При установке или обновлении экземпляра TFS шаблоны процессов по умолчанию скачиваются в следующий каталог:

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

Файлы определения типов рабочих элементов хранятся в папке WorkItem Tracking\TypeDefinitions.

Информацию о создании и настройке типов рабочих элементов см. в разделе Настройка объектов отслеживания работ для поддержки командных процессов. Информацию о добавлении нового типа рабочего элемента в шаблон процесса см. в разделе Добавление определений типов рабочих элементов в шаблон процесса.

См. также

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

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

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

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

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