Referência a elementos XML de categorias

Artigo
11/18/2015

Você usa o CATEGORIES elemento para agrupar tipos de item de trabalho (WITs). Usar categorias para agrupar tipos de item de trabalho fornece uma descrição de cada uma das categorias padrão usadas pelo Visual Studio Online e Team Foundation Server (TFS).

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

Elementos e atributos

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		Necessário CATEGORIES elemento filho. Especifica um grupo de categorias nomeado que contém um padrão DEFAULTWORKITEMTYPE elemento e zero ou mais WORKITEMTYPE elementos.
	name	Atributo CATEGORY obrigatório. O tipo de atributo é typelib:FriendlyName. Especifica o nome de exibição da categoria. Deve estar entre 1 a 254 caracteres e exclusivo dentro do projeto de equipe.
	refname	Atributo CATEGORY obrigatório. O tipo de atributo é typelib:ReferenceName. Especifique um nome não mais de 70 caracteres Unicode que usa alfanuméricos, sublinhados e hífens. O nome de referência deve conter pelo menos um ponto (.), mas nenhum período pode aparecer no início ou no final de um nome. Além disso, o nome de referência não pode começar com um número ou um sublinhado e não pode ter vários hifens consecutivos, como (-). Não especifique um nome que se sobrepõe com o sistema reservado. XXX e Microsoft. XXX namespaces. Consulte As convenções de nomenclatura para objetos de rastreamento de Item de trabalho.
DEFAULTWORKITEMTYPE		Necessá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	Atributo DEFAULTWORKITEMTYPE obrigatório. 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	Atributo WORKITEMTYPE obrigatório. 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 pertence à 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 elemento CATEGORIES deve ter pelo menos um elemento CATEGORY definido.

Uma categoria não pode ficar 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. Nome amigável de cada 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 no início ou no fim.
Os nomes não devem conter caracteres de barra invertida (\).
Os nomes não podem conter dois espaços em branco 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.

Ferramentas do Agile, categoria requisitos e restrições

Ao atribuir WITs a categorias, considere as seguintes observações operacionais:

Para usar as placas lista de pendências e tarefa, você deve atribuir pelo menos um WIT para a Categoria de Requisitos e um WIT para a Categoria de Tarefa.
Você não pode atribuir o mesmo WIT para a Categoria de Requisitos e para a Categoria de Tarefa.
Se você incluir mais de um WIT na Categoria de Requisitos ou na Categoria de Tarefa, o tipo atribuído para o elemento DEFAULTWORKITEMTYPE aparece como o tipo padrão na lista de pendências do Agile e páginas de placa.
WITs que pertencem a uma categoria que define uma lista de pendências no arquivo ProcessConfiguration devem ter início, fechar, e estado de pelo menos um fluxo de trabalho intermediária napped para válido metaestado conforme descrito em referência a elementos XML de configuração do processo.
WITs que você atribui à categoria de Bug podem ser configurados para aparecerá em listas de pendências e placas para cada equipe. Definir o comportamento padrão definindo a propriedade para BugsBehavior no arquivo ProcessConfiguration.

Exemplo

O exemplo a seguir lista o arquivo XML de categorias padrão para o modelo de processo do Scrum.

<?xml version="1.0" encoding="utf-8"?>
<cat:CATEGORIES xmlns:cat="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/categories">
  <!-- Usage: for resilience in Test system. Even if WITs have different name, they can be referred to by the category -->
  <CATEGORY name="Bug Category" refname="Microsoft.BugCategory">
    <DEFAULTWORKITEMTYPE name="Bug" />
  </CATEGORY>
  <CATEGORY name="Epic Category" refname="Microsoft.EpicCategory">
    <DEFAULTWORKITEMTYPE name="Epic" />
  </CATEGORY>
  <CATEGORY name="Feature Category" refname="Microsoft.FeatureCategory">
    <DEFAULTWORKITEMTYPE name="Feature" />
  </CATEGORY>
  <CATEGORY name="Requirement Category" refname="Microsoft.RequirementCategory">
    <DEFAULTWORKITEMTYPE name="Product Backlog Item" />
    <WORKITEMTYPE name="Bug" />
  </CATEGORY>
  <CATEGORY name="Test Case Category" refname="Microsoft.TestCaseCategory">
    <DEFAULTWORKITEMTYPE name="Test Case" />
  </CATEGORY>
  <CATEGORY name="Shared Step Category" refname="Microsoft.SharedStepCategory">
    <DEFAULTWORKITEMTYPE name="Shared Steps" />
  </CATEGORY>
   <CATEGORY name="Shared Parameter Category" refname="Microsoft.SharedParameterCategory">
    <DEFAULTWORKITEMTYPE name="Shared Parameter" />
  </CATEGORY>
  <CATEGORY name="Code Review Request Category" refname="Microsoft.CodeReviewRequestCategory">
    <DEFAULTWORKITEMTYPE name="Code Review Request" />
  </CATEGORY>
  <CATEGORY name="Code Review Response Category" refname="Microsoft.CodeReviewResponseCategory">
    <DEFAULTWORKITEMTYPE name="Code Review Response" />
  </CATEGORY>
  <CATEGORY name="Feedback Request Category" refname="Microsoft.FeedbackRequestCategory">
    <DEFAULTWORKITEMTYPE name="Feedback Request" />
  </CATEGORY>
  <CATEGORY name="Feedback Response Category" refname="Microsoft.FeedbackResponseCategory">
    <DEFAULTWORKITEMTYPE name="Feedback Response" />
  </CATEGORY>
  <CATEGORY name="Test Plan Category" refname="Microsoft.TestPlanCategory">
    <DEFAULTWORKITEMTYPE name="Test Plan" />
  </CATEGORY>
  <CATEGORY name="Test Suite Category" refname="Microsoft.TestSuiteCategory">
    <DEFAULTWORKITEMTYPE name="Test Suite" />
  </CATEGORY>
  <CATEGORY name="Task Category" refname="Microsoft.TaskCategory">
    <DEFAULTWORKITEMTYPE name="Task" />
  </CATEGORY>
  <CATEGORY name="Hidden Types Category" refname="Microsoft.HiddenCategory">
    <DEFAULTWORKITEMTYPE name="Code Review Request" />
    <WORKITEMTYPE name="Code Review Response" />
    <WORKITEMTYPE name="Feedback Request" />
    <WORKITEMTYPE name="Feedback Response" />
    <WORKITEMTYPE name="Shared Steps" />
    <WORKITEMTYPE name="Shared Parameter" />
    <WORKITEMTYPE name="Test Plan" />
    <WORKITEMTYPE name="Test Suite" />
  </CATEGORY>
</cat:CATEGORIES>

Consulte também

Outros recursos

Usar categorias para agrupar tipos de itens de trabalho

Compartilhar via