Referencia de elementos XML de categorías

Artículo
11/30/2021
5 minutos para leer

Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013

El elemento se CATEGORIES usa para agrupar tipos de elementos de trabajo (WIT). Usar categorías para agrupar tipos de elementos de trabajo proporciona una descripción de cada una de las categorías predeterminadas que Team Foundation Server (TFS).

Sintaxis

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

Elemento	Atributo	Descripción
`CATEGORIES`		Elemento necesario dentro del archivo de categorías XML. Elemento contenedor para especificar uno o varios `CATEGORY` elementos definidos para un proyecto.
`CATEGORY`		Elemento `CATEGORIES` secundario requerido. Especifica un grupo de categorías con nombre que contiene un elemento `DEFAULTWORKITEMTYPE` predeterminado y cero o más `WORKITEMTYPE` elementos.
	`name`	El atributo `CATEGORY` es obligatorio. El tipo de atributo es `typelib:FriendlyName` . Especifica el nombre para mostrar de la categoría. Debe tener entre 1 y 254 caracteres y ser único dentro del proyecto.
	`refname`	El atributo `CATEGORY` es obligatorio. El tipo de atributo es `typelib:ReferenceName` . Especifique un nombre con un máximo de 70 caracteres Unicode que utilice caracteres alfanuméricos, subrayado y guión. El nombre de referencia debe contener al menos un punto (.), pero el punto no puede aparecer al principio o al final de un nombre. Además, el nombre de referencia no puede comenzar por un número o un carácter de subrayado, ni tampoco puede tener varios guiones consecutivos, como (--). No especifique un nombre que se superponga con el nombre reservado System. XXX y Microsoft. Espacios de nombres XXX. Vea Restricciones de nomenclatura, Objetos de seguimiento de elementos de trabajo.
`DEFAULTWORKITEMTYPE`		Elemento `CATEGORY` requerido. Especifica un tipo de elemento de trabajo que se va a etiquetar como perteneciente a la categoría con nombre y se va a usar como tipo predeterminado de la categoría.
	`name`	El atributo `DEFAULTWORKITEMTYPE` es obligatorio. El tipo de atributo es `WorkItemTypeRef` . Especifica el nombre de referencia de un tipo de elemento de trabajo válido para el proyecto que se usará como tipo predeterminado para la categoría.
`WORKITEMTYPE`		Elemento `CATEGORY` opcional. Especifica un tipo de elemento de trabajo que se va a etiquetar como perteneciente a la categoría con nombre.
	`name`	El atributo `WORKITEMTYPE` es obligatorio. El tipo de atributo es `WorkItemTypeRef` . Especifica el nombre de referencia de un tipo de elemento de trabajo válido para el proyecto que pertenecerá a la categoría con nombre.

Comentarios

CATEGORIES es el elemento raíz del esquema de categorías.

Una categoría se define dentro del CATEGORIES conjunto de CATEGORY elementos almacenados y usados por un proyecto. Cada CATEGORIES elemento debe tener al menos un elemento CATEGORY definido.

Una categoría no puede estar vacía. Cada CATEGORY elemento debe tener al menos un elemento o DEFAULTWORKITEMTYPEWORKITEMTYPE definido.

Cada categoría tiene un nombre descriptivo y un nombre de referencia que debe ser único dentro del proyecto. Cada nombre descriptivo de categorías debe cumplir los requisitos siguientes:

Los nombres pueden tener hasta 254 caracteres Unicode.
Los nombres no deben estar vacíos.
Los nombres no pueden tener espacios en blanco iniciales ni finales.
Los nombres no pueden contener caracteres de barra diagonal inversa (\).
Los nombres no pueden contener dos espacios en blanco consecutivos.

Los nombres descriptivos de categorías no están adaptados y no se pueden convertir en un token, mientras que los nombres de tipos de elemento de trabajo están adaptados y se pueden convertir en un token.

Herramientas, requisitos de categorías y restricciones de Agile

Al asignar WIT a categorías, tenga en cuenta las siguientes notas operativas:

Para usar el trabajo pendiente y los paneles de tareas, debe asignar al menos un WIT a la Categoría de requisitos y un WIT a la categoría de tareas.
No se puede asignar el mismo WIT a la categoría de requisitos y a la categoría de tarea.
Si incluye más de un WIT en la Categoría de requisitos o la Categoría de tareas, el tipo asignado al elemento aparece como el tipo predeterminado en las páginas de trabajo pendiente y panel DEFAULTWORKITEMTYPE de Agile.
Los WIT que pertenecen a una categoría que define un trabajo pendiente en el archivo ProcessConfiguration deben tener el inicio, el cierre y al menos un estado de flujo de trabajo intermedio pasado a un metaestado válido, como se describe en Referencia del elemento XMLde configuración de procesos .
Los WIT que asigne a la categoría de errores se pueden configurar para que se muestren en los paneles y los trabajo pendientes de cada equipo. Para establecer el comportamiento predeterminado, defina la propiedad para BugsBehavior en el archivo ProcessConfiguration.

Ejemplo

En el siguiente ejemplo se muestra el archivo XML de categorías predeterminadas para la plantilla de proceso de Scrum.

<?xml version="1.0" encoding="utf-8"?>  
<cat:CATEGORIES xmlns:cat="http://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>