Referencia de todos los elementos XML WITD

Artículo
08/10/2011

Puede personalizar un tipo de elemento de trabajo existente o crear un tipo de elemento de trabajo para cumplir los requisitos de seguimiento del proyecto. Un tipo de elemento de trabajo define las reglas, los campos, los estados y las transiciones de un elemento de trabajo del que se efectuará un seguimiento para un proyecto de equipo, por ejemplo, errores, requisitos y riesgos.

Un tipo de elemento de trabajo no puede estar vacío. El elemento raíz de cada definición de un tipo de elemento de trabajo es el elemento WITD, que debe tener solo un elemento WORKITEMTYPE definido. El nombre de cada tipo de elemento de trabajo debe ser único en un proyecto de equipo y cada nombre de tipo debe tener no más de 254 caracteres Unicode de longitud. Para obtener más información, vea Convenciones de nomenclatura para objetos de seguimiento de elementos de trabajo.

Para personalizar o crear una definición de tipo de elemento de trabajo, modifique el archivo XML de la definición de tipo asociado al tipo de elemento de trabajo. Las definiciones de los tipos de elementos de trabajo se mantienen y administran para cada proyecto de equipo.

En este tema

Estructura de la sintaxis WITD
Elementos secundarios WITD
Tipos de elemento de trabajo de la plantilla de proceso

Estructura de la sintaxis WITD

En el ejemplo siguiente se muestra la estructura de alto nivel de un tipo de elemento de trabajo.

<WITD application="work item type editor" version="1.0">
    <WORKITEMTYPE name="bug">
        <DESCRIPTION>Bug work item types are used to track defects in the code.</DESCRIPTION>
        <GLOBALLISTS> . . . </GLOBALLISTS>
        <FIELDS> . . . </FIELDS>
        <WORKFLOW> . . . </WORKFLOW>
        <FORM> . . . </FORM>
    </WORKITEMTYPE>
</WITD>

En los niveles superiores de la definición de tipo de elemento de trabajo, aparece un pequeña cantidad de elementos XML entre etiquetas WORKITEMTYPE. Para comenzar, defina un tipo de elemento de trabajo proporcionando un nombre y una descripción. También puede utilizar algunas etiquetas XML estándar para ajustar la definición de tipo de elemento de trabajo.

Elementos secundarios WITD

En la tabla siguiente se describen los elementos estructurales utilizados en el ejemplo anterior:

Elemento	Descripción
WITD	La etiqueta WITD contiene toda la definición de tipo de elemento de trabajo. Puede utilizar cualquier nombre como nombre de aplicación. La versión identifica el esquema del tipo de elemento de trabajo que cambia de una versión a la siguiente. Utilice "1.0". `<WITD application="Work item type editor" version="1.0 [1]"> <WORKITEMTYPE> . . .</WORKITEMTYPE> </WITD>`
WORKITEMTYPE	Los nombres de los tipos de elementos de trabajo deben ser únicos en un proyecto de equipo concreto. En tiempo de ejecución, utilice el nombre especificado por este elemento. Por ejemplo, el nombre puede aparecer como una opción de menú. En este caso, el usuario podría hacer clic en Error en el menú Nuevo elemento de trabajo. `<WORKITEMTYPE name="WorkItemTypeName"> <DESCRIPTION>Text</DESCRIPTION> <GLOBALLISTS> . . .</</GLOBALLISTS> <FIELDS> . . . </FIELDS> <WORKFLOW> . . . </WORKFLOW> <FORM> . . .</</FORM> </WORKITEMTYPE>`
DESCRIPTION	Especifica una cadena que describe el tipo de elemento de trabajo que se está definiendo. La descripción debe ayudar a cualquier usuario que esté personalizando el tipo de elemento de trabajo. Nota La descripción solo se puede ver en la definición XML.No se puede en ningún otro lugar de la interfaz de usuario y no tiene ninguna relación con el campo System.Definition. `<DESCRIPTION> DescriptionOfWorkItemType</DESCRIPTION>` Se especifica una cadena de texto que describe el tipo de elemento de trabajo que se está definiendo.
GLOBALLISTS	Contiene las definiciones de lista globales utilizadas por el tipo de elemento de trabajo. Utilice las listas globales para compartir elementos de lista entre varios tipos de elemento de trabajo para una colección de proyectos de equipo. El uso de listas globales proporciona soporte para la facilidad de mantenimiento y la colaboración entre grupos. `<GLOBALLIST name="globalListName"> <LISTITEM> . . . </LISTITEM> </GLOBALLIST>` Para obtener más información, vea Definir listas globales.
FIELDS	Contiene el conjunto de definiciones de campo que utiliza el tipo de elemento de trabajo. Dentro del elemento FIELDS, defina todos los campos que desee utilizar para realizar el seguimiento de los datos para el tipo de elemento de trabajo. Esto incluye los campos que utilizará para ejecutar consultas y generar informes. `<FIELDS> <FIELD> . . . </FIELD> </FIELDS>` Para obtener más información, vea Trabajar con campos de elementos de trabajo.
WORKFLOW	Contiene el conjunto de elementos TRANSITION y STATE que definen el flujo de trabajo del tipo de elemento de trabajo. El flujo de trabajo es un conjunto de transiciones válidas de uno estado a otro y las condiciones específicas asociadas a cada transición. `<WORKFLOW> <STATES> . . . </STATES> <TRANSITIONS> . . . </TRANSITIONS> </WORKFLOW>` Para obtener más información, vea Definir y personalizar el flujo de trabajo de los elementos de trabajo.
FORM	Contiene LAYOUT, CONTROL, GROUP, TAB, TABGROUP, SPLITTER y otros elementos que definen qué campos y controles aparecen en el formulario, así como la presentación de estos elementos en el formulario para el tipo de elemento de trabajo. `<FORM> <Layout> . . . </Layout> </FORM>` Para obtener más información, vea Diseñar y personalizar un formulario de elementos de trabajo.

