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

Artigo
03/12/2013

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

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

Compartilhar via