Definir una consulta de elementos de trabajo para agregarla a una plantilla de procesos

Puede crear un archivo de consulta de elementos de trabajo (.wiq) fácilmente en Team Explorer.En un proyecto de equipo existente, use Team Explorer para crear todas las consultas de elementos de trabajo que desea agregar a la plantilla de proceso y, a continuación, siga los pasos de este tema para guardar cada consulta como un archivo .wiq.Para obtener más información acerca de cómo se crean consultas de elementos de trabajo, vea Especificar criterios de filtro para consultas.

En este tema

• Guardar una consulta de elementos de trabajo como archivo .wiq

• Crear una consulta de elementos de trabajo que haga referencia a una ruta de acceso de iteración

• Ejemplo de un consulta de elementos de trabajo específica de una iteración

• Referencia del elemento WorkItemQuery

Permisos necesarios

Para crear una consulta, debe ser miembro del grupo Readers o tener el permiso Ver los elementos de trabajo en este nodo establecido en Permitir para cada proyecto de equipo en la consulta.Para guardar una consulta como consulta de equipo, debe tener los permisos adecuados.Para obtener más información, vea Organizar y establecer los permisos en las consultas de elementos de trabajo.

Guardar una consulta de elementos de trabajo como archivo .wiq

Para guardar una consulta de elementos de trabajo en un archivo .wiq

1. En Team Explorer, haga clic con el botón secundario en la consulta y después haga clic en Ver consulta.

2. En el menú Archivo, haga clic en Guardar <nombre de la consulta> [Consulta] como.

3. En el cuadro de diálogo Guardar consulta como, haga clic en la opción Archivo y especifique una ubicación y un nombre de archivo para el archivo .wiq.Como alternativa, haga clic en Examinar, especifique un nombre de archivo, busque la ubicación en la que se va a guardar el archivo y haga clic en Guardar.

4. Copie el archivo en la carpeta \WorkItem Tracking\Queries, situada en la carpeta en la que descargó la plantilla de proceso.

5. Abra el archivo .wiq en un editor de texto.

6. Quite los elementos <TeamFoundationServer> y <TeamProject> que asocian la consulta con un servidor específico en el que se ejecuta Visual Studio Team Foundation Server y especifique un proyecto de equipo, tal y como se muestra en el ejemplo siguiente:

   <TeamFoundationServer>CollectionURL</TeamFoundationServer>
   <TeamProject>ProjectName</TeamProject>
   

   [!NOTA]

   Debe editar el archivo .wiq en un editor de texto y quitar los elementos <TeamFoundationServer> y <TeamProject> que asocian la consulta a un servidor y un proyecto de equipo concretos.De lo contrario, si la plantilla de procesos se carga en un servidor diferente, la consulta no funcionará correctamente.También puede utilizar macros siempre que sea posible para que la consulta no contenga el nombre explícito del proyecto de equipo actual o cualquier otro valor explícito que sea específico de un determinado entorno.

7. Quite cualquier elemento adicional que sea específico de un usuario.

Volver al principio

Crear una consulta de elementos de trabajo que haga referencia a una ruta de acceso de iteración

Puede definir una consulta que haga referencia a una ruta de acceso de iteración concreta incluyendo la macro del proyecto de equipo, $$NOMBREDELPROYECTO $$, y el nombre de una ruta de acceso de iteración definida en el archivo del complemento Clasificación.Por ejemplo, en la sintaxis de la consulta siguiente se especifica una consulta que incluye solo aquellos elementos de trabajo cuya ruta de acceso de iteración está bajo Iteration 1.

AND  [Source].[System.IterationPath] UNDER '$$PROJECTNAME$$\Iteration 1'

Cuando se crea el proyecto de equipo, la macro se reemplaza por el nombre del proyecto de equipo.

Utilizando esta macro, puede definir libros que hagan referencia a las rutas de acceso de iteración concretas.La plantilla de procesos de MSF for Agile Software Development contiene una consulta específica de iteración, Iteration1Backlog.wiq, que es compatible con el libro específico de iteración, Iteration Backlog.xlsm.

