Справочник по XML-элементам категорий
Элемент CATEGORIES служит для группирования типов рабочих элементов. В разделе Использование категорий для группировки типов рабочих элементов приводится описание всех категорий по умолчанию, используемых в Visual Studio Online и Team Foundation Server (TFS).
<CATEGORIES>
<CATEGORY name="category display name" refname="category reference name">
<DEFAULTWORKITEMTYPE name="work item type reference name" />
<WORKITEMTYPE name="work item type reference name" />
</CATEGORY>
</CATEGORIES>
Элементы и атрибуты
Элемент |
Атрибут |
Описание |
|---|---|---|
CATEGORIES |
|
Обязательный элемент в XML-файле категорий. Элемент контейнера для указания одного или нескольких элементов CATEGORY, определенных для командного проекта. |
CATEGORY |
|
Обязательный дочерний элемент CATEGORIES. Задает именованную группу категорий, содержащую один используемый по умолчанию элемент DEFAULTWORKITEMTYPE и от нуля до нескольких элементов WORKITEMTYPE. |
|
name |
Обязательный атрибут элемента CATEGORY. Тип атрибута —typelib:FriendlyName. Определяет отображаемое имя категории. Это имя должно быть уникальным в пределах командного проекта и должно иметь размер от 1 до 254 символов. |
|
refname |
Обязательный атрибут элемента CATEGORY. Тип атрибута —typelib:ReferenceName. Укажите имя не длиннее 70 символов Юникода, содержащее буквы, цифры, символы подчеркивания и дефисы. Ссылочное имя должно содержать как минимум одну точку (.), но точка не может находиться в начале или в конце имени. Кроме того, ссылочное имя не может начинаться с цифры или символа подчеркивания, и в нем не может быть нескольких последовательных дефисов, например (--). Не указывайте имя, пересекающееся с зарезервированными пространствами имен System. XXX и Microsoft. XXX. См. раздел Соглашения об именовании объектов отслеживания рабочих элементов. |
DEFAULTWORKITEMTYPE |
|
Обязательный элемент CATEGORY. Задает тип рабочего элемента, который должен быть отмечен как принадлежащий к именованной категории и должен использоваться как тип по умолчанию для этой категории. |
|
name |
Обязательный атрибут элемента DEFAULTWORKITEMTYPE. Тип атрибута —WorkItemTypeRef. Задает ссылочное имя допустимого типа рабочего элемента для командного проекта, который будет использоваться в качестве типа по умолчанию для этой категории. |
WORKITEMTYPE |
|
Необязательный элемент CATEGORY. Задает тип рабочего элемента, который должен быть отмечен как принадлежащий к именованной категории. |
|
name |
Обязательный атрибут элемента WORKITEMTYPE. Тип атрибута —WorkItemTypeRef. Задает ссылочное имя допустимого типа рабочего элемента для командного проекта, который будет принадлежать к именованной категории. |
Заметки
CATEGORIES— корневой элемент схемы категорий.
Категория определяется в рамках набора CATEGORIES элементов CATEGORY, который хранится и используется в командном проекте. Каждый элемент CATEGORIES должен иметь по крайней мере один определенный элемент CATEGORY.
Категория не может быть пустой. Для каждого элемента CATEGORY должен быть определен по крайней мере один элемент DEFAULTWORKITEMTYPE или WORKITEMTYPE.
У каждой категории есть понятное имя, а также ссылочное имя, которое в рамках проекта должно быть уникальным. Понятные имена категорий должны отвечать следующим требованиям:
Имена могут содержать до 254 символов юникода.
Имена не могут быть пустыми.
Имена не могут начинаться или заканчиваться пробелом.
Имена не должны содержать символы обратной косой черты (\).
Имена не должны содержать два последовательных пробела.
Понятные имена категорий не локализуются и не могут быть преобразованы в токен, тогда как имена типов рабочих элементов локализуются и могут быть преобразованы в токен.
Средства Agile, требования к категориям и ограничения
При присвоении типов рабочих элементов категориям необходимо учитывать следующие соображения.
Для использования досок невыполненной работы и задач необходимо отнести по крайней мере один тип рабочих элементов к категории требований и еще один тип рабочих элементов к категории задач.
Невозможно отнести один и тот же тип рабочих элементов к категории требований и категории задач одновременно.
Если включить несколько типов рабочих элементов в категорию требований или категорию задач, тип, назначенный к элементу DEFAULTWORKITEMTYPE, отображается как тип по умолчанию на страницах досок и невыполненной работы Agile.
Типы рабочих элементов, относящиеся к категории, которая определяет невыполненную работу в файле ProcessConfiguration, должны иметь начальное, конечное и по крайней мере одно промежуточное состояние рабочего процесса, связанное с допустимым метасостоянием, как описано в разделе Справочник по XML-элементам конфигурации процесса.
Типы рабочих элементов, назначенные категории "Ошибка", можно настроить так, чтобы они отображались в списках невыполненной работы и на досках каждой команды. Поведение по умолчанию устанавливается путем определения свойства BugsBehavior в файле ProcessConfiguration.
Пример
В примере ниже приведен XML-файл категорий по умолчанию для шаблона процесса Scrum.
<?xml version="1.0" encoding="utf-8"?>
<cat:CATEGORIES xmlns:cat="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/categories">
<!-- Usage: for resilience in Test system. Even if WITs have different name, they can be referred to by the category -->
<CATEGORY name="Bug Category" refname="Microsoft.BugCategory">
<DEFAULTWORKITEMTYPE name="Bug" />
</CATEGORY>
<CATEGORY name="Epic Category" refname="Microsoft.EpicCategory">
<DEFAULTWORKITEMTYPE name="Epic" />
</CATEGORY>
<CATEGORY name="Feature Category" refname="Microsoft.FeatureCategory">
<DEFAULTWORKITEMTYPE name="Feature" />
</CATEGORY>
<CATEGORY name="Requirement Category" refname="Microsoft.RequirementCategory">
<DEFAULTWORKITEMTYPE name="Product Backlog Item" />
<WORKITEMTYPE name="Bug" />
</CATEGORY>
<CATEGORY name="Test Case Category" refname="Microsoft.TestCaseCategory">
<DEFAULTWORKITEMTYPE name="Test Case" />
</CATEGORY>
<CATEGORY name="Shared Step Category" refname="Microsoft.SharedStepCategory">
<DEFAULTWORKITEMTYPE name="Shared Steps" />
</CATEGORY>
<CATEGORY name="Shared Parameter Category" refname="Microsoft.SharedParameterCategory">
<DEFAULTWORKITEMTYPE name="Shared Parameter" />
</CATEGORY>
<CATEGORY name="Code Review Request Category" refname="Microsoft.CodeReviewRequestCategory">
<DEFAULTWORKITEMTYPE name="Code Review Request" />
</CATEGORY>
<CATEGORY name="Code Review Response Category" refname="Microsoft.CodeReviewResponseCategory">
<DEFAULTWORKITEMTYPE name="Code Review Response" />
</CATEGORY>
<CATEGORY name="Feedback Request Category" refname="Microsoft.FeedbackRequestCategory">
<DEFAULTWORKITEMTYPE name="Feedback Request" />
</CATEGORY>
<CATEGORY name="Feedback Response Category" refname="Microsoft.FeedbackResponseCategory">
<DEFAULTWORKITEMTYPE name="Feedback Response" />
</CATEGORY>
<CATEGORY name="Test Plan Category" refname="Microsoft.TestPlanCategory">
<DEFAULTWORKITEMTYPE name="Test Plan" />
</CATEGORY>
<CATEGORY name="Test Suite Category" refname="Microsoft.TestSuiteCategory">
<DEFAULTWORKITEMTYPE name="Test Suite" />
</CATEGORY>
<CATEGORY name="Task Category" refname="Microsoft.TaskCategory">
<DEFAULTWORKITEMTYPE name="Task" />
</CATEGORY>
<CATEGORY name="Hidden Types Category" refname="Microsoft.HiddenCategory">
<DEFAULTWORKITEMTYPE name="Code Review Request" />
<WORKITEMTYPE name="Code Review Response" />
<WORKITEMTYPE name="Feedback Request" />
<WORKITEMTYPE name="Feedback Response" />
<WORKITEMTYPE name="Shared Steps" />
<WORKITEMTYPE name="Shared Parameter" />
<WORKITEMTYPE name="Test Plan" />
<WORKITEMTYPE name="Test Suite" />
</CATEGORY>
</cat:CATEGORIES>