Definir una consulta de elementos de trabajo para agregarla a una plantilla de proceso
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 Consultar elementos de trabajo.
Requisitos
Para crear una consulta, debe ser miembro del grupo Lectores 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 que se describen en Establecer permisos en consultas.
Guardar una consulta de elementos de trabajo como un archivo .wiq
En Team Explorer, abra la consulta que desea guardar.
En el menú Archivo, elija Guardar <nombre de la consulta> [Consulta] como.
En el cuadro de diálogo Guardar consulta como, elija Archivo y especifique una ubicación y un nombre de archivo para el archivo .wiq. También puede elegir Examinar, especificar un nombre de archivo, buscar la ubicación en la que se va a guardar el archivo y elegir Guardar.
Copie el archivo en la carpeta \WorkItem Tracking\Queries, situada en la carpeta en la que descargó la plantilla de proceso.
Abra el archivo .wiq en un editor de texto.
Quite los elementos <TeamFoundationServer> y <TeamProject> que asocian la consulta a un servidor específico en el que se ejecuta Visual Studio Team Foundation Server y a un proyecto de equipo específico, 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.
Quite cualquier elemento adicional que sea específico de un usuario.
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, consulte Definir el complemento de clasificación y Definir las tareas raíz mediante el archivo de complemento de plantilla de proceso.
Ejemplo de un 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>
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 |
|
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:// NombreDeServidor:Puerto/NombreDeColección El tipo de atributo es ServerNameType con una longitud máxima de 2047. |
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 |
|
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. |