Especificar criterios de filtro para consultas

Se pueden especificar los criterios de filtro para que la consulta encuentre elementos de trabajo de su interés o del interés de su grupo.Se pueden utilizar las macros en la consulta para comprobar lo que se le ha asignado, cuáles son sus tareas activas, o para encontrar los elementos que se han actualizado recientemente.

Todas las consultas de elementos de trabajo constan de una o más cláusulas de consulta.Cada cláusula incluye un campo, un operador y un valor.Agregue, modifique y agrupe las cláusulas y los campos en las consultas para encontrar el conjunto de elementos de trabajo que sean de su interés.Definir una consulta es, a menudo, un proceso iterativo, en el que los criterios de filtro se ajustan hasta obtener los resultados deseados.

En este tema

1. Seleccionar el tipo de consulta

2. Especificar los criterios de filtro para consultas de nivel superior

3. (Opcional) Especificar los criterios de filtro para buscar elementos de trabajo vinculados

4. Agregar, quitar, agrupar o desagrupar cláusulas de consulta

5. Ejecutar o cancelar una consulta y comprobar los resultados

6. Ajustar los criterios de filtro para su consulta

[!NOTA]

Los siguientes procedimientos se han escrito para Team Explorer.Los procedimientos para Team Web Access son similares pero pueden variar ligeramente en los detalles.

Requisitos

• Hay que ser miembro del grupo Lectores o tener el permiso Ver los elementos de trabajo en este nodo establecido en Permitir.Para obtener más información sobre permisos de consulta, consulte Buscar errores, tareas y otros elementos de trabajo.

1.Seleccionar el tipo de consulta

1. Abra el proyecto del equipo, seleccione la página Elementos de trabajo y, a continuación, elija Nueva consulta.

   Se abre una nueva consulta Lista plana de elementos de trabajo (predeterminado).

2. En la barra de herramientas de consulta, seleccione el Tipo de consulta según el tipo de vista o elementos de trabajo que desea buscar:

   •  Lista plana (predeterminado): Devuelve un único nivel, la lista plana de elementos de trabajo que coinciden con sus criterios de filtro.Utilice este tipo de consulta para buscar los elementos de trabajo que desee vincular a otros elementos de trabajo, exportar elementos de trabajo a Office Excel y Office Project para las actualizaciones masivas a los campos de columna, o generar un informe sobre un conjunto de elementos de trabajo.Para obtener más información, vea Trabajar con una consulta de lista plana (predeterminado).

   • Elementos de trabajo y vínculos directos: Devuelve un conjunto de dos niveles de elementos de trabajo que coinciden con sus criterios de filtro y todos los elementos de trabajo vinculados a ellos, basándose en criterios de filtros secundarios.Esta vista muestra los elementos de trabajo en una vista expansible o contraíble.Para obtener más información, vea Trabajar con dependencias vinculadas (Vínculos directos).

   •  Árbol de elementos de trabajo: Devuelve un conjunto de varios niveles de los elementos de trabajo que coinciden con sus criterios de filtro e incluye todos los elementos de trabajo vinculados a los elementos de trabajo de nivel superior basados en los vínculos primario-secundario.Esta vista muestra los elementos de trabajo en una vista jerárquica expansible y contraíble.Para obtener más información, vea Trabajar con jerarquías vinculadas (Árbol de elementos de trabajo).

   Para obtener un resumen de las tareas admitidas por cada tipo de consulta, consulte Seleccionar la herramienta derecha de la consulta para la tarea.

Volver al principio

2.Especificar los criterios de filtro para las consultas de nivel superior

Los criterios de filtro de nivel superior limitan los resultados de la consulta a un proyecto de equipo y un tipo de elemento de trabajo.

[!NOTA]

Los criterios de filtro predeterminado definidos para una nueva consulta devuelven todos los elementos de trabajo (Tipo de elemento de trabajo=[Cualquiera] y Estado=[Cualquiera]) que están asignados al usuario (Asignado a=@Me) para el proyecto de equipo actual (Proyecto de equipo=@Project).

Si trabaja en varios proyectos de equipo, quizá desee realizar búsquedas en todos ellos con una única consulta.

