Compartilhar via


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

Elemento

Atributo

Descrição

CATEGORIES

 

Elemento necessário no arquivo XML categorias.

Elemento de contêiner para especificar um ou mais CATEGORY elementos que são definidos para um projeto de equipe.

CATEGORY

 

Obrigatório CATEGORIES filho elemento.

Especifica um grupo de categoria nomeado que contém um padrão DEFAULTWORKITEMTYPE elemento e zero ou mais WORKITEMTYPE elementos.

 

name

Obrigatório CATEGORY atributo.

O tipo de atributo é typelib:FriendlyName.

Especifica o nome de exibição da categoria. Deve estar entre 1 a 254 caracteres e exclusivo no projeto de equipe.

 

refname

Obrigatório CATEGORY atributo.

O tipo de atributo é typelib:ReferenceName.

Para obter mais informações, consulte Convenções de nomenclatura para objetos de rastreamento de Item de trabalho.

DEFAULTWORKITEMTYPE

 

Obrigatório CATEGORY elemento.

Especifica um tipo de item de trabalho a ser marcado como pertencente à categoria nomeada e a ser usado como o tipo padrão para a categoria.

 

name

Obrigatório DEFAULTWORKITEMTYPE atributo.

O tipo de atributo é WorkItemTypeRef.

Especifica o nome de referência de um tipo de item de trabalho válida para o projeto de equipe que será usado como o tipo padrão para a categoria.

WORKITEMTYPE

 

Opcional CATEGORY elemento.

Especifica um tipo de item de trabalho a ser marcado como pertencente à categoria nomeada.

 

name

Obrigatório WORKITEMTYPE atributo.

O tipo de atributo é WorkItemTypeRef.

Especifica o nome de referência de um tipo de item de trabalho válida para o projeto de equipe pertencerá à categoria nomeada.

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

Namespace

https://schemas.microsoft.com/VisualStudio/2008/WorkItemTracking/Categories

Nome de esquema

Categorias

Arquivo de validação

Categories.xsd

Tipo de elemento

CATEGORIAS, CATEGORIA, DEFAULTWORKITEMTYPE, WORKITEMTYPE

Pode ficar vazio

Sim

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