Especificar criterios de filtro para consultas

Puede especificar los criterios de filtro para su consulta con el fin de buscar elementos de trabajo y seleccionar más fácilmente los datos filtrados que desea usar. Si usa criterios de filtro diferentes, puede comprobar las tareas que tiene asignadas, cuáles son sus tareas activas o ver una lista de las características asignadas a usted o a su equipo.

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. Para agregar, modificar y agrupar cláusulas y campos en las consultas creadas, puede filtrar el conjunto de elementos de trabajo para satisfacer sus necesidades.

En este tema

Para especificar sus criterios de filtro, complete los siguientes procedimientos hasta que tenga el conjunto de elementos de trabajo que se muestra en la vista Resultados de la consulta:

1. Seleccione el tipo de consulta

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

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

4. Ejecutar o cancelar una consulta y comprobar los resultados de la misma

5. 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.

Para filtrar los criterios por un valor de fecha o un valor que pertenezca a un grupo, vea los procedimientos siguientes:

• Especificar un filtro basado en un valor de fecha y hora

• Especificar un filtro basado en la pertenencia a un grupo

Permisos necesarios

Para realizar estos procedimientos, 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 del equipo, debe ser un miembro del grupo Project Administrators. Para obtener más información, vea Permisos de Team Foundation Server.

Seleccionar el tipo de consulta

Para seleccionar su tipo de consulta en Team Explorer

1. Abra el proyecto de equipo, expanda el nodo Elementos de trabajo y, a continuación, seleccione Consultas del equipo o Mis consultas.

2. En el menú Equipo, haga clic en Agregar consulta. O bien, haga clic con el botón secundario en el nodo Elementos de trabajo, Mis consultas o Consultas de equipo, y después haga clic en Agregar consulta.

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