1. Especifique los proyectos de equipo que contienen los elementos de trabajo que desea buscar.Si desea devolver elementos de trabajo para:

   • El proyecto de equipo actual, mantenga Proyecto de equipo=@Project.

   • Otro proyecto de equipo, escriba el nombre del proyecto de equipo en la columna Valor para el campo Proyecto de equipo.

   • Varios proyectos de equipo, escriba los valores que se muestran en la tabla siguiente:

     And/Or	Campo	Operador	Valor
     	Proyecto de equipo	In	<nombre del primer proyecto de equipo>, <nombre del segundo proyecto de equipo>,...

     Separe los nombres de los proyectos de equipo mediante comas (,).

2. Especifique el tipo de elementos de trabajo que desee buscar.Si desea devolver elementos de trabajo para:

   • Todos los tipos, mantenga Tipo de elemento de trabajo=[Cualquiera].

   • Un tipo único, elija la columna Valor para el campo Tipo de elemento de trabajo y, a continuación, elija el tipo de elemento de trabajo que desee.

   • Varios tipos de elemento de trabajo, escriba los valores mostrados en la tabla siguiente:

     And/Or	Campo	Operador	Valor
     Y	Tipo de elemento de trabajo	In	<primer tipo de elemento de trabajo>, <segundo tipo de elemento de trabajo>,...

     Separe los nombres de cada tipo de elemento de trabajo con comas (,).

   • Todos los tipos de elemento de trabajo que pertenecen a una categoría con nombre, escriba los valores mostrados en la tabla siguiente:

     And/Or	Campo	Operador	Valor
     Y	Tipo de elemento de trabajo	En grupo	<nombre del grupo de tipos de elemento de trabajo>

     Para obtener información sobre cómo definir los grupos de tipos de elementos de trabajo, consulte Personalizar las categorías de tipos de elemento de trabajo [witadmin].

     Para obtener las opciones adicionales que puede usar para filtrar los criterios de nivel superior, vea la sección "Operadores" en Variables, valores, operadores y campos de las consultas.

3. En la barra de herramientas de consulta, haga clic en Ejecutar y confirme si la consulta ha devuelto los resultados que esperaba.

4. Elija Guardar consulta.Para obtener más información, vea Guardar, copiar, cambiar de nombre y eliminar consultas de elementos de trabajo.

Volver al principio

3.(opcional) Especificar los criterios de filtro para buscar elementos de trabajo vinculados

Si seleccionó Elementos de trabajo y vínculos directos o Árbol de elementos de trabajo, puede especificar los criterios de filtro para los elementos de trabajo vinculados así como qué elementos de trabajo del nivel superior se encuentran.

Para especificar los criterios de filtro para una consulta de elementos de trabajo y vínculos directos

1. Seleccione Y los elementos de trabajo vinculados que coincidan con la siguiente consulta.Agregue y agrupe las cláusulas de la misma forma en que las definió para los criterios del nivel superior.

   Criterios de filtro para los elementos de trabajo vinculados

   

2. Seleccione un elemento en Filtros de vínculos para filtrar la lista del primer nivel de los elementos de trabajo:

   • 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.Los elementos de trabajo del segundo nivel que están vinculados al primer nivel se devuelven si coinciden con los criterios de filtro de los elementos de trabajo vinculados.

   • Devolver sólo los elementos de trabajo que tengan vínculos especificados: Sólo se devuelven los elementos de trabajo del primer nivel que tienen vínculos con los elementos de trabajo especificados por los criterios de filtro para los elementos de trabajo vinculados.

   • Devolver sólo los elementos de trabajo que no tengan vínculos especificados: Sólo se devuelven los elementos de trabajo del primer nivel que no tienen vínculos con los elementos de trabajo especificados por los criterios de filtro de los elementos de trabajo vinculados.

3. (Opcional) Elija en Devolver los tipos de vínculos seleccionados y, a continuación, active una o más de las casillas disponibles para que los tipos de vínculos se incluyan en los criterios de filtro.

4. En la barra de herramientas de consulta, elija Ejecutar y confirme si la consulta ha devuelto los resultados que esperaba.

5. Modifique los criterios de filtro y vuelva a ejecutar la consulta hasta que obtenga los niveles primero y segundo de los elementos de trabajo que desea.

