Compartilhar via


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.

Dd469527.collapse_all(pt-br,VS.110).gifElementos filhos e atributos

Elemento

Atributo

Descrição

CATEGORIES

 

Elemento necessário em categorias do arquivo XML.

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

CATEGORY

 

Elemento filho de CATEGORIES necessário.

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

 

name

Atributo necessário de CATEGORY .

O tipo do atributo é typelib:FriendlyName.

Especifica o nome para exibição de categoria.Deve estar entre 1 a 254 caracteres e exclusivas dentro do projeto de equipe.

 

refname

Atributo necessário de CATEGORY .

O tipo do atributo é typelib:ReferenceName.

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

DEFAULTWORKITEMTYPE

 

Elemento de CATEGORY necessário.

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

 

name

Atributo necessário de DEFAULTWORKITEMTYPE .

O tipo do atributo é WorkItemTypeRef.

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

WORKITEMTYPE

 

Elemento de CATEGORY opcional.

Especifica um tipo de item de trabalho a ser marcado como pertence à categoria chamado.

 

name

Atributo necessário de WORKITEMTYPE .

O tipo do atributo é WorkItemTypeRef.

Especifica o nome da referência de um tipo de item de trabalho válido para o projeto de equipe que pertencerá a categoria chamado.

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

Namespace

https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/categories

Nome de esquema

Categorias

Validação Arquivo

Categories.xsd

Tipo de elemento

CATEGORIAS, CATEGORIA, DEFAULTWORKITEMTYPE, WORKITEMTYPE

Pode ser deixado

Sim

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