Referência de esquema de definição de categorias

Você pode usar o CATEGORIES elemento para definir uma ou mais categorias para agrupar tipos de item de trabalho.

Hierarquia de 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 e elementos

As seções a seguir descrevem os atributos e elementos para o arquivo XML de categorias.

Atributos e elementos filho

Comentários

CATEGORIESé o elemento raiz do esquema de categorias.

Uma categoria é definida dentro de CATEGORIES conjunto de CATEGORY elementos que são armazenadas e usadas por um projeto de equipe. Cada CATEGORIES elemento deve ter pelo menos um CATEGORY elemento definido.

Uma categoria não pode estar vazia. Cada CATEGORY elemento deve ter pelo menos um DEFAULTWORKITEMTYPE ou WORKITEMTYPE elemento definido.

Cada categoria tem um nome amigável e um nome de referência deve ser exclusivo dentro do projeto de equipe. O nome amigável de cada categoria deve atender aos seguintes requisitos:

• Os nomes podem ter até 254 caracteres do Unicode.

• Nomes não devem estar vazios.

• Nomes não podem ter os espaços em branco à direita ou à esquerda.

• Nomes não podem conter caracteres de barra invertida (\).

• Nomes não podem conter espaços consecutivos.

Nomes amigáveis de categoria não são localizados e não podem ser transformados em um token, enquanto os nomes de tipos de item de trabalho são localizados e podem ser feitos em um token.

Para obter as convenções de nomenclatura de referência, consulte Convenções de nomenclatura para objetos de rastreamento de Item de trabalho.

Exemplo

O exemplo a seguir especifica um arquivo XML de categorias que pode ser importado para um projeto de equipe. Ele define quatro categorias e atribui a apenas um tipo de item de trabalho padrão para cada um.

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

Informações do elemento

Definição de esquema de categoria

O código a seguir lista a definição de esquema para o objeto de rastreamento de item de trabalho de categorias:

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

Consulte também

Tarefas

Criar uma categoria para tipos de itens de trabalho

Outros recursos

O agrupamento de tipos de Item de trabalho em categorias