Para especificar el criterio de filtro de un árbol de elementos de trabajo

1. En Filtros de elementos de trabajo vinculados, agregue y agrupe las cláusulas de la misma forma en que las definió para los criterios del nivel superior.

2. Seleccione los Filtros de vínculo que además filtrarán su lista del primer nivel de elementos de trabajo como se indica a continuación:

   1. Coincidir primero los elementos de trabajo del primer nivel: Realiza una búsqueda en profundidad.Se devuelven todos los elementos de trabajo del primer nivel.Se devuelven todos los elementos de trabajo vinculados al primer nivel si coinciden con los criterios de filtro de los elementos de trabajo vinculados.

   2. Coincidir primero los elementos de trabajo vínculados: Realiza una búsqueda de abajo a arriba.Encuentra todos los elementos de trabajo vinculados, después devuelve los elementos de trabajo del primer nivel que están vinculados a los elementos encontrados.

3. (Opcional) Elija Tipo de árbol.Si ha añadido tipos de vínculos personalizados de topología de árboles, puede elegir desde los valores listados hasta un conjunto personalizado de tipos de vínculos jerárquicos.Vea Referencia de elemento de tipo de vínculo.

4. En la barra de herramientas de consulta, elija Ejecutar y confirme si la consulta ha devuelto los resultados que esperaba.

5. Modifique los criterios de filtro y vuelva a ejecutar la consulta hasta que obtenga los niveles primero y segundo de los elementos de trabajo que desea.

Volver al principio

4.Agregar, quitar, agrupar o desagrupar cláusulas de consulta

Puede agregar una nueva cláusula para que cada campo de elemento de trabajo con el fin de afinar sus criterios de búsqueda y devolver sólo el conjunto de elementos de trabajo que desee.Si no recibe los resultados esperados de la consulta, puede agregar, quitar, agrupar o desagrupar las cláusulas de la consulta para afinar los resultados de la misma.Para obtener información sobre los elementos en una cláusula de consulta, vea Variables, valores, operadores y campos de las consultas.

Cada cláusula de consulta incluye un nombre de campo, un operador de consulta y un valor.Utilice tantas cláusulas como sea necesario para obtener resultados útiles.

Puede agrupar las cláusulas de consulta para que funcionen como una sola unidad independiente del resto de la consulta; el resultado es similar al obtenido al colocar unos paréntesis alrededor de una expresión en una ecuación matemática o una declaración lógica.Cuando se agrupan cláusulas, los operadores And y Or de la primera cláusula del grupo se aplican a todo el grupo.

Tal y como se muestra en la tabla siguiente, las cláusulas agrupadas se convierten en la expresión lógica correspondiente.La primera expresión devuelve 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	Expresiones lógica
	Priority=1 OR (Work Item Type=Bug AND State=Active)
	Priority=1 AND (Work Item Type=Bug OR State=Active)

Para agregar, quitar, agrupar o desagrupar cláusulas de consulta

1. Puede agregar una cláusula en una de las maneras siguientes:

   1. Para agregar la cláusula al final de los criterios de filtro, elija Haga clic aquí para agregar una nueva cláusula.

   2. O, para insertar una cláusula, elija la celda en la primera columna en la que desea insertar la cláusula para resaltar la fila, abra el menú contextual, y después elija Insertar cláusula.

      Se agregará una nueva fila de cláusula de consulta en el lugar donde estaba el cursor.

   3. Si desea que la cláusula sea tratada como una cláusula Or, elija el botón de la flecha hacia abajo junto a And y, a continuación, elija Or.

      Elija And si esta cláusula yla anterior deben ser ser true para que coincidan con un resultado.Elija Or si esta cláusula o la anterior deben ser true para que coincidan con un resultado.

   4. Especifique los valores para Campo, Operador y Valor.

      Columna de consulta	Uso
      Campo	Especifique un campo para el tipo de elementos de trabajo que desee buscar.El conjunto de elementos de trabajo se filtra según el Operador y los Valores definidos para el campo. Presione ALT+FLECHA ABAJO o escriba el nombre del campo que desea seleccionar.
      Operador	Especifique cómo compara la consulta el valor encontrado en el campo especificado de un registro.Ejemplos de operadores son = (igual), <> (distinto de), > (mayor que), < (menor que), >= (mayor o igual a), <= (menor o igual a), Contiene, No contiene, En y Fue.
      Valor	Especifique el valor que desea buscar en el campo seleccionado.Si hay una lista de valores entre los que puede seleccionar, haga clic en la flecha para seleccionar el valor que desee.Puede especificar una variable de consulta para agregar los valores a su consulta dinámicamente. Si hay una lista de valores entre los que puede seleccionar, haga clic en la flecha para seleccionar el que desee.Si hay varios valores que desea filtrar, utilice al operador In para especificar una lista de valores delimitada por comas.Para especificar un valor dinámico, especifique una variable de consulta válida.

      Para obtener más información, vea Variables, valores, operadores y campos de las consultas.