Tipos de elemento de trabajo de la plantilla de proceso

Hay dos conjuntos de definiciones de tipo de elemento de trabajo de plantilla de proceso disponibles para que los utilice, que corresponden a las definidas para Microsoft Solutions Framework (MSF) for Agile Software Development v5.0 y MSF for Capability Maturity Model Integration (CMMI) Software Development v5.0. Estos archivos se encuentran en el directorio de instalación en las siguientes ubicaciones, respectivamente:

Unidad:\Archivos de programa\Microsoft Visual Studio v10.0 Team Foundation Server\Application Tier\Web Services\Deploy\ProcessTemplateManagerFiles\MsfAgile\Template.zip
Unidad:\Archivos de programa\Microsoft Visual Studio v10.0 Team Foundation Server\Application Tier\Web Services\Deploy\ProcessTemplateManagerFiles\MsfFormal\Template.zip

Puede encontrar las definiciones de tipo de elemento de trabajo en la carpeta WorkItem Tracking\TypeDefinitions del archivo Template.zip. Por ejemplo, MSF for Agile Software Development v5.0 define un archivo XML para cada uno de los siguientes tipos de elemento de trabajo: Bug, Issue, SharedStep, Task, TestCase y User Story. Para obtener más información sobre cada uno de estos tipos de elemento de trabajo, consulte MSF for Agile Software Development v5.0.

Puede personalizar o crear archivos de definición de tipos en la carpeta TypeDefinitions. A continuación, puede importar el nuevo tipo de elemento de trabajo a un proyecto único o agregarlo a la plantilla de procesos y cargar la plantilla modificada en Team Foundation Server. Para obtener más información, vea Agregar definiciones de tipo de elementos de trabajo a una plantilla de procesos.

Vea también

Conceptos

Diseñar y personalizar un formulario de elementos de trabajo

Personalizar datos de seguimiento, formularios, flujos de trabajo y otros objetos de proyecto

Otros recursos

Definir campos de elementos de trabajo

Definir y personalizar el flujo de trabajo de los elementos de trabajo

witAdmin: Administrar objetos para el seguimiento de elementos de trabajo

Historial de cambios

Fecha	Historial	Motivo
Enero de 2011	Agregada información sobre flujos de trabajo globales y eliminada la sección sobre la definición de esquema.	Mejora de la información.

Enero de 2011

Agregada información sobre flujos de trabajo globales y eliminada la sección sobre la definición de esquema.

Mejora de la información.