Referencia del esquema de definición de categorías

Utilice el elemento CATEGORIES para definir una o más categorías para agrupar los tipos de elemento de trabajo.

Jerarquía del esquema

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>

Atributos y elementos

En las secciones siguientes se describen los atributos y elementos del archivo XML de categorías.

Atributos y elementos secundarios

Elemento	Atributo	Descripción
CATEGORIES		Elemento necesario dentro del archivo de categorías de XML. Elemento contenedor para especificar uno o más elementos CATEGORY que se definen para un proyecto de equipo.
CATEGORY		Elemento CATEGORIES secundario obligatorio. Especifica un grupo de categorías con nombre que contiene un elemento DEFAULTWORKITEMTYPE predeterminado y cero o más elementos WORKITEMTYPE.
	name	El atributo CATEGORY es obligatorio. El tipo de atributo es typelib:FriendlyName. Especifica el nombre para mostrar de la categoría. Debe tener entre 1 a 254 caracteres y debe ser único dentro del proyecto de equipo.
	refname	El atributo CATEGORY es obligatorio. El tipo de atributo es typelib:ReferenceName. Para obtener más información, vea Convenciones de nomenclatura para objetos de seguimiento de elementos de trabajo.
DEFAULTWORKITEMTYPE		Elemento CATEGORY obligatorio. Especifica un tipo de elemento de trabajo que se desea etiquetar como perteneciente a la categoría con nombre y se desea utilizar como tipo predeterminado para la categoría.
	name	El atributo DEFAULTWORKITEMTYPE es obligatorio. El tipo de atributo es WorkItemTypeRef. Especifica el nombre de referencia de un tipo de elemento de trabajo válido para el proyecto de equipo que se utilizará como tipo predeterminado para la categoría.
WORKITEMTYPE		Elemento CATEGORY opcional. Especifica un tipo de elemento de trabajo que se desea etiquetar como perteneciente a la categoría especificada.
	name	El atributo WORKITEMTYPE es obligatorio. El tipo de atributo es WorkItemTypeRef. Especifica el nombre de referencia de un tipo de elemento de trabajo válido para el proyecto de equipo que pertenecerá a la categoría especificada.

Comentarios

CATEGORIES es el elemento raíz del esquema de categorías.

Una categoría se define dentro del conjunto CATEGORIES de los elementos CATEGORY que está almacenado y es utilizado por un proyecto de equipo. Cada elemento CATEGORIES debe tener al menos un elemento CATEGORY definido.

Una categoría no puede estar vacía. Cada elemento CATEGORY debe tener al menos un elemento DEFAULTWORKITEMTYPE o WORKITEMTYPE definido.

Cada categoría tiene un nombre descriptivo y un nombre de referencia que deben ser únicos dentro del proyecto de equipo. Cada nombre descriptivo de categoría debe cumplir los requisitos siguientes:

• Los nombres pueden tener hasta 254 caracteres Unicode.

• Los nombres no deben estar vacíos.

• Los nombres no pueden tener espacios en blanco iniciales ni finales.

• Los nombres no pueden contener caracteres de barra diagonal inversa (\).

• Los nombres no pueden contener dos espacios en blanco consecutivos.

Los nombres descriptivos de categorías no están adaptados y no se pueden convertir en un token, mientras que los nombres de los tipos de elemento de trabajo están adaptados y se pueden convertir en un token.

Para las convenciones de nomenclatura de referencias, vea Convenciones de nomenclatura para objetos de seguimiento de elementos de trabajo.

Ejemplo

En el ejemplo siguiente se especifica un archivo XML de categorías que se puede importar en un proyecto de equipo. Define cuatro categorías y asigna solo un tipo de elemento de trabajo predeterminado para cada una.

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

Información del elemento

Espacio de nombres	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/categories
Nombre de esquema	Categorías
Archivo de validación	Categories.xsd
Tipo de elemento	CATEGORÍAS, CATEGORÍA, DEFAULTWORKITEMTYPE, WORKITEMTYPE
Puede estar vacío	Sí

Definición de esquema de categoría

El código siguiente enumera la definición de esquema del objeto de seguimiento del elemento de trabajo de categorías:

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

Vea también

Tareas

Crear una categoría para los tipos de elementos de trabajo

Otros recursos

Agrupar los tipos de elemento de trabajo en categorías