Compartir a través de


Referencia de elementos XML de categorías

Use el elemento CATEGORIES para definir una o más categorías para agrupar tipos de elemento de trabajo.

<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

Atributos y elementos secundarios

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.

Para obtener más información, 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.

Para las convenciones de nomenclatura de referencias, consulte Convenciones de nomenclatura para objetos de seguimiento de elementos de trabajo.

Herramientas, requisitos de categorías y restricciones de Agile

Se puede especificar qué tipos de elementos de trabajo se consideran elementos de trabajo pendiente o elementos de tarea. Por ejemplo, la plantilla de proceso Scrum asigna los tipos Error y Elemento de trabajo pendiente del producto a la categoría de requisitos, mientras que la plantilla Agile asigna Caso de usuario y la plantilla CMMI asigna Requisito. Todas las plantillas de proceso predeterminadas asignan el tipo de tarea de elemento de trabajo a Categoría de tarea.

Al asignar tipos de elemento de trabajo a categorías, tenga en cuenta las siguientes notas operativas:

  • Para usar los paneles de trabajo pendiente y de tareas, debe asignar al menos un tipo de elemento de trabajo a la categoría de requisitos y otro 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 de tarea, el tipo asignado al elemento DEFAULTWORKITEMTYPE aparece como tipo predeterminado en las páginas de trabajo pendiente y de panel de Agile.

  • Para todos los tipos de elemento de trabajo que asigne a una categoría a la que se hace referencia en el archivo ProcessConfiguration, debe asignar los estados del flujo de trabajo a un metaestado válido como se describe en el tema de referencia del elemento XML de configuración de procesos. Varios clientes Team Foundation hacen referencia a asignaciones de categorías y metaestados definidos en el archivo ProcessConfiguration.

Ejemplo

En el siguiente ejemplo se muestra el archivo XML de categorías predeterminadas para la plantilla de proceso de 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>

Información de elemento

Espacio de nombres

https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/categories

Nombre de esquema

Categorías

Archivo de validación

Categories.xsd

Tipo de elemento

CATEGORIES, CATEGORY, DEFAULTWORKITEMTYPE, WORKITEMTYPE

Puede estar vacío

Vea también

Otros recursos

Usar categorías para agrupar tipos de elementos de trabajo