Cuando cargue consultas específicas de iteración, asegúrese de que la tarea que va a procesar el archivo Classification.xml es anterior a la tarea que va a procesar los archivos de consulta.Para obtener más información, vea Definir las áreas e iteraciones iniciales en el complemento de clasificación y Definir las tareas raíz mediante el archivo de complemento de plantilla de proceso.

Volver al principio

Ejemplo de una consulta de elementos de trabajo específica de una iteración

En el siguiente ejemplo se muestra la consulta de elementos de trabajo Iteration1Backlog que admite el libro Iteration Backlog.

<?xml version="1.0" encoding="utf-8"?>
<WorkItemQuery Version="1">
  <Wiql>
    SELECT [System.Id],
           [System.WorkItemType],
           [System.Title],
           [System.State],
           [System.AssignedTo],
           [Microsoft.VSTS.Scheduling.RemainingWork],
           [Microsoft.VSTS.Scheduling.CompletedWork],
           [Microsoft.VSTS.Scheduling.StoryPoints],
           [Microsoft.VSTS.Common.StackRank],
           [Microsoft.VSTS.Common.Priority],
           [Microsoft.VSTS.Common.Activity],
           [System.IterationPath],
           [System.AreaPath]
      FROM WorkItemLinks
     WHERE (Source.[System.TeamProject] = @project 
       AND  [Source].[System.AreaPath] UNDER @project
       AND  [Source].[System.IterationPath] UNDER '$$PROJECTNAME$$\Iteration 1'
       AND (
               Source.[System.WorkItemType] = 'User Story' 
            OR Source.[System.WorkItemType] = 'Task'
           )
           )
       AND [System.Links.LinkType] = 'System.LinkTypes.Hierarchy-Forward'
       AND [Target].[System.WorkItemType] = 'Task'
       ORDER BY [Microsoft.VSTS.Common.StackRank], [Microsoft.VSTS.Common.Priority]
       mode(Recursive)
  </Wiql>
</WorkItemQuery>

Volver al principio

Referencia del elemento WorkItemQuery

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

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

Elemento	Sintaxis	Descripción
TeamFoundationServer	<TeamFoundationServer>collectionURL </TeamFoundatonServer>	Elemento secundario opcional de WorkItemQuery. Importante En general, se quita este elemento de las consultas que se agregan a las plantillas de proceso. Especifica el URI de la colección de proyectos de equipo en el formato siguiente: http://://NombreServidor:Puerto/NombreDirectorioVirtual/NombreColección Si no se usa ningún directorio virtual, el formato del identificador URI será el siguiente: http://NombreServidor:Puerto/NombreColección El tipo de atributo es ServerNameType con una longitud máxima de 2047.
TeamProject	<TeamProject>TeamProjectName</TeamProject>	Elemento secundario opcional de WorkItemQuery. Importante En general, se quita este elemento de las consultas que se agregan a las plantillas de proceso. Especifica el proyecto de equipo para el que se ejecuta la consulta. El tipo de atributo es ProjectNameType con una longitud máxima de 255 caracteres.
Wiql	<Wiql>WorkItemQueryLanguage</Wiql>	Elemento secundario necesario de WorkItemQuery. Especifica un script de lenguaje de consulta estructurado (SQL) que actúa como criterios de filtro para buscar un conjunto de elementos de trabajo en un proyecto de equipo y devolver los valores asignados a un número fijo de campos. Las plantillas de proceso de MSF proporcionan varios ejemplos de comandos SQL que el elemento Wiql admite.Estos archivos se encuentran en la carpeta Queries de la carpeta seguimiento WorkItem.Para obtener más información sobre cómo definir consultas vea, Buscar errores, tareas y otros elementos de trabajo.

Volver al principio

Vea también

Conceptos

Buscar errores, tareas y otros elementos de trabajo

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