Definición de una consulta de elemento de trabajo en Azure Boards

Junto con los filtros que se usan desde el Editor de consultas, puede filtrar interactivamente el resultado de una consulta mediante la función Filter. Para obtener información sobre cómo hacerlo, consulte Filtrado interactivo de los proyectos pendientes, paneles, consultas y planes.

Requisitos previos

Abrir consultas

Definición de una consulta de lista plana

Puede iniciar una consulta nueva y nueva desde la pestaña Consultas del portal web o la pestaña Elementos de trabajo Team Explorer.

Consulta en proyectos o dentro de estos

De forma predeterminada, el ámbito de las consultas nuevas es el proyecto actual. Sin embargo, puede crear consultas para buscar elementos de trabajo definidos dentro de la organización o la colección de proyectos. Sin embargo, todas las consultas que guarde se guardan en un proyecto específico.

• Browser
• Visual Studio

Para enumerar los elementos de trabajo definidos en dos o más proyectos, marque la casilla Consulta entre proyectos. Por ejemplo, la consulta siguiente busca todas las características creadas en todos los proyectos en los últimos 30 días.

Nota

La característica Consulta entre proyectos es compatible con TFS 2015.1 y versiones posteriores.

Con la opción Consulta entre proyectos activada, puede agregar el campo Team Project para filtrar a un número selecto de proyectos.

Nota

Separe varios nombres de proyecto con el separador de lista correspondiente a la configuración regional definida para el equipo cliente, por ejemplo, una coma (,).

El campo Team Project solo está disponible después de comprobar Consulta entre proyectos. Además, cuando la opción Consulta entre proyectos está desactivada, solo aparecerán en el menú desplegable Campo los campos de esos tipos de elemento de trabajo, tal como se define en el proyecto actual. Cuando la opción Consulta entre proyectos está activada, todos los campos de todos los tipos de elementos de trabajo definidos en todos los proyectos de la colección aparecen en el menú desplegable Campo.

Para buscar todas las características creadas en todos los proyectos en los últimos 30 días, quite la cláusula Team Project=@Project de la consulta.

Todos los campos de todos los tipos de elementos de trabajo definidos en todos los proyectos de la colección siempre aparecen en el menú desplegable Campo.

Use Team Project=@Project para definir el ámbito de la consulta para buscar solo los elementos de trabajo definidos para el proyecto actual.

Definición de una cláusula

Cree una consulta mediante la definición de una o varias cláusulas. Cada cláusula define un criterio de filtro para un solo campo.

Cláusula de consulta de ejemplo

Para obtener una lista de los operadores disponibles basados en el tipo de datos de campo, vea Referencia rápida del índice de consulta.

Todas las cláusulas que agregue se agregan como una instrucción And. Elija O para cambiar la agrupación. Las cláusulas se agrupan para asegurarse de que las instrucciones de cláusula se ejecutan en la secuencia necesaria.

Lista de comprobación para definir una cláusula de consulta

1. En la primera fila vacía, en el encabezado Columna de campo, elija la flecha abajo para mostrar la lista de campos disponibles y elija un elemento de la lista.

   Para obtener más información, vea Campos y valores de consulta.

2. En la misma fila, en el encabezado de columna Operador, elija la flecha abajo para mostrar la lista de operadores disponibles y elija un elemento de la lista.

   Para obtener más información, vea Operadores (Guía de programación de C#).

3. En la misma fila, en el encabezado columna Valor, escriba un valor o elija la flecha abajo y elija un elemento de la lista.

   Para obtener más información sobre cómo usar una macro o variable para especificar el proyecto, el usuario, la fecha u otra selección actuales, vea Variables.

4. Para agregar una cláusula, elija Agregar nueva cláusula.

   Puede agregar una cláusula al final de la consulta, insertar una cláusula después de una cláusula existentede cláusula de inserción) y quitaricono de cláusula remove ), agruparde cláusula de grupo) y desagrupar ( icono de cláusula) cláusulas según sea necesario.

Uso de un árbol de elementos de trabajo para ver jerarquías

