Buscar elementos de trabajo
Las consultas le ayudan a buscar elementos de trabajo para revisarlos, evaluarlos, actualizarlos o generar un informe.
Utilice el cuadro de búsqueda para buscar elementos de trabajo. Escriba el identificador o utilice filtros. Si desea obtener una lista plana de elementos de trabajo, una lista jerárquica que use una consulta de árbol o una lista donde se muestren las dependencias mediante una consulta de vínculos directos, utilice el editor de consultas para elegir el tipo de búsqueda.
Puede crear consultas en Visual Studio Online, Team Web Access (TWA) y Team Explorer. Además, puede abrir una consulta en Excel o Project para realizar modificaciones masivas.
Usar el cuadro de búsqueda para buscar un elemento de trabajo por su identificador
Escriba el identificador en el cuadro Buscar elementos de trabajo y luego elija el icono de búsqueda.
.png "Cuadro de texto Buscar elementos de trabajo")
Si usa el menú contextual .png "Icono de menú contextual")
, puede agregar filtros a los elementos de lista basándose en la asignación, el estado, una palabra clave o un tipo de elemento de trabajo.
Por ejemplo, escriba A=@Me T=Task para enumerar todas las tareas que tiene asignadas.
Abrir y editar una consulta de lista plana
La manera más fácil de definir una consulta es empezar por una consulta compartida existente. El ejemplo siguiente muestra cómo buscar todos los errores cerrados modificando la consulta compartida Errores activos proporcionada con la plantilla de proceso de Agile. Los ejemplos se basan en la interfaz de usuario proporcionada a través del explorador web.
Abra una consulta compartida. Por ejemplo, abra Errores activos o una consulta de lista plana similar.
.png "Abrir consulta compartida, por ejemplo, Errores activos")
Modifique la consulta para buscar errores cerrados y después ejecute la consulta. Use
.png "Agregar datos adjuntos")
(Insertar nueva línea de filtro) para insertar una cláusula sobre la cláusula actual. Use .png "Cláusula Delete")
(Quitar línea de filtro) para eliminar una cláusula..png "Vista del editor de una consulta de lista plana")
Guarde la consulta en la carpeta Mis consultas.
.png "Guardar consulta como, Carpeta=Mis consultas")
Para guardar una consulta en la carpeta Consultas compartidas, debe ser administrador de equipo, miembro del grupo Administradores de proyectos o tener los permisos Contribuir de la carpeta establecidos en Permitir.
Crear una consulta
Empiece en el menú Nuevo de la página de consultas de TWA o en la página de elementos de trabajo de Team Explorer.
.png "Abrir una nueva consulta")
Agrupar cláusulas para refinar la lista
Las cláusulas agrupadas funcionan como una sola unidad independiente del resto de la consulta; el resultado es similar al obtenido al colocar unos paréntesis alrededor de una ecuación matemática o una expresión lógica. El operador And u Or para la primera cláusula del grupo se aplica a todo el grupo.
En el siguiente ejemplo, la primera expresión devuelve todos los elementos de trabajo que tienen la prioridad 1 y todos los errores activos, independientemente de su prioridad. La segunda expresión devuelve todos los elementos de trabajo activos con la prioridad 1 y todos los errores con la prioridad 1, independientemente de que estén activos o no.
Cláusulas agrupadas |
Expresión lógica |
|---|---|
.png "Filtrar usando una expresión lógica OR/AND") |
Prioridad=1 O (Tipo de elemento de trabajo=Error Y Estado=Activo) |
.png "Filtrar usando una expresión lógica AND/OR") |
Prioridad=1 (Tipo de elemento de trabajo=Error O Estado=Activo) |
Para agrupar una o más cláusulas, selecciónelas y elija el icono de agrupar cláusulas .png "Agrupar cláusulas de consulta"){kind=icon}
.
.png "Agrupar las cláusulas de consulta seleccionadas")
Si los resultados de la consulta no devuelven el conjunto esperado de elementos de trabajo, siga estos pasos:
Asegúrese de que las cláusulas están definidas como deseaba.
Compruebe las asignaciones de Y/O para cada cláusula. Si los resultados contienen más elementos de trabajo de lo esperado, a menudo se debe a que hay una cláusula Or en lugar de una cláusula And.
Determine si necesita agrupar o cambiar la agrupación de las cláusulas de consulta y las asignaciones Y/O de cada cláusula agrupada.
Agregue más cláusulas de consulta para afinar los criterios de filtro para su consulta.
Revise las opciones disponibles para especificar campos, operadores y valores.
Usar una consulta de árbol para ver una lista jerárquica
Use la consulta de árbol (.png "Consulta de árbol"){kind=icon}
) para ver una lista anidada de varios niveles de elementos de trabajo. Por ejemplo, puede ver todos los elementos de trabajo pendiente y sus tareas vinculadas.
.png "Lista de resultados que muestra una consulta de árbol")
Expanda (.png "Expandir nodo (Team Web Access)")
) o contraiga (.png "Contraer nodo (Team Web Access)")
) los nodos de hoja para centrarse en partes distintas del árbol.
Defina los criterios de filtro para los elementos de trabajo primarios y secundarios.
.png "Filtros de consulta de árbol")
Para buscar los elementos secundarios vinculados, seleccione Buscar primero elementos de trabajo de nivel superior. Para buscar los elementos primarios vinculados, seleccione Buscar primero elementos de trabajo vinculados.
Usar una consulta de vínculo directa para ver las dependencias
Utilice la consulta de vínculos directos (.png "Consulta de vínculos directos"){kind=icon}
) para hacer un seguimiento de los elementos de trabajo que dependen de otros trabajos de los que se hace seguimiento, como tareas, errores, problemas o características. Por ejemplo, puede ver los elementos de trabajo pendiente que dependen de otros elementos que se están implementando o de un error que se está corrigiendo.
.png "Resultados de la consulta de vínculos directos")
Use la consulta de vínculos directos para hacer un seguimiento de las dependencias del trabajo de otros equipos que tenga su equipo o para administrar los compromisos que su equipo tenga con otros equipos. Especifique los criterios de filtro para los elementos de trabajo de la parte superior y los vinculados, y seleccione los tipos de vínculos usados para filtrar las dependencias.
.png "Editor de consulta de vínculos directos")
Filtre la lista de primer nivel de elementos de trabajo eligiendo una de estas opciones:
Devolver solo los elementos de trabajo que tengan vínculos especificados: se devuelven los elementos de trabajo de primer nivel, pero solo si tienen vínculos a los elementos de trabajo especificados por los criterios de filtro de los elementos de trabajo vinculados.
Devolver todos los elementos de trabajo de nivel superior: se devuelven todos los elementos de trabajo de primer nivel sin tener en cuenta los criterios de filtro de los elementos de trabajo vinculados. Se devuelven los elementos de trabajo de segundo nivel vinculados al primer nivel si coinciden con los criterios de filtro de los elementos de trabajo vinculados.
Devolver solo los elementos de trabajo que no tengan vínculos especificados: se devuelven los elementos de trabajo de primer nivel, pero solo si no tienen vínculos a los elementos de trabajo especificados por los criterios de filtro de los elementos de trabajo vinculados.
Preguntas y respuestas
P: ¿Qué operadores y variables de consulta se pueden usar?
R: Los operadores y las variables disponibles para la selección dependen del campo que se seleccione. Las cuatro variables son @Project para el campo de nombre de proyecto, @Me para los campos de nombre de persona, @Today para los campos de fecha y hora, y [Any]. Consulta Variables, valores, operadores y campos de consulta.
P: ¿Qué otros ejemplos de consulta hay?
R: Vea Ejemplo de consultas de elementos de trabajo y Ejemplos de consultas del cuadro de búsqueda.
P: ¿Cómo creo un gráfico de los resultados de una consulta?
R: En Visual Studio Online y TWA, puede representar gráficamente los resultados en una consulta de lista plana. Debe ser miembro del grupo de acceso avanzado en TWA.
O bien, puede abrir una consulta en Excel y usar las características de Excel para generar un gráfico.
P: ¿Cómo puedo actualizar automáticamente las consultas en función del sprint o la iteración actuales?
R: No hay ninguna forma automática para hacerlo; tendrá que actualizar manualmente las consultas para que apunten al sprint actual. Si el proyecto de equipo está basado en Scrum o Agile, encontrará un conjunto de consultas en las carpetas Sprint actual o Iteración actual. Para que cada consulta devuelva los elementos definidos para el sprint actual, debe actualizar la ruta de acceso de iteración a la iteración actual en función de la fecha.
Puede cambiar muchas de las consultas guardándolas como archivos .wiq. Abra la consulta en Team Explorer, elija Editar consultay, a continuación, seleccione Archivo, guardar como para guardar cada consulta como un archivo .wiq. A continuación se muestra un ejemplo de consulta de trabajo en curso que se ha actualizado para admitir la versión 2 y el sprint 59.
<?xml version="1.0" encoding="utf-8"?>
<WorkItemQuery Version="1">
<Wiql>
SELECT [System.Id],
[System.WorkItemType],
[System.Title],
[System.AssignedTo],
[System.State],
[Microsoft.VSTS.Scheduling.RemainingWork],
FROM WorkItems
WHERE [System.TeamProject] = @project and
[System.IterationPath] under 'FabrikamPrime\Release 2\Sprint 59' and
[System.WorkItemType] in group 'Microsoft.TaskCategory' and
[System.State] = 'In Progress'
ORDER BY [System.AssignedTo],
[Microsoft.VSTS.Common.BacklogPriority],
[System.Id]
</Wiql>
</WorkItemQuery>
P: ¿Cómo agrego o cambio columnas en la lista de resultados?
R: Abra Opciones de columna para agregar o quitar columnas, cambiar la secuencia de columnas y cambiar el criterio de ordenación dentro de una columna.
.png "Pestaña Mostrar columnas del cuadro de diálogo Opciones de columna")
Además, en la lista de resultados, puede arrastrar una columna a una nueva posición y seleccionar el título de la columna para cambiar el criterio de ordenación por columnas.
P: ¿Se puede filtrar una consulta mediante etiquetas?
R: Sí, si utiliza Visual Studio Online o si su TFS local dispone de las actualizaciones de TFS 2013 Update 2; de no ser así, no en el caso de implementaciones locales.
En Visual Studio Online y Visual Studio 2013 Update 2, puede elegir Etiquetas como campo para filtrar. Asimismo, puede abrir una consulta en Excel y modificar en bloque las etiquetas asignadas a los elementos de trabajo. También puede agregar etiquetas a los elementos de trabajo con Visual Studio.
Desde el complemento de Team Explorer para Eclipse puede filtrar las consultas por etiquetas, pero no es posible agregar o modificar etiquetas desde la interfaz de usuario. Para ello debe usar el portal web.
En el caso de TFS locales sin TFS 2013 Update 2, puede mostrar las etiquetas como una columna en los resultados de la consulta, y puede filtrar una lista en función de una etiqueta; sin embargo, no puede agregar etiquetas como una cláusula a los criterios de filtro.
P: ¿Se pueden usar resultados de la consulta para modificar rápidamente relaciones vinculadas?
R: Desde el complemento de Team Explorer para Visual Studio puede aplicar sangría (.png "Sangría"){kind=icon}
), anular sangría (.png "Anular sangría"){kind=icon}
) y arrastrar elementos de trabajo para modificar la jerarquía.
Además, puede abrir una consulta en Excel o Project para modificar de manera masiva los vínculos primario-secundario y predecesor-sucesor.
P: ¿Cómo evito que alguien cambie una consulta que comparto con el equipo?
R: Establezca permisos de lectura en la consulta.
P: ¿Cómo agrego una consulta a Consultas compartidas o como favorita del equipo?
R: Para guardar una consulta en la carpeta Consultas compartidas, pida que le agreguen al grupo de administradores de proyectos o que le establezcan permisos para una carpeta en Consultas compartidas.
Para agregar una consulta como favorita del equipo, abra el menú contextual para la consulta y agréguela como favorita del equipo. Debe ser administrador del equipo para agregar consultas a los favoritos del equipo.
Solo puede agregar consultas compartidas a los favoritos del equipo, y solo si dispone de permisos de administrador del equipo.
P: ¿Se pueden agregar carpetas a los favoritos del equipo?
R: No. Solo puede agregar carpetas en Mis consultas y Consultas compartidas.
P: ¿Se puede enviar una consulta por correo electrónico?
R: Sí. Consulta Enviar por correo electrónico vínculos con la dirección URL de elementos de trabajo y consultas de TFS.
P: ¿Se puede definir un hipervínculo que abra una consulta?
R: Sí. La manera más fácil de definir un hipervínculo es crear una consulta que coincida con lo que desea y copiar a continuación la dirección URL para dicha consulta. El hipervínculo usa el lenguaje de consultas de elementos de trabajo (WIQL), similar a Transact-SQL, y sigue esta sintaxis:
**http://NombreDeServidor:**Puerto/ /tfs/NombreDeColección/NombreDeProyectoDeEquipo/**q.aspx?pname=Proyecto&wiql=**LenguajeDeConsultaDeElementoDeTrabajo
Por ejemplo, el hipervínculo siguiente muestra el identificador, el título y el estado de todos los errores que tienen el número de compilación 9.0.30304 definido para el proyecto AdventureWorksProject.
http://AdventureWorks:8080/tfs/ /q.aspx?pname=AdventureWorksProject&wiql==SELECT [System.ID], [System.Title], [System.State] FROM WorkItems WHERE [System.TeamProject]='AdventureWorksProject' AND [System.WorkItemType]='Bug' AND [System.FoundIn]='9.0.30304' http://Server1:8091/tfs/web/wi.aspx?id=9035
P: ¿Se puede exportar una consulta?
R: Sí. En el editor de consultas en Team Explorer, use el menú Archivo para guardar una consulta como un archivo .wiq. Cuando se crea un proyecto de equipo, se crean consultas compartidas basadas en los archivos .wiq definidos en la plantilla de proceso.
P: ¿Por qué los contenidos del panel de tareas son distintos de los que aparecen con su consulta creada?
R: Es posible asignar tareas a una iteración, pero no vincularlas a un elemento de trabajo pendiente primario. Estos elementos se mostrarán en la consulta creada, pero no en el panel de tareas en sí. TFS ejecuta la consulta y, luego, aplica algunos procesos en segundo plano antes de mostrar los elementos del panel de tareas.
Estas tres razones pueden hacer que los elementos que pertenecen a la categoría de tarea no aparezcan en un panel de tareas o trabajo pendiente de sprint:
La tarea no se ha vinculado a un elemento de trabajo pendiente primario. Solo aparecerán en la página de trabajo pendiente del sprint los errores y las tareas que vinculó a un elemento de trabajo pendiente principal (Scrum), caso de usuario (Agile) o requisito (CMMI) cuya ruta de acceso de iteración esté establecida en el sprint.
La tarea es la tarea primaria de otra tarea. Si ha creado una jerarquía de tareas, solo se muestran las tareas de nivel secundario en la parte inferior de la jerarquía.
La tarea primaria vinculada de una tarea se corresponde con un elemento de trabajo pendiente definido para otro equipo. O bien, la ruta de acceso de área del elemento de trabajo pendiente primario de la tarea difiere de la ruta de acceso de área de la tarea.
P: ¿Se pueden consultar los elementos de trabajo mediante programación?¿Puedo crear una consulta dinámica?
R: Sí. Consulta Consultar errores, tareas y otros elementos de trabajo.
Vea también
Conceptos
Elegir el cliente de Team Foundation apropiado para sus tareas