Compartir a través de


Agregar consultas de elementos de trabajo a una plantilla de proceso

Al agregar 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 usan consultas para buscar errores, tareas y otros elementos de trabajo sobre los que deben efectuar alguna acción.

Las consultas de elementos de trabajo especifican criterios para generar una lista de elementos de trabajo (por ejemplo, una lista de errores activos o tareas cerradas). Los archivos de las consultas de elementos de trabajo tienen la extensión .wiq y se almacenan 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 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 de la plantilla de proceso.Además, algunos libros que se cargan en el complemento de portal dependen de las definiciones de consulta.

Especifique las definiciones de consulta que se deben cargar 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 consulta que se va a cargar dentro del elemento taskXml.

En este tema

  • Crear un archivo para una consulta de elementos de trabajo

  • Especificar consultas para 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 más información, vea Consultar elementos de trabajo.

Para información sobre cómo asignar permisos de consulta a los grupos, vea Controlar el acceso a las áreas funcionales. Para obtener información sobre cómo crear 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 la extensión .wiq mediante el elemento primario WorkItemQuery y ajustarse al esquema que se define en el archivo wiq.xsd. Puede descargar los archivos de esquema para el seguimiento de elementos de trabajo de la siguiente página del sitio web de Microsoft: Plantilla de proceso y esquemas de elementos de trabajo para 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 más información sobre cómo crear una consulta de elementos de trabajo que se va a 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 consultas para 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 en la que descargó la plantilla de proceso. Use el elemento Query para especificar el archivo de consulta de elementos de trabajo. Por ejemplo, el siguiente código XML 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" />

Agregue el conjunto de consultas que se va a cargar 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 dicha 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 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

Elementos 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, consulte Asignar permisos para 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 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.

Volver al principio

Vea también

Conceptos

Consultar elementos de trabajo

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