Use la consulta Árbol de elementos de trabajo para ver una lista anidada de elementos de trabajo de varios niveles. Por ejemplo, puede ver todos los elementos de trabajo pendiente y sus tareas vinculadas. Expanda los nodos (Expandir nodo () o contraiga (Contraer) para centrarse en diferentes partes del árbol.

Defina los criterios de filtro para los elementos de trabajo primarios y secundarios. Para buscar elementos secundarios vinculados, seleccione Primero Buscar elementos de trabajo de nivel superior. Para buscar elementos de trabajo vinculados, seleccione Buscar elementos de trabajo vinculados en primer lugar.

Uso de vínculos directos para ver las dependencias

Use la consulta Elementos de trabajo y Vínculos directos para realizar un seguimiento de los elementos de trabajo que dependen de otro trabajo de 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.

Use la consulta de vínculos directos para realizar un seguimiento de las dependencias entre equipos. La consulta también le ayuda a administrar los compromisos que realiza su equipo. Elija los criterios de filtro para los elementos de trabajo superiores y vinculados. Y, seleccione los tipos de vínculos para filtrar las dependencias.

Para más información sobre cada tipo de vínculo, consulte Vinculación, rastreabilidad y administración de dependencias.

Expresión lógica y/o

Especifique And oOr para crear expresiones lógicas de las cláusulas de consulta. Especifique Y para buscar elementos de trabajo que cumplan los criterios de la cláusula actual y la cláusula anterior. Especifique O para buscar elementos de trabajo que cumplan el criterio en la cláusula actual o en la cláusula anterior.

Agregue una nueva cláusula para cada campo de elemento de trabajo para refinar los criterios de búsqueda. Agregue cláusulas para devolver solo el conjunto de elementos de trabajo que desee. Si no recibe los resultados esperados de la consulta, refine. Puede agregar, quitar, agrupar o desagrupar cláusulas de consulta para mejorar los resultados de la consulta.

Agrupar cláusulas de consulta para que funcionen como una sola unidad independiente del resto de la consulta. La agrupación de cláusulas es similar a colocar paréntesis alrededor de una expresión en una ecuación matemática o instrucción lógica. Cuando se agrupan cláusulas, AND u OR para la primera cláusula del grupo se aplica a todo el grupo.

Cláusulas de grupo

Las cláusulas agrupadas funcionan como una sola unidad independiente del resto de la consulta. La agrupación de cláusulas es similar a colocar paréntesis alrededor de una ecuación matemática o una expresión lógica. El operador And o Or de la primera cláusula del grupo se aplica a todo el grupo.

Como se muestra en los ejemplos siguientes, las cláusulas agrupadas se traducen a la expresión lógica correspondiente.

Consulta	Cláusulas agrupadas	Expresión lógica
1
2
3

Estas consultas devuelven elementos de trabajo que son de tipo Bug y cumplen las siguientes expresiones lógicas:

• Consulta 1:AND State=Active OR Assigned to @Me
• Consulta 2:AND (State=Active OR Assigned to @Me)
• Consulta 3:OR (State=Active AND Asignado a @Me)

Para agrupar una o varias cláusulas, selecciónelos y, a continuación, elija el icono de cláusulas de grupo.

También puede agrupar varias cláusulas agrupadas. Active las casillas de cada cláusula que ya se haya agrupado. A continuación, elija el icono de cláusulas de grupo.

Si los resultados de la consulta no devuelven los resultados esperados, 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.

Desagrupar una cláusula

Artículos relacionados

Estos son los aspectos básicos sobre la definición de consultas. Para obtener un índice de ejemplos de consulta, vea Consulta de referencia rápida.

• Preguntas más frecuentes sobre consultas
• Gráfico de una consulta de lista plana
• Cambiar opciones de columna
• Índice de campo de elemento de trabajo
• Métodos abreviados de teclado

Azure Boards | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013

Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015 | Visual Studio 2013

Las consultas de elementos de trabajo generan listas de elementos de trabajo en función de los criterios de filtro que proporcione. A continuación, puede guardar y compartir estas consultas administradas con otros usuarios. Por el contrario, las búsquedas semánticas enumeran elementos de trabajo, pero no se pueden guardar ni compartir.

Si se da cuenta de que las consultas tarden demasiado tiempo en devolver resultados, revise la guía para crear consultas de alto rendimiento.

En este artículo, aprenderá lo siguiente:

Para obtener acceso rápido a todas las tareas de consulta, los operadores admitidos ,como , , y (no el operador) basados en el tipo de datos de campo y los ejemplos de consulta, vea Consulta de ContainsIn referencia In Group<>Contains.

Elegir un filtro de consulta

En el Editor de consultas, ejecte las siguientes funciones de filtro. Elija el filtro para ir a un artículo con consultas de ejemplo. Junto con los filtros de consulta, puede aplicar filtros de forma interactiva a los resultados de la consulta.