Referencia de todos los elementos WITD de XML
Puede personalizar un tipo de elemento de trabajo existente (WIT) o crear un WIT que cumpla sus requisitos de seguimiento de proyectos. Un WIT define las reglas, los campos, los estados del flujo de trabajo 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. Los equipos de proyecto se crean en Visual Studio Online o en un servidor de Team Foundation Server (TFS) local.
El elemento raíz de cada definición de un WIT es el elemento WITD, que debe tener solo un elemento WORKITEMTYPE definido. El nombre de cada WIT debe ser único en un proyecto de equipo y cada nombre de tipo no debe tener más de 128 caracteres Unicode de longitud.
Para personalizar o crear una definición de WIT, modifique el archivo XML de definición de tipos. Los WIT se aplican a un proyecto de equipo dentro de una colección de proyectos.
Estructura de la sintaxis WITD
En el ejemplo siguiente se muestra la estructura de alto nivel de una definición de WIT.
<witd:WITD application="Work item type editor" version="1.0" xmlns:witd="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef">
<WORKITEMTYPE name="bug" refname="Microsoft.VSTS.WorkItemTypes.Bug">
<DESCRIPTION> Describes a divergence between required and actual behavior, and tracks the work done to correct the defect and verify the correction.</DESCRIPTION>
<GLOBALLISTS> . . . </GLOBALLISTS>
<FIELDS> . . . </FIELDS>
<WORKFLOW> . . . </WORKFLOW>
<FORM> . . . </FORM>
</WORKITEMTYPE>
</witd:WITD>
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 WIT. Puede utilizar cualquier nombre como nombre de aplicación. La versión identifica el esquema WIT, que puede cambiar de una versión a la siguiente. Utilice "1.0". |
WORKITEMTYPE |
Los nombres de los WIT 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 elegir Error en el menú Nuevo elemento de trabajo. Nombre descriptivo: este nombre aparece en los menús desplegables de las consultas de elementos de trabajo. El nombre descriptivo debe ser único en todos los nombres de WIT definidos en un proyecto de equipo. Especifique un nombre con un máximo de 128 caracteres Unicode que utilice caracteres alfanuméricos, subrayado y guión. Nombre de referencia: 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. |
DESCRIPCIÓN |
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 WIT. 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. 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 WIT. Utilice las listas globales para compartir listas de selección entre varios WIT definidos para una colección de proyectos de equipo. El uso de listas globales facilita el mantenimiento y la colaboración entre grupos. |
FIELDS |
Define los campos que se utilizan para realizar el seguimiento del WIT. En el elemento FIELDS se definen todos los campos que se van a utilizar para hacer el seguimiento de los datos. Esto incluye los campos que utilizará para ejecutar consultas y generar informes. |
WORKFLOW |
Define los elementos del flujo de trabajo que ayudan a realizar un seguimiento del estado de elemento de trabajo cuando su estado cambia de nuevo a cerrado o listo. Este elemento contiene el conjunto de elementos STATE y TRANSITION que define el flujo de trabajo. El flujo de trabajo es un conjunto de transiciones válidas de un estado a otro y las condiciones específicas asociadas con cada transición. |
FORM |
Especifica el diseño del formulario de elemento de trabajo mediante la definición de los campos y controles que aparecen en el formulario y del orden en que aparecen. Contiene LAYOUT, CONTROL, GROUP, TAB, TABGROUP, SPLITTER y otros elementos. |
Tipos de elemento de trabajo de la plantilla de proceso
Tras instalar o actualizar una instancia de TFS, las plantillas de proceso predeterminadas se descargan en el directorio siguiente:
%programfiles%/Microsoft Team Foundation Server 14.0/Tools/Deploy/ProcessTemplateManagerFiles/1033
Los archivos de definición de WIT se almacenan en la carpeta WorkItem Tracking\TypeDefinitions.
Para más información sobre la creación y personalización de un WIT, vea Personalizar los objetos de seguimiento del trabajo para admitir los procesos de su equipo. Para agregar un nuevo WIT a la plantilla de proceso, vea Agregar definiciones de tipo de elementos de trabajo a una plantilla de proceso.
Vea también
Conceptos
Personalizar los objetos de seguimiento del trabajo para admitir los procesos de su equipo
Otros recursos
witAdmin: Personalizar y administrar objetos para el seguimiento de elementos de trabajo