3. 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 de elementos de trabajo (predeterminado): devuelve un nivel único ( 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 Hacer una lista de elementos de trabajo (lista plana predeterminada).

   • Elementos de trabajo y vínculos directos: devuelve un conjunto de dos niveles de los elementos de trabajo () que coinciden con sus criterios de filtro y todos los elementos de trabajo vinculados a ellos, basado en los criterios de filtro secundarios. Esta vista muestra los elementos de trabajo en una vista expansible o contraíble. Para obtener más información, vea Ver y modificar elementos de trabajo en una vista de 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, basado 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 Ver y modificar elementos de trabajo en una vista de árbol.

Volver al principio

Especificar los criterios de filtro para 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.

Para especificar los criterios de filtro de nivel superior

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, haga clic en la columna Valor para el campo Tipo de elemento de trabajo y, a continuación, haga clic en 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 elemento de trabajo, vea Personalizar categorías para 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. Haga clic en Guardar o Guardar como. Para obtener más información, vea Guardar, copiar, cambiar de nombre y eliminar consultas de elementos de trabajo.

Volver al principio

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.

Las cláusulas de consulta se pueden agrupar para que operen 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 instrucció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 sus criterios de filtro, haga clic en Haga clic aquí para agregar una nueva cláusula.

   2. O bien, para insertar una cláusula, haga clic con el botón secundario en el lugar donde desea insertar la nueva cláusula y, a continuación, haga clic en Insertar cláusula.

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

   3. Si desea tratar la cláusula como una cláusula Or, haga clic en And y, a continuación, haga clic en Or.

      Seleccione And si tanto esta cláusula como la anterior deben ser ambas true para que coincidan con un resultado. Seleccione Or si es necesario que esta cláusula o la anterior sean 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. Elimine una cláusula de consulta haciendo clic con el botón secundario a la izquierda de la fila de la cláusula que desea eliminar y, a continuación, haga clic en Eliminar cláusulas.

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

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

   2. Haga clic con el botón secundario en las cláusulas seleccionadas y, a continuación, haga clic en Agrupar cláusulas.

      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. Haga clic con el botón secundario en el grupo y, a continuación, haga clic en 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

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.

Para ejecutar o cancelar una consulta según los criterios de filtro para la consulta

1. En la barra de herramientas de consulta, haga clic en 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 su búsqueda de consulta, haga clic en Detener consulta o, en el menú Equipo, haga clic en 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

Ajustar los criterios de filtro para su consulta

Para ajustar sus criterios de filtro

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

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

  2. Compruebe las asignaciones de 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.

  3. Compruebe la agrupación de las cláusulas de consulta y las asignaciones de And/Or de cada cláusula agrupada.

  4. Agregue más cláusulas de consulta para afinar los criterios de filtro para su consulta.

  5. 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

Especificar un filtro basado en un valor de fecha y hora

Puede ordenar los elementos de trabajo por la fecha en la que se cambiaron o para un período de tiempo concreto. Si limita el ámbito de la consulta, puede ayudar a mejorar el rendimiento, ya que devuelve sólo aquellos resultados que están dentro del intervalo de fechas que desea incluir.

Para buscar elementos de trabajo basándose en criterios de filtro específicos de la fecha

1. Busque los elementos de trabajo modificados hoy siguiendo estos pasos:

   1. Seleccione un Campo que sea un tipo de datos de fecha para agregar o modificar una cláusula de consulta.

      Nota

      La mayoría de los campos de fecha contienen la palabra "fecha" en el nombre del campo.

   2. En la columna Operador, seleccione = (Igual).

   3. En la columna Valor, haga clic en la flecha y seleccione @Today para la fecha de hoy.

      Nota

      Puede modificar esta variable para buscar la fecha actual menos varios días. Por ejemplo, para buscar todos los elementos iniciados la pasada semana, establecería la columna Campo en Fecha de activación, la columna Operador en >= y la columna Valor en @Today - 7.

   4. Haga clic en Ejecutar y compruebe los resultados de la consulta.

2. Busque los elementos de trabajo modificados en una fecha concreta siguiendo estos pasos:

   1. Seleccione un Campo que sea un tipo de datos de fecha para agregar o modificar una cláusula de consulta.

   2. En la columna Operador, seleccione = (Igual).

   3. En la columna Valor, escriba la fecha que sigue el formato admitido por el sistema operativo de su equipo.

   4. Haga clic en Ejecutar y compruebe los resultados de la consulta.

3. Busque los elementos de trabajo modificados a lo largo de un intervalo de fechas siguiendo estos pasos:

   1. Seleccione un Campo que sea un tipo de datos de fecha para agregar o modificar una cláusula de consulta.

   2. En la columna Operador, elija > (mayor que) si sólo desea buscar los elementos posteriores a la fecha especificada, o >= (mayor o igual que) si desea buscar los elementos que incluyan la fecha seleccionada.

   3. En la columna Valor, escriba la primera fecha del intervalo de fechas que siguen el formato de fecha admitido por el sistema operativo del equipo.

   4. Inserte otra cláusula de consulta directamente bajo la cláusula de consulta anterior.

   5. En columna de asignaciones And/Or, seleccione And.

   6. En la columna Operador, elija < (menor que) si sólo desea buscar los elementos anteriores a la fecha especificada, o <= (menor o igual que) si desea buscar los elementos que incluyen la fecha seleccionada.

   7. En la columna Valor, escriba la última fecha del intervalo de fechas en un formato admitido por el sistema operativo del equipo.

   8. En la columna Operador, seleccione = (Igual).

   9. En la columna Valor, escriba la fecha que sigue el formato admitido por el sistema operativo de su equipo.

   10. Seleccione las dos cláusulas de consulta específicas de la fecha y agrúpelas.

   11. Haga clic en Ejecutar y compruebe los resultados de la consulta.

Volver al principio

Especificar un filtro basado en la pertenencia a un grupo

Puede usar los operadores En grupo o No en grupo para filtrar una consulta en función de varios valores que sean o no miembros de un grupo. Puede especificar grupos de distribución de Team Foundation Server o una o varias categorías de tipos de elementos de trabajo.

Para buscar elementos de trabajo basándose en un valor que pertenece a un grupo

1. Especifique los siguientes tipos de cláusulas:

   • Agregue la siguiente cláusula para buscar elementos de trabajo que estén asignados a cualquier usuario que pertenezca al grupo Project Administrators:

     And/Or	Campo	Operador	Valor
     Y	Asignado a	En grupo	Project Administrators

   • Agregue la cláusula siguiente para buscar elementos de trabajo activos que sean de cualquier tipo de elemento de trabajo en el grupo de categorías Prueba:

     And/Or	Campo	Operador	Valor
     Y	Estado	=	Activo
     Y	Tipo de elemento de trabajo	En grupo	Prueba

   Para obtener información sobre los grupos de categorías, vea Agrupar los tipos de elemento de trabajo en categorías.

2. Haga clic en Ejecutar consulta y compruebe los resultados de la consulta.

Volver al principio

Vea también

Tareas

Agregar, quitar, reordenar y ordenar columnas

Guardar, copiar, cambiar de nombre y eliminar consultas de elementos de trabajo

Hacer una lista de elementos de trabajo (lista plana predeterminada)

Ver y modificar elementos de trabajo en una vista de vínculos directos

Ver y modificar elementos de trabajo en una vista de árbol

Conceptos

Variables, valores, operadores y campos de las consultas

Buscar errores, tareas y otros elementos de trabajo

Historial de cambios

Fecha	Historial	Motivo
Agosto de 2010	Se ha agregado un ejemplo acerca de cómo se evalúa lógicamente una cláusula agrupada.	Comentarios de los clientes.
Septiembre de 2010	Se ha corregido el ejemplo del operador En grupo.	Comentarios de los clientes.