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

Статья
02/20/2013

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

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

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

Содержание раздела

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

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

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

<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 на наивысших уровнях определения типа рабочего элемента.Определение типа рабочего элемента начинается с указания имени и описания.Также используется определенные стандартные XML-теги для оборачивания определения типа рабочего элемента.

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

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

Элемент	Описание
WITD	Полное определение типа рабочего элемента заключается в тег WITD.В качестве имени приложения можно использовать любое имя.Версия определяет схему типа рабочего элемента, которая меняется от одного выпуска к другому.Используйте значение "1.0". `<WITD application="Work item type editor" version="1.0 [1]"> <WORKITEMTYPE> . . .</WORKITEMTYPE> </WITD>`
WORKITEMTYPE	Имена типов рабочих элементов должны быть уникальными в конкретном командном проекте.Во время выполнения используется имя, указанное этим элементом.Например, оно может отображаться как пункт меню.В этом случае пользователь может выбрать пункт Ошибка в меню Новый рабочий элемент. `<WORKITEMTYPE name="WorkItemTypeName"> <DESCRIPTION>Text</DESCRIPTION> <GLOBALLISTS> . . .</</GLOBALLISTS> <FIELDS> . . . </FIELDS> <WORKFLOW> . . . </WORKFLOW> <FORM> . . .</</FORM> </WORKITEMTYPE>`
DESCRIPTION	Задает строку, описывающую тип определяемого рабочего элемента.Это описание может быть полезным для любого пользователя, настраивающего тип рабочего элемента. Примечание Описание отображается только в XML-определении.Оно не отображается где-либо в пользовательском интерфейсе и не имеет отношения к полю System.Definition. `<DESCRIPTION> DescriptionOfWorkItemType</DESCRIPTION>` Задается строка текста, описывающая тип определяемого рабочего элемента.
GLOBALLISTS	Содержит определения глобальных списков, используемые типом рабочего элемента.Глобальные списки необходимы для совместного использования нескольких элементов списка несколькими типами рабочих элементов в коллекции командных проектов.Использование глобальных списков обеспечивает поддержку более простого обслуживания и совместной работы групп. `<GLOBALLIST name="globalListName"> <LISTITEM> . . . </LISTITEM> </GLOBALLIST>` Дополнительные сведения см. в разделе Определение глобальных списков.
FIELDS	Содержит набор определений полей, используемых типом рабочего элемента.В элементе 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>` Дополнительные сведения см. в разделе Проектирование и настройка формы рабочего элемента.

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

Для использования доступны два определения типов рабочих элементов шаблонов процессов, соответствующие типам, определенным в Microsoft Solutions Framework (MSF) для гибкой разработки программного обеспечения версии 5.0 и MSF для разработки программного обеспечения Capability Maturity Model Integration (CMMI) версии 5.0.Эти файлы расположены в папке установки в следующих местоположениях (соответственно):

Диск:\Program Files\Microsoft Visual Studio v10.0 Team Foundation Server\Application Tier\Web Services\Deploy\ProcessTemplateManagerFiles\MsfAgile\Template.zip
Диск:\Program Files\Microsoft Visual Studio v10.0 Team Foundation Server\Application Tier\Web Services\Deploy\ProcessTemplateManagerFiles\MsfFormal\Template.zip

Найти определения типов рабочих элементов по имени можно в папке WorkItem Tracking\TypeDefinitions в файле Template.zip.Например, MSF для гибкой разработки программного обеспечения версии 5.0 определяет XML-файл для каждого из следующих типов рабочих элементов: Bug, Issue, SharedStep, Task, TestCase и User Story.Дополнительные сведения о каждом их этих типов рабочих элементов см. в разделе Шаблон процесса гибкой разработки для Visual Studio ALM.

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