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

El complemento para el seguimiento de elementos de trabajo le permite definir los objetos iniciales de un proyecto de equipo para 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 de equipo, 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 elementos 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 obtener más información, consulte este artículo sobre las Definir dependencias para grupos de tareas y tareas en archivos de complemento.

Nombre y ubicación del complemento

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

Nombre del archivo:	WorkItems.xml
Ubicación del archivo:	Carpeta WorkItem Tracking
Nombre del complemento:	Microsoft.ProjectCreationWizard.WorkItemTracking

Nota

Puede cambiar el nombre y la ubicación del archivo XML, pero no 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.

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

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

• Agregar definiciones de tipos de vínculos a una plantilla de proceso

• Agregar definiciones de tipo de categorías de elementos de trabajo a una plantilla de proceso

• Agregar consultas de elementos de trabajo a una plantilla de proceso

• Agregar una instancia de elemento de trabajo a una plantilla de proceso

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. Puede descargar los archivos de esquema para plantillas de proceso de la siguiente página del sitio web de Microsoft: Plantilla de proceso y esquemas de elementos de trabajo para Visual Studio Team Foundation.

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 elementos 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 elementos, 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. Especifique estos elementos dentro de un elemento contenedor taskXml en el archivo de complemento WorkItemTracking. Para obtener más información sobre los elementos task, dependency y taskXml, consulte Definir las tareas para procesar un complemento.

Elemento	Sintaxis	Descripción
CATEGORIES	<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.
FIELD	<FIELD refname="FieldReferenceName" value="Value" />	Elemento secundario necesario de WI. Define un valor para un campo de la instancia de elemento de trabajo.
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 para el 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 del equipo. Para obtener más información, consulte Asignar permisos para 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 la carpeta de una consulta.
QUERIES	<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 necesario 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; cada uno define una instancia de 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.

Vea también

Conceptos

Personalizar un proceso

Personalizar los objetos de seguimiento del trabajo para admitir los procesos de su equipo

Información general sobre los archivos de plantillas de procesos