2. Para eliminar una cláusula de consulta, abra el menú contextual de la cláusula y, a continuación, elija Eliminar cláusulas.

3. Agrupe las cláusulas de consulta de elementos de trabajo siguiendo estos pasos:

   1. En la consulta, seleccione las cláusulas de consulta que desea combinar en un grupo y elija la celda situada más a la izquierda en las filas.Presione CTRL y haga clic para seleccionar varias filas.

   2. Abra el menú contextual de las cláusulas seleccionadas y, a continuación, elija Cláusulas de grupo.

      Aparecerá en el margen izquierdo de la consulta un corchete que indica que las cláusulas están agrupadas.

4. Desagrupe las cláusulas de consulta de elementos de trabajo siguiendo estos pasos:

   1. En su consulta, seleccione todas las cláusulas de consulta agrupadas que desea desagrupar haciendo clic en la celda situada más a la izquierda en las filas.Presione CTRL y haga clic para seleccionar varias filas.

   2. Abra el menú contextual del grupo y, a continuación, elija Desagrupar cláusulas.

      El corchete se quitará del margen izquierdo de la consulta y las cláusulas se desagruparán.

      [!NOTA]

      Si Desagrupar cláusulas no está disponible, eso quiere decir que no han seleccionado todas las cláusulas de la agrupación de consulta.Seleccione todas las cláusulas e inténtelo de nuevo.

Volver al principio

5.Ejecutar o cancelar una consulta y comprobar los resultados

Puede ejecutar una consulta de elementos de trabajo para buscar los elementos de trabajo del proyecto de equipo que cumplen sus criterios de consulta.Si modifica los elementos de trabajo que cambian los resultados de una consulta, puede volver a ejecutar la consulta para actualizar los resultados.

1. En la barra de herramientas de consulta, elija Ejecutar.

   [!NOTA]

   Puede agregar cualquier campo definido para los elementos de trabajo que está buscando con el fin de controlar la forma en que se muestran y ordenan los resultados de la consulta.Para obtener más información, vea Agregar, quitar, reordenar y ordenar columnas.

2. Para cancelar la búsqueda de consulta, elija Detener consulta o, en el menú Equipo, elija Detener actualización.

3. Revise los resultados de la consulta.Si la lista de elementos de trabajo no coincide el criterio de búsqueda que esperaba, revise y modifique los criterios de filtro según sea necesario.

Volver al principio

6.Ajustar los criterios de filtro de la consulta

• Si los resultados de la consulta no devuelven el conjunto esperado de elementos de trabajo, realice las comprobaciones siguientes:

  • Compruebe cada cláusula para asegurarse de que se ha definido como deseaba.

  • Compruebe las asignaciones And/Or 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 .

  • Compruebe la agrupación de las cláusulas de consulta y las asignaciones de And/Or 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 los campos, operadores y valores tal y como se describe en Variables, valores, operadores y campos de las consultas.Determine si desea modificar una cláusula de consulta para usar un campo, operador o valor diferente.

Volver al principio

Vea también

Tareas

Trabajar con una consulta de lista plana (predeterminado)

Trabajar con jerarquías vinculadas (Árbol de elementos de trabajo)

Conceptos

Variables, valores, operadores y campos de las consultas

Ejemplo de consultas de elementos de trabajo

Buscar errores, tareas y otros elementos de trabajo

Otros recursos

Trabajar con dependencias vinculadas (Vínculos directos)