Compartir a través de


Agregar consultas de elementos de trabajo a una plantilla de proceso

Agregando consultas de elementos de trabajo a la plantilla de proceso, puede definir el conjunto inicial de consultas compartidas y la estructura de carpetas de consulta para un proyecto de equipo. Todos los miembros del equipo van a utilizar consultas para buscar errores, tareas y otros elementos de trabajo sobre los que deben tomar medidas.

Las consultas de elementos de trabajo especifican los criterios que se utilizan para generar una lista de elementos de trabajo, por ejemplo, una lista de errores activos o de tareas cerradas. Los archivos de consulta de elementos de trabajo tienen la extensión .wiq y se guardan en la subcarpeta Queries de la carpeta WorkItem Tracking de las plantillas de proceso de Microsoft Solutions Framework (MSF).

Importante

Las plantillas de proceso de Microsoft definen varias consultas.Para obtener más información, vea Consultas compartidas (Scrum), Consultas compartidas (Agile) y Consultas compartidas (CMMI).Las definiciones de consulta dependen de los campos y los tipos de elementos de trabajo en la plantilla de proceso.Además, algunos libros que se cargan en el complemento de portal dependen de las definiciones de consulta.

Especifica las definiciones de consulta que se cargan como una tarea dentro del complemento WorkItemTracking. Esta tarea puede ser necesaria porque varios artefactos de una plantilla de proceso pueden depender de una consulta. Además, la tarea de cargar las consultas depende de la finalización correcta de la tarea que carga los tipos de elemento de trabajo. Especifique cada archivo de consultas para cargar dentro del elemento taskXml.

En este tema

  • Crear un archivo para una consulta de elementos de trabajo

  • Especificar las consultas que se van a cargar

  • Referencia del elemento QUERIES

Después de crear un proyecto de equipo a partir de la plantilla de proceso, puede agregar, quitar y cambiar las consultas mediante el editor de consultas. Para obtener más información, vea Buscar elementos de trabajo.

Para obtener información acerca de cómo se asignan permisos de consulta a los grupos, vea Controlar el acceso a las áreas funcionales. Para obtener información acerca de cómo se crean las carpetas de consulta, vea Definir objetos para el seguimiento de elementos de trabajo mediante el complemento de seguimiento de elementos de trabajo.

Crear un archivo para una consulta de elementos de trabajo

Cada definición de consulta se debe especificar en su propio archivo con una extensión .wiq, mediante el elemento primario WorkItemQuery, y se ajusta al esquema que se define en el archivo wiq.xsd. Puede descargar los archivos de esquema para el seguimiento de los elementos de trabajo de la siguiente página del sitio web de Microsoft: Process Template and Work Item Schemas for Visual Studio Team Foundation.

En el ejemplo siguiente se muestra la estructura de sintaxis de alto nivel que define una consulta de elemento de trabajo:

<WorkItemQuery Version="1">
<TeamFoundationServer>collectionURL</TeamFoundationServer>
<TeamProject>TeamProjectName</TeamProject>
  <Wiql>
      WorkItemQueryLanguage
  </Wiql>
</WorkItemQuery>

Para obtener más información sobre cómo crear una consulta de elementos de trabajo para agregar a una plantilla de proceso, vea Definir una consulta de elementos de trabajo para agregarla a una plantilla de proceso.

Volver al principio

Especificar las consultas que se van a cargar

Para incluir las consultas de elementos de trabajo en la plantilla de proceso, cree una o más tareas en el archivo workitems.xml, que encontrará en la carpeta \WorkItem Tracking, situada en la carpeta donde descargó la plantilla de proceso. Utilice el elemento Query para especificar el archivo de consulta de elementos de trabajo correcto. Por ejemplo, el código XML siguiente especifica la consulta que se define en el archivo ActiveBugs.wiq que se va a cargar, denominado Active Bugs.

<Query name="Active Bugs" fileName="WorkItem Tracking\Queries\ActiveBugs.wiq" />

El conjunto de consultas se agrega a la carga como una tarea en el complemento WorkItemTracking.

En el ejemplo siguiente se muestra cómo especificar una tarea para crear una carpeta de consulta denominada Product Management y cargar una consulta denominada All User Stories en esa carpeta.

<task id="Queries" name="Stored Query Definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage=" Work item queries uploaded" />
   <dependencies>
      <dependency taskId="WITs" />
   </dependencies>
   <taskXml>
      <QUERIES>
         <QueryFolder name="Product Management" >
            <Query name="All User Stories" fileName="WorkItem Tracking\Queries\AllUserStories.wiq" />
         </QueryFolder>
         . . .
      </QUERIES>
   </taskXml>
</task>

Para obtener más información, vea Definir objetos para el seguimiento de elementos de trabajo mediante el complemento de seguimiento de elementos de trabajo.

Volver al principio

Elemento QUERY

En la sintaxis siguiente se muestra la estructura del elemento QUERIES y sus elementos secundarios.

<QUERIES>
   <Permission />
   <QueryFolder >
      <Query />
   </QueryFolder>
</QUERIES>

En la tabla siguiente se describen los elementos que se usan para especificar la estructura de las carpetas de consulta, los permisos y las consultas que se van a cargar. Especifique estos elementos dentro de un elemento contenedor taskXml en el archivo de complemento WorkItemTracking.

Elemento

Sintaxis

Descripción

Permission

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

Elemento secundario opcional de Query.

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

Query

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

Como se muestra en el ejemplo siguiente, puede cargar la consulta etiquetada "Active Bugs" y que se define en el archivo ActiveBugs.wiq:

<Query name="Active Bugs" fileName="WorkItem Tracking\Queries\ActiveBugs.wiq" />

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">
   <Query />
</QueryFolder>

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.

Volver al principio

Vea también

Conceptos

Buscar elementos de trabajo

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