Referencia de todos los elementos WITD de XML

| de Azure DevOps Server 2022 Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

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 los campos, las reglas y los estados de flujo de trabajo y las transiciones de un elemento de trabajo que se realizará un seguimiento de un proyecto, como un error, un requisito o un riesgo. Cree un proyecto en Azure DevOps Services o en team Foundation Server (TFS) local.

El elemento raíz de cada definición de un WIT es el WITD elemento , que solo debe tener un WORKITEMTYPE elemento definido. El nombre de cada WIT debe ser único en un proyecto y cada nombre de tipo no debe tener más de 128 caracteres Unicode.

Para personalizar o crear una definición de WIT, modifique el archivo XML de definición de tipos. Los WIT se limitan a un proyecto 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="http://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:

Element

Descripción

WITD

La definición de WIT completa se ajusta mediante la etiqueta WITD. 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".

<witd:WITD application="Work item type editor" version="1.0" >  
<WORKITEMTYPE>   
. . .  
</WORKITEMTYPE>  
</witd:WITD>

WORKITEMTYPE

Los nombres de los WIT deben ser únicos en un proyecto específico. 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, un usuario podría elegir Error en el menú Nuevo elemento de trabajo .

<WORKITEMTYPE name="WorkItemTypeName" refname="WITReferenceName" >  
<DESCRIPTION>Text</DESCRIPTION>  
<GLOBALLISTS> . . .</GLOBALLISTS>  
<FIELDS> . . . </FIELDS>  
<WORKFLOW> . . . </WORKFLOW>  
<FORM> . . .</FORM>  
</WORKITEMTYPE>

Nombre descriptivo (nombre): aparece en los menús desplegables de consultas de elementos de trabajo. El nombre descriptivo debe ser único en todos los nombres WIT definidos dentro de un proyecto. Especifique un nombre con un máximo de 128 caracteres Unicode que utilice caracteres alfanuméricos, subrayado y guión.

Nombre de referencia (refname): especifique un nombre que no tenga más de 70 caracteres Unicode que use caracteres alfanuméricos, de subrayado y guiones. 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.

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 puede ver la descripción en ningún 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 WIT. Las listas globales se usan para compartir listas de selección entre varias REDES WIT definidas para una colección de proyectos. Defina listas globales para admitir la colaboración entre grupos y la facilidad de mantenimiento.

<GLOBALLIST name="globalListName">   
<LISTITEM> . . . </LISTITEM>  
</GLOBALLIST>  

CAMPOS

Define los campos usados para realizar un seguimiento de los datos del WIT. En el elemento FIELDS , se definen todos los campos que desea usar para realizar un seguimiento de los datos. Esto incluye los campos que utilizará para ejecutar consultas y generar informes.

<FIELDS>   
<FIELD> . . . </FIELD>  
</FIELDS>

FORMA

Especifica el diseño del formulario de elemento de trabajo definiendo los campos y controles que aparecen en el formulario y en qué orden.

Para TFS 2015 y versiones anteriores, el elemento FORM contiene Layout, Control, Group, TAB, TabGroup, Splitter y otros elementos.

<FORM>   
<Layout> . . . </Layout>  
</FORM>  

Para los modelos de proceso XML hospedado y XML local (TFS 2017 y versiones posteriores), el elemento FORM contiene WebLayout, Control, SystemControls, Section, Page y otros elementos.

<WebLayout> 
<Page>  
<Section>  
<Group>  
<Control> . . . </Control>
<Control> . . . </Control>
</Group>
</Section>
</Page>
. . .
</WebLayout>

Importante

Para los modelos de procesos XML hospedados y XML locales (TFS 2017 y versiones posteriores), consulte Elementos WebLayout y Control.

FLUJO

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 definen 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.

<WORKFLOW>  
<STATES> . . . </STATES>  
<TRANSITIONS> . . . </TRANSITIONS>  
</WORKFLOW>  

Tipos de elemento de trabajo de la plantilla de proceso

Al instalar o actualizar una instancia de un TFS local, las plantillas de proceso predeterminadas se descargan en el directorio siguiente:

Para TFS 2017:

%programfiles%/TFS 15.0/Tools/Deploy/ProcessTemplateManagerFiles/1033

Para TFS 2015:

%programfiles%/TFS 14.0/Tools/Deploy/ProcessTemplateManagerFiles/1033

Los archivos de definición de WIT se almacenan en la carpeta WorkItem Tracking\TypeDefinitions.

Para obtener información sobre cómo crear o personalizar un WIT, consulte Modificar o agregar un tipo de elemento de trabajo personalizado.