Share via

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

  • Статья

Элемент CATEGORIES используется для определения одной или нескольких категорий для группировки типов рабочих элементов.

<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.

Для получения дополнительной информации см. Соглашения об именовании объектов отслеживания рабочих элементов.

DEFAULTWORKITEMTYPE

 

Обязательный элемент CATEGORY.

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

 

name

Обязательный атрибут элемента DEFAULTWORKITEMTYPE.

Тип атрибута —WorkItemTypeRef.

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

WORKITEMTYPE

 

Необязательный элемент CATEGORY.

Задает тип рабочего элемента, который должен быть отмечен как принадлежащий к именованной категории.

 

name

Обязательный атрибут элемента WORKITEMTYPE.

Тип атрибута —WorkItemTypeRef.

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

Заметки

CATEGORIES— корневой элемент схемы категорий.

Категория определяется в рамках набора CATEGORIES элементов CATEGORY, который хранится и используется в командном проекте. Каждый элемент CATEGORIES должен иметь по крайней мере один определенный элемент CATEGORY.

Категория не может быть пустой. Для каждого элемента CATEGORY должен быть определен по крайней мере один элемент DEFAULTWORKITEMTYPE или WORKITEMTYPE.

У каждой категории есть понятное имя, а также ссылочное имя, которое в рамках проекта должно быть уникальным. Понятные имена категорий должны отвечать следующим требованиям:

  • Имена могут содержать до 254 символов юникода.

  • Имена не могут быть пустыми.

  • Имена не могут начинаться или заканчиваться пробелом.

  • Имена не должны содержать символы обратной косой черты (\).

  • Имена не должны содержать два последовательных пробела.

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

Сведения о соглашениях по именованию ссылок см. в разделе Соглашения об именовании объектов отслеживания рабочих элементов.

Средства Agile, требования к категориям и ограничения

Можно определить, какие типы рабочих элементов считаются элементами невыполненной работы, а какие — элементами задач. Например, шаблон процесса Scrum присваивает типам "Ошибка" и "Элемент невыполненной работы по продукту" категорию "Требования", шаблон Agile присваивает категорию "Пользовательская история", а шаблон CMMI присваивает категорию "Требование". Все шаблоны процесса по умолчанию присваивают рабочим элементам типа "Задача" категорию задач.

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

  • Для использования досок невыполненной работы и задач необходимо присвоить по крайней мере одному типу рабочих элементов категорию требований и еще одному типу рабочих элементов — категорию задач.

  • Невозможно присвоить одному и тому же типу рабочих элементов категорию требований и категорию задач.

  • Если включить несколько типов рабочих элементов в категорию требований или категорию задач, тип, назначенный элементу DEFAULTWORKITEMTYPE, отображается как тип по умолчанию на страницах невыполненной работы и досок Agile.

  • Для всех типов рабочих элементов, которым назначена категория, указанная в файле ProcessConfiguration, необходимо назначить допустимые метасостояния состояний рабочего процесса, как описано в разделе Справочник по XML-элементам конфигурации процесса. Несколько клиентов Team Foundation ссылаются на присвоения категорий и метасостояний, определенные в файле ProcessConfiguration.

Пример

В следующем примере приведен XML-файл категорий по умолчанию для шаблона проекта Visual Studio Scrum 2013.3.

<?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="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>

Сведения об элементе

Пространство имен

https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/categories

Имя схемы

Категории

Файл проверки

Categories.xsd

Тип элемента

CATEGORIES, CATEGORY, DEFAULTWORKITEMTYPE, WORKITEMTYPE

Может быть пустым

Да

См. также

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

Использование категорий для группировки типов рабочих элементов