Agregar definiciones de tipo de elementos de trabajo a una plantilla de proceso

Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013

Importante

Este artículo se aplica a la personalización de proyectos para los modelos de proceso XML locales. Para obtener información general sobre los modelos de proceso, consulte Personalización de la experiencia de seguimiento de trabajo.

Los tipos de elementos de trabajo (WIT) proporcionan la base para todo el seguimiento, la supervisión y la creación de informes sobre el desarrollo de un producto y sus características. Un WIT define los campos de datos, el flujo de trabajo y el formulario de elemento de trabajo para un elemento de trabajo del que va a realizar un seguimiento. Los tipos de elementos de trabajo incluyen errores, casos de usuario y tareas.

Al personalizar una plantilla de proceso, puede realizar las siguientes personalizaciones de WIT:

  • Adición de campos
  • Personalización del flujo de trabajo
  • Modificación del formulario de elemento de trabajo
  • Adición o eliminación de WIT

Las definiciones de tipos para una plantilla de proceso para varios elementos de trabajo se especifican como una tarea dentro del complemento WorkItemTracking. Se requiere esta tarea porque los tipos de elemento de trabajo admiten el seguimiento y los informes de errores. Especifique cada archivo de definición de tipo que se va a cargar dentro del elemento taskXml. Los complementos para la administración de pruebas, los informes y el portal dependen de la carga correcta de las definiciones para los WIT.

Las plantillas de proceso predeterminadas definen varios WIT. Se hace referencia a los tipos y los campos definidos dentro de ellos en las definiciones de las categorías, las consultas de elementos de trabajo y los informes. Por lo tanto, la tarea para cargar las definiciones de WIT debe completarse correctamente antes de las tareas para cargar categorías, consultas de elementos de trabajo e informes.

Además, la tarea de cargar archivos de definición para los tipos de vínculo debe preceder a la tarea de cargar las definiciones de tipos para los WIT. Para más información, consulte Definición de dependencias para grupos de tareas y tareas.

Después de crear un proyecto mediante la plantilla de proceso, puede agregar, quitar, cambiar el nombre y cambiar las definiciones de los WIT mediante la herramienta de línea de comandos witadmin. Para obtener más información, vea Importación, exportación y administración de tipos de elementos de trabajo.

Definición de un WIT

Cada definición de WIT debe especificarse en su propio archivo en el elemento contenedor WITD. Cada definición también debe ajustarse a la definición de esquema para los tipos de elemento de trabajo.

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

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

Puede personalizar o crear archivos de definición de tipos en la carpeta TypeDefinitions. Para obtener más información sobre cómo definir un tipo de elemento de trabajo, vea Todos los elementos WITD.

Especificación de los archivos de definición de WIT que se cargarán

Para cargar una definición de WIT, especifique el elemento WORKITEMTYPE. El atributo filename es una ruta de acceso relativa del archivo de definición de tipos. Por ejemplo, la sintaxis siguiente especifica que se cargará el archivo Bug.xml.

<WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\filename.xml"/>  

En el ejemplo siguiente se muestra cómo especificar una tarea que crea los WIT siguientes: error, problema, pasos compartidos, tarea, caso de prueba y caso de usuario. Dado que las definiciones de varios WIT contienen filtros para el tipo de vínculo TestedBy, la tarea LinkTypes debe completarse antes de que se pueda completar la tarea WIT.

<task id="WITs" name="WorkItemType definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item types created">  
      <dependencies>  
      <dependency taskId="LinkTypes" />  
      </dependencies>  
      <taskXml>  
      <WORKITEMTYPES>  
       <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Bug.xml" />  
       <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Issue.xml" />  
       <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\CodeReviewRequest.xml" />  
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\CodeReviewResponse.xml" />  
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Feature.xml" />  
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\FeedbackRequest.xml" />  
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\FeedbackResponse.xml" />   
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\SharedStep.xml" />  
       <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Task.xml" />  
       <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\TestCase.xml" />  
       <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\UserStory.xml" />  
      </WORKITEMTYPES>  
      </taskXml>  
</task>  

Referencia del elemento WORKITEMTYPES

En la tabla siguiente se describen los elementos que se utilizan para cargar las definiciones de tipos para los elementos de trabajo. Estos elementos se especifican dentro de un elemento contenedor taskXml en el archivo de complemento WorkItemTracking.

Nota

Mediante el elemento WORKITEMTYPE (WorkItemTracking), se especifica un archivo de definición de tipo que se va a cargar. Mediante el elemento WORKITEMTYPE (WITD), se especifica el nombre de un tipo que se va a definir. Para obtener más información, vea Todos los elementos WITD.

Elemento Descripción y sintaxis
WORKITEMTYPE Elemento secundario necesario de WORKITEMTYPES. Especifica la ruta de acceso y el nombre del archivo que contiene una definición del tipo que se va a cargar.
<WORKITEMTYPE fileName="WITFilePathName" />
WORKITEMTYPES Elemento secundario requerido del complemento WorkItemTracking. Contiene una colección de elementos WORKITEMTYPE que especifican un archivo de definición que se cargará.
<WORKITEMTYPES>
<WORKITEMTYPE /> . . .
</WORKITEMTYPES>