Referencia de elementos XML de categorías

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

El elemento se usa CATEGORIES para agrupar los tipos de elementos de trabajo. Usar categorías para agrupar tipos de elementos de trabajo proporciona una descripción de cada una de las categorías predeterminadas.

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 secundario obligatorio CATEGORIES .

Especifica un grupo de categorías con nombre que contiene un elemento predeterminado DEFAULTWORKITEMTYPE 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. Consulte Restricciones de nomenclatura, Objetos de seguimiento de elementos de trabajo.
DEFAULTWORKITEMTYPE Elemento obligatorio CATEGORY .

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 opcional CATEGORY .

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.

Observaciones

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 CATEGORY elemento definido.

Una categoría no puede estar vacía. Cada CATEGORY elemento debe tener al menos un DEFAULTWORKITEMTYPE elemento o WORKITEMTYPE 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.

Azure Boards herramientas, requisitos de categoría y restricciones

Al asignar tipos de elemento de trabajo 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 tipo de elemento de trabajo a la Categoría de requisitos y un tipo de elemento de trabajo a la Categoría de tarea.

  • No se puede asignar el mismo tipo de elemento de trabajo a la categoría de requisitos y a la de tarea.

  • Si incluye más de un tipo de elemento de trabajo en la Categoría de requisitos o en la Categoría de tarea, el tipo asignado al DEFAULTWORKITEMTYPE elemento aparece como el tipo predeterminado en las páginas de trabajo pendiente y de panel de Azure Boards.

  • Los tipos de elementos de trabajo 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 intermedio del flujo de trabajo asignado a un metastate válido, tal como se describe en Referencia de elementos XML de configuración de procesos.

  • Los tipos de elementos de trabajo que se asignan a la categoría de errores se pueden configurar para mostrarse en trabajos pendientes y paneles para cada equipo. Para establecer el comportamiento predeterminado, defina la propiedad de 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 work item types 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>