Referência a elementos XML de categorias

Artigo
06/09/2015

Você usa o CATEGORIES elemento para definir uma ou mais categorias para agrupar tipos de item de trabalho.

<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

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		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. Para obter mais informações, consulte Convenções de nomenclatura para objetos de acompanhamento de itens 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 do 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 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. 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.

Para obter referência convenções de nomenclatura, consulte Convenções de nomenclatura para objetos de acompanhamento de itens de trabalho.

Ferramentas do Agile, categoria requisitos e restrições

Você pode especificar quais tipos de itens de trabalho são considerados como itens de lista de pendências ou itens de tarefas. Por exemplo, o modelo de processo do Scrum atribui os tipos de Item de lista de pendências de produto e de Bug à categoria de requisitos, enquanto o modelo Agile atribui história de usuário e o modelo CMMI atribui requisito. Todos os modelos de processo padrão atribuir o tipo de tarefa do item de trabalho para a categoria de tarefa.

Ao atribuir os tipos de item de trabalho a categorias, considere as seguintes observações operacionais:

Para usar o pendências e tarefa placas, você deve atribuir o tipo de item de trabalho pelo menos uma para a categoria de requisitos e o tipo de item de um trabalho à categoria de tarefa.
Você não pode atribuir o mesmo tipo de item de trabalho à categoria de requisitos e a categoria de tarefa.
Se você incluir mais de um tipo de item de trabalho na categoria de requisitos ou a categoria de tarefa, o tipo atribuído a DEFAULTWORKITEMTYPE elemento aparece como o tipo de padrão nas páginas de lista de pendências e placa Agile.
Para todos os tipos de item trabalho atribuído a uma categoria que é referenciada no arquivo ProcessConfiguration, você deve atribuir os estados de fluxo de trabalho para um arquivo metaestado conforme descrito em referência a elementos XML de configuração do processo. Vários Team Foundation clientes fazem referência a categoria e as atribuições de metaestado definidas no arquivo ProcessConfiguration.

Exemplo

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

<?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="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>

Informações do elemento

Namespace	https://schemas.microsoft.com/VisualStudio/2008/WorkItemTracking/Categories
Nome do esquema	Categorias
Arquivo de validação	Categories.xsd
Tipo de elemento	CATEGORIAS, CATEGORIA, DEFAULTWORKITEMTYPE, WORKITEMTYPE
Pode estar vazio	Sim

Consulte também

Outros recursos

Usar categorias para agrupar tipos de itens de trabalho

Share via