Referencia de elementos XML de categorías

Artículo
11/18/2015

El elemento CATEGORIES se 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 utilizadas por Visual Studio Online y 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>

Atributos y elementos

Elemento	Atributo	Descripción
CATEGORIES		Elemento necesario dentro del archivo de categorías XML. Elemento contenedor para especificar uno o más elementos CATEGORY que se definen para un proyecto de equipo.
CATEGORY		Elemento secundario CATEGORIES necesario. Especifica un grupo de categorías con nombre que contiene un elemento DEFAULTWORKITEMTYPE predeterminado y cero o más elementos WORKITEMTYPE.
	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 debe ser único dentro del proyecto de equipo.
	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 Convenciones de nomenclatura para objetos de seguimiento de elementos de trabajo.
DEFAULTWORKITEMTYPE		Elemento CATEGORY necesario. 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 de equipo que se usará como tipo predeterminado de 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 de equipo 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 conjunto CATEGORIES de los elementos CATEGORY que está almacenado y es utilizado por un proyecto de equipo. Cada elemento CATEGORIES debe tener al menos un elemento CATEGORY definido.

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

Cada categoría tiene un nombre descriptivo y un nombre de referencia que deben ser únicos dentro del proyecto de equipo. 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 utilizar los paneles de trabajo pendiente y de tareas, debe asignar al menos un WIT a la categoría de requisitos y un WIT a la categoría de tarea.
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 en la categoría de tarea, el tipo asignado al elemento DEFAULTWORKITEMTYPE aparece como el tipo predeterminado en las páginas de trabajo pendiente y de panel 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 el estado de al menos un flujo de trabajo intermedio asignados a un metaestado válido, como se describe en Referencia de elemento XML de la configuración del proceso.
Los WIT que se asignan a la categoría de error pueden configurarse para aparecer en trabajos pendientes y paneles de todos los equipos. El comportamiento predeterminado se establece definiendo 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="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>

Vea también

Otros recursos

Usar categorías para agrupar tipos de elementos de trabajo

Compartir a través de