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

Você usa o elemento de CATEGORIES 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 categorias.

Elementos filhos e atributos

Comentários

CATEGORIES é o elemento raiz do esquema de categorias.

Uma categoria é definida dentro de CATEGORIES conjunto de elementos de CATEGORY que é armazenada e usado por um projeto de equipe.Cada elemento de CATEGORIES deve ter pelo menos um elemento de CATEGORY definido.

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

Cada categoria tem um nome amigável e um nome de referência que devem ser únicos no projeto de equipe.Cada nome amigável de categoria deve atender aos seguintes requisitos:

• Os nomes podem ter até 254 caracteres Unicode.

• Os nomes não devem estar vazios.

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

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

• Os nomes não podem conter os dois espaços em branco consecutivos.

Os nomes amigáveis de categoria não são localizados e não podem ser feitas em um símbolo, enquanto os nomes para tipos de itens de trabalho são localizados e podem ser feitas em um token.

Para convenções de nomenclatura de referência, consulte As 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 a um projeto de equipe.Define quatro categorias e atribuir 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 de elemento

Definição do esquema de categoria

A seguir lista de códigos a definição de esquema para o objeto de acompanhamento de item de trabalho 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

Outros recursos

Definir categorias para agrupar os tipos de item de trabalho