Definir objetos para el seguimiento de elementos de trabajo mediante el complemento de seguimiento de elementos de trabajo

  • Artículo
  • 5 minutos para leer

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.

Mediante el uso del complemento para realizar el seguimiento de elementos de trabajo, se definen los objetos iniciales de un proyecto para realizar el seguimiento del trabajo. Entre estos objetos se incluyen tipos de elementos de trabajo, consultas de elementos de trabajo, categorías, tipos de vínculos e instancias de elementos de trabajo. Después de crear un proyecto, puede modificar estos objetos mediante la herramienta de línea de comandos witadmin.

En el archivo de complemente, puede especificar una o más tareas y sus dependencias. En general, se especifica una tarea para cada actividad de carga principal, como tipos de vínculos, tipos de elemento de trabajo, consultas y categorías.

Importante

Las tareas para cargar archivos y definir consultas se deben especificar siguiendo una secuencia específica: primero los tipos de vínculo, después los tipos de elemento de trabajo y por último las consultas. Cada archivo de definición de estos objetos depende de las definiciones que se especifican en las tareas que los preceden. En general, se debe mantener la secuencia de tareas definida en la plantilla de proceso que desea personalizar. Para más información, consulte Definición de dependencias para grupos de tareas y tareas.

Nombre y ubicación del complemento

Los nombres del archivo, la carpeta y el complemento para las plantillas de proceso predeterminadas son los siguientes:

Nombre de archivo:WorkItems.xml
Nombre de carpeta:Nombre del complemento de la carpeta deseguimiento de WorkItem: Microsoft.ProjectCreationWizard.WorkItemTracking

Nota

Puede cambiar el nombre del archivo XML y el de la carpeta, pero no el del complemento. El sistema no incluye un mecanismo para la implementación de complementos del lado cliente, directivas u otras modificaciones. Si desea implementar este tipo de funcionalidad, debe utilizar su propio programa de instalación y distribución.

Para obtener información específica sobre los tipos de objetos que se pueden definir, consulte uno de los siguientes temas:

Estructura de la sintaxis del complemento de seguimiento de elementos de trabajo

El archivo de complemento de seguimiento de elementos de trabajo debe ajustarse a la definición de esquema establecida en el archivo WorkItemMethodology.xsd; el complemento debe especificarse en su propio archivo.

La sintaxis siguiente muestra la estructura de alto nivel del complemento WorkItemTracking. Se especifican cuatro tareas de carga de definiciones para tipos de vínculos, tipos de elemento de trabajo, consultas y categorías. Si quisiese agregar instancias de elemento de trabajo de definiciones, debería especificar una tarea adicional para cada uno.

Para obtener una descripción de cada elemento, vea Referencia de elemento más adelante en este tema.

<?xml version="1.0" encoding="utf-8"?>  
<tasks>  
  <task id="LinkTypes" name="LinkType definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item link types created">  
    <taskXml>  
      <LINKTYPES>  
        <LINKTYPE />  
      . . .   
      </LINKTYPES>  
    </taskXml>  
  </task>  
  <task id="WITs" name="WorkItemType definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item types created">  
    <dependencies>  
      <dependency taskId="LinkTypes" />  
    </dependencies>  
    <taskXml>  
      <WORKITEMTYPES>  
        <WORKITEMTYPE />  
      . . .   
      </WORKITEMTYPES>  
    </taskXml>  
  </task>  
  <task id="Queries" name="Stored Query Definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item queries uploaded">  
    <dependencies>  
      <dependency taskId="WITs" />  
    </dependencies>  
    <taskXml>  
      <QUERIES>  
        <Permission />  
      . . .   
        <QueryFolder >  
          <Query />  
      . . .   
        </QueryFolder>  
      . . .   
      </QUERIES>  
    </taskXml>  
  </task>  
  <task id="Categories" name="Categories definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item type categories created">  
    <dependencies>  
      <dependency taskId="WITs" />  
    </dependencies>  
    <taskXml>  
      <CATEGORIES fileName="WorkItem Tracking\Categories.xml" />  
    </taskXml>  
  </task>  
</tasks>

Referencia de elementos

En la tabla siguiente se describen los elementos que se usan para cargar objetos de seguimiento de elementos de trabajo. Estos elementos se especifican dentro de un elemento contenedor taskXml en el archivo de complemento WorkItemTracking. Para obtener información sobre los elementos task, dependency y taskXml, vea Definir las tareas para procesar un complemento.

Elemento Sintaxis Descripción
CATEGORÍAS <CATEGORIES fileName="CategoriesFilePathName" /> Elemento secundario opcional del elemento taskXml para el complemento WorkItemTracking.

Especifica la ruta de acceso y el nombre del archivo que contiene las definiciones de las categorías que se cargan cuando se procesa la tarea de complemento WorkItemTracking.
CAMPO <FIELD refname="FieldReferenceName" value="Value" /> Elemento secundario requerido de WI.

Define un valor para un campo de la instancia de elemento de trabajo.
HIPERVÍNCULO <HYPERLINK URL="URL" relativePath="false" /> Elemento secundario opcional de WI.

Define un hipervínculo para la instancia del elemento de trabajo.
LINKTYPE <LINKTYPE fileName="LinkTypeFilePathName" /> Elemento secundario obligatorio de LINKTYPES.

Especifica la ruta de acceso y un nombre de archivo que contiene una definición del tipo de vínculo que se va a cargar.
LINKTYPES <LINKTYPES> <LINKTYPE /> . . . </LINKTYPES> Elemento secundario opcional del elemento taskXml para el complemento WorkItemTracking.

Contiene una colección de elementos LINKTYPE que especifican un archivo de definición que se cargará.
Permiso <permission allow="ListOfPermissions" identity="GroupName" /> Elemento secundario opcional de Query.

Especifica los permisos predeterminados que se asignan a las consultas del equipo. Para obtener más información, vea Asignación de permisos para consultas de elementos de trabajo.
Consultar <Query name="QueryName" fileName="QueryFilePathName" /> Elemento secundario requerido de QUERIES.

Especifica el nombre y la ruta de acceso del archivo .wiq que define una consulta que se va a cargar.
QueryFolder <QueryFolder name=" FolderName "> Elemento secundario opcional de QUERIES.

Especifica el nombre de la carpeta de una consulta.
CONSULTAS <QUERIES> . . . </QUERIES> Elemento secundario opcional del elemento taskXml para el complemento WorkItemTracking.

Especifica qué archivos de definición de consulta se usan para crear las consultas predeterminadas.
WI <WI type="WorkItemType"> <FIELD> . . .</FIELD> <HYPERLINK> . . .</HYPERLINK> </WI> Elemento secundario requerido de WORKITEMS.

Define un tipo de elemento de trabajo para crear y los valores que se asignan a campos específicos.
WORKITEMS WORKITEMS> <WI> <FIELD> . . .</FIELD> <HYPERLINK> . . .</HYPERLINK> </WI> </WORKITEMS > Elemento secundario opcional del elemento taskXml para el complemento WorkItemTracking.

Contiene una colección de elementos WI que definen una instancia de elemento de trabajo.
WORKITEMTYPE <WORKITEMTYPE fileName="WITFilePathName" /> Elemento secundario requerido de WORKITEMTYPES.

Especifica la ruta de acceso y el nombre del archivo que contiene una definición del tipo que se va a cargar.
WORKITEMTYPES <WORKITEMTYPES> <WORKITEMTYPE /> . . . </WORKITEMTYPES> Elemento secundario requerido del complemento WorkItemTracking.

Contiene una colección de elementos WORKITEMTYPE que especifican un archivo de definición que se cargará.