Share via


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

Mediante el complemento para el seguimiento de elementos de trabajo, defina los objetos iniciales de un proyecto de equipo para hacer el seguimiento del trabajo. Estos objetos incluyen los tipos de elementos de trabajo, consultas de elementos de trabajo, categorías, tipos de vínculo, listas globales e instancias de elementos de trabajo. Después de crear un proyecto de equipo, puede modificar estos objetos utilizando la herramienta de línea de comandos witadmin.

En el archivo de complemento, especifique una o más tareas y sus dependencias. En general, puede especificar una tarea para cada actividad de carga primaria, como tipos de vínculo, tipos de elemento de trabajo, consultas y categorías.

Nota importanteImportante

Debe especificar las tareas en las que se van a cargar los archivos y definir las consultas en una secuencia concreta: los tipos de vínculos primero, después los tipos de elementos de trabajo y, a continuación, las consultas. Cada archivo de definición de estos objetos depende de las definiciones especificadas en las tareas que les preceden. Por lo general, debe mantener la secuencia de la tarea definida en la plantilla de procesos que está personalizando. Para obtener más información, vea Definir dependencias para grupos de tareas y tareas de archivos de complemento.

En este tema

  • Nombre y ubicación de los complementos de seguimiento de elementos de trabajo

  • Estructura de sintaxis de los complementos de seguimiento de elementos de trabajo

  • Referencia del elemento del complemento WorkItemTracking

Para obtener información concreta sobre cada tipo de objeto que puede definir, vea uno de los temas siguientes:

Nombre y ubicación de los complementos de seguimiento de elementos de trabajo

En la siguiente tabla se resumen el nombre y la ubicación del archivo de las plantillas de proceso para Microsoft Solutions Framework (MSF), además del nombre del complemento.

Nombre del archivo:

WorkItems.xml

Ubicación del archivo:

Carpeta WorkItem Tracking

Nombre del complemento:

Microsoft.ProjectCreationWizard.WorkItemTracking

Nota

Es posible cambiar el nombre y la ubicación del archivo XML pero no se puede cambiar el nombre del complemento. Visual Studio Team Foundation Server no incluye un mecanismo para la implementación de complementos de cliente, directivas u otras modificaciones. Si desea implementar este tipo de funcionalidad, debe utilizar su propio programa de instalación y distribución.

Volver al principio

Estructura de sintaxis de los complementos de seguimiento de elementos de trabajo

El archivo de complemento para el seguimiento de elementos de trabajo debe ajustarse a la definición de esquema que se define en el archivo WorkItemMethodology.xsd, y el complemento debe especificarse en su propio archivo. Puede descargar los archivos de esquema para las plantillas de proceso de la siguiente página del sitio web de Microsoft: Process Template and Work Item Schemas for Visual Studio Team Foundation.

La sintaxis siguiente muestra la estructura de alto nivel del complemento WorkItemTracking. Se especifican cuatro tareas: cargar las definiciones de los tipos de vínculos, tipos de elementos de trabajo, consultas y las categorías. Si se agregan las definiciones de listas globales o instancias de elemento de trabajo, debe especificar una tarea adicional para cada una.

Para obtener una descripción de cada elemento, consulte la referencia del elemento del complemento WorkItemTracking 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>

Volver al principio

Referencia del elemento del complemento WorkItemTracking

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

Elemento

Sintaxis

Descripción

CATEGORIES

<CATEGORIES fileName="CategoriesFilePathName" />

Elemento secundario opcional del elemento taskXml del 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.

FIELD

<FIELD refname="FieldReferenceName" value="Value" />

Elemento secundario necesario de WI.

Define un valor para un campo en la instancia del elemento de trabajo.

GLOBALLISTS

<GLOBALLISTS fileName="GlobalListFilePathName" />

Elemento secundario opcional del elemento taskXml del complemento WorkItemTracking.

Especifica la ruta de acceso y el nombre del archivo que contiene las definiciones de las listas globales que se cargan cuando se procesa la tarea de complemento WorkItemTracking.

HYPERLINK

<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 necesario 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 del complemento WorkItemTracking.

Contiene una colección de elementos LINKTYPE, cada uno especifica un archivo de definición que se va a cargar.

Permission

<permission allow="ListOfPermissions" identity="GroupName" />

Elemento secundario opcional de Query.

Especifica los permisos predeterminados que se asignan a las consultas de equipo. Para obtener más información, vea Asignar permisos para las consultas de elementos de trabajo.

Query

<Query name="QueryName" fileName="QueryFilePathName" />

Elemento secundario necesario 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 una carpeta de consulta.

QUERIES

<QUERIES>
   . . . 
</QUERIES>

Elemento secundario opcional del elemento taskXml del complemento WorkItemTracking.

Especifica qué archivos de definición de consultas se utilizarán para crear las consultas predeterminadas.

WI

<WI type="WorkItemType">
   <FIELD> . . .</FIELD>
   <HYPERLINK> . . .</HYPERLINK>
</WI>

Elemento secundario necesario de WORKITEMS.

Define un tipo de elemento de trabajo que se va a crear y los valores que se van a asignar a campos concretos.

WORKITEMS

WORKITEMS>
   <WI>
      <FIELD> . . .</FIELD>
      <HYPERLINK> . . .</HYPERLINK>
   </WI>
</WORKITEMS >

Elemento secundario opcional del elemento taskXml del complemento WorkItemTracking.

Contiene una colección de elementos WI, cada uno define una instancia del elemento de trabajo.

WORKITEMTYPE

<WORKITEMTYPE fileName="WITFilePathName" />

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.

WORKITEMTYPES

<WORKITEMTYPES> 
    <WORKITEMTYPE />
 . . .
</WORKITEMTYPES>

Elemento secundario requerido del complemento WorkItemTracking.

Contiene una colección de elementos WORKITEMTYPE, cada uno especifica un archivo de definición que se va a cargar.

Volver al principio

Vea también

Tareas

Comprobar cambios de definición de tipo de elemento de trabajo

Conceptos

Proceso de personalización paso a paso

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

Trabajar con archivos de plantilla de proceso

Personalizar las áreas funcionales en una plantilla de proceso

Otros recursos

Personalizar plantillas de procesos

Historial de cambios

Fecha

Historial

Motivo

1 de abril de 2011

Agregados sección de referencia y vínculos desde el elemento a temas individuales que tratan cada tipo de objeto de seguimiento. Se han quitado vínculos a los temas eliminados.

Mejora de la información.