Справочник по схеме определения категорий

Статья
08/11/2011

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

Иерархия схемы

CATEGORIES Element (CATEGORIES Definition Schema)

** CATEGORY Element (CATEGORIES Definition Schema)**

** DEFAULTWORKITEMTYPE Element (CATEGORIES Definition Schema)**

** WORKITEMTYPE Element (CATEGORIES Definition Schema)**

<xs:element name="CATEGORIES">
<xs:element name="CATEGORY" minOccurs="0" maxOccurs="unbounded">
<xs:element name="DEFAULTWORKITEMTYPE" type="WorkItemTypeRef" />
<xs:element name="WORKITEMTYPE" type="WorkItemTypeRef" minOccurs="0" maxOccurs="unbounded"/>

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

Атрибуты и элементы

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

Дочерние элементы и атрибуты

Элемент	Атрибут	Описание
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 символов юникода.
Имена не могут быть пустыми.
Имена не могут начинаться или заканчиваться пробелом.
Имена не должны содержать символы обратной косой черты (\).
Имена не должны содержать два последовательных пробела.

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

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

Пример

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

<?xml version="1.0" encoding="utf-8"?>
<cat:CATEGORIES xmlns:cat="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/categories">
   <CATEGORY refname="Microsoft.BugCategory" name="Bug Category">
      <DEFAULTWORKITEMTYPE name="Bug" />
   </CATEGORY>
   <CATEGORY refname="Microsoft.RequirementCategory" name="Requirement Category">
      <DEFAULTWORKITEMTYPE name="User Story" />
   </CATEGORY>
   <CATEGORY refname="Microsoft.SharedStepCategory" name="Shared Step Category">
      <DEFAULTWORKITEMTYPE name="Shared Steps" />
   </CATEGORY>
   <CATEGORY refname="Microsoft.TestCaseCategory" name="Test Case Category">
      <DEFAULTWORKITEMTYPE name="Test Case" />
   </CATEGORY>
</cat:CATEGORIES>

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

Пространство имен	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/categories
Имя схемы	Категории
Файл проверки	Categories.xsd
Тип элемента	CATEGORIES, CATEGORY, DEFAULTWORKITEMTYPE, WORKITEMTYPE
Может быть пустым	Да

Определение схемы категорий

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

<?xml version="1.0" encoding="utf-8" ?> 
<xs:schema targetNamespace="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/categories"
  elementFormDefault="unqualified"
  attributeFormDefault="unqualified"
  xmlns="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/categories"
  xmlns:xs="http://www.w3.org/2001/XMLSchema"
  xmlns:typelib="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/typelib">  
  <xs:import namespace="https://schemas.microsoft.com/VisualStudio/2009/workitemtracking/typelib"/> 
  <xs:element name="CATEGORIES">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="CATEGORY" minOccurs="0" maxOccurs="unbounded">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="DEFAULTWORKITEMTYPE" type="WorkItemTypeRef" />
              <xs:element name="WORKITEMTYPE" type="WorkItemTypeRef" minOccurs="0" maxOccurs="unbounded"/>
            </xs:sequence>
            <xs:attribute name="refname" type="typelib:ReferenceName" use="required"/>
            <xs:attribute name="name" type="typelib:FriendlyName" use="required"/>
          </xs:complexType>
          <xs:unique name="WorkItemTypeName">
            <xs:selector xpath="*"/>
            <xs:field xpath="@name"/>
          </xs:unique>
        </xs:element>
      </xs:sequence>
    </xs:complexType>
    <xs:unique name="CategoryRefName">
      <xs:selector xpath="CATEGORY"/>
      <xs:field xpath="@refname"/>
    </xs:unique>
    <xs:unique name="CategoryName">
      <xs:selector xpath="CATEGORY"/>
      <xs:field xpath="@name"/>
    </xs:unique>
  </xs:element>
  <xs:complexType name="WorkItemTypeRef">
    <xs:attribute name="name" type="typelib:NonEmptyPlainConstant" use="required"/>
  </xs:complexType>
</xs:schema>

См. также

Задачи

Создание категории для типов рабочих элементов

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

Группирование типов рабочих элементов по категориям

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