Variables, valores, operadores y campos de las consultas

Se buscan y crean listas de elementos de trabajo mediante la creación de consultas de elementos de trabajo.Al definir una o más cláusulas, se filtra de todos los elementos de trabajo en un proyecto de equipo o colección de proyectos de equipo el conjunto de elementos de trabajo que le interesen.Para cada cláusula, se especifica un campo, un operador y un valor o variable.Por ejemplo, puede buscar todos los elementos de trabajo en un proyecto de equipo determinado si especifica el campo Proyecto de equipo, el operador igual que (=) y el nombre del proyecto de equipo como valor.En lugar de especificar un valor, puede especificar una variable como @Project, que representa el proyecto de equipo actual.

Cláusula de consulta de ejemplo

And/Or	Campo	Operador	Valor
Y	Proyecto de equipo	=	@Project

Para obtener más información general acerca de las consultas, vea Buscar errores, tareas y otros elementos de trabajo.Para obtener información sobre cómo navegar dentro del editor de consultas o de la vista de consulta mediante los métodos abreviados de teclado, vea Accesos directos del teclado para el editor de consultas y la vista de resultados de la consulta.

En este tema

• And/Or

• Campos de consulta y valores

• Operadores de consulta

• Variables de consulta

• Búsquedas de palabras de texto completo y parcial

• Campos indizados de consulta

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

1. En la primera fila vacía, haga clic bajo el encabezado de la columna Campo, haga clic en la flecha hacia abajo para mostrar la lista de campos disponibles y escoja un elemento en la lista.

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

2. En la misma fila, haga clic bajo el encabezado de columna Operador, haga clic en la flecha hacia abajo para mostrar la lista de operadores disponibles y escoja un elemento en la lista.

   Para obtener más información, vea Operadores.

3. En la misma fila, bajo el encabezado de la columna Valor, debe ya sea escribir un valor, o elegir la flecha hacia abajo y seleccionar un elemento en la lista.

4. Para obtener más información sobre cómo usar las variables para especificar el proyecto de equipo, usuario o fecha actual, vea Variables.

5. Para agregar una cláusula, elija Haga clic aquí para agregar una nueva cláusula o Agregar una nueva cláusula.

   Puede agregar una cláusula al final de la consulta, insertar una cláusula después de una cláusula existente () y quitar (), agrupar () y desagrupar () las cláusulas según sea necesario.

And/Or

Especifique And u Or para crear expresiones lógicas de su cláusula de consulta.Puede especificar And si desea buscar los elementos de trabajo que cumplen los criterios tanto en esta cláusula como en la cláusula anterior.Puede especificar Or si desea buscar los elementos de trabajo que cumplen el criterio ya sea en esta cláusula o en la cláusula anterior.

Puede agregar una nueva cláusula para 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.

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 tengan prioridad 1 y todos los errores activos independientemente de su prioridad.La segunda expresión devuelve todos los elementos de trabajo activos con prioridad 1 y todos los errores con 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 obtener más información, vea Especificar criterios de filtro para consultas.

Campos de consulta y valores

El valor que se especifique para un campo debe ser el mismo del tipo de dato para ese campo.En la siguiente tabla se enumeran los tipos de dato compatibles.

Tipo de datos	Datos almacenados
DateTime	Un momento en el tiempo expresado en Hora universal coordinada (UTC).Puede especificar una variable, como @Today o @Today-1, o un valor, como 1/1/2012.
Double	Un número real, como 0,2 o 3,5.
GUID	Una cadena de caracteres que representa un identificador único.
History	Campo con formato personalizado utilizado para realizar la información histórica.Utilizan este tipo de datos sólo para admitir el campo Historial.Este campo se indiza para la búsqueda de texto completo cuando la búsqueda de texto completo está disponible.Vea Búsquedas de palabras de texto completo y parcial describe más adelante en este tema.
HTML	Cadenas de texto que admiten descripciones con formato, como los campos Descripción o Pasos de reproducción.Estos campos se indizan para la búsqueda de texto completo cuando la búsqueda de texto completo está disponible.Vea Búsquedas de palabras de texto completo y parcial describe más adelante en este tema. Nota Al actualizar Team Foundation Server, el campo Descripción cambia de un tipo de campo de PlainText a HTML.Mediante el comando de witadmin changefield puede revertir el tipo de datos de este campo según sea necesario.Vea Administrar campos de elemento de trabajo [witadmin].
Integer	Un entero de 32 bits con signo, como 0, 1, 2, 34.
PlainText	Cadenas de texto que admiten descripciones largas, como el campo Información de inicio de la aplicación.Estos campos se indizan para la búsqueda de texto completo, cuando la búsqueda de texto completo está disponible.Vea Búsquedas de palabras de texto completo y parcial describe más adelante en este tema.
String	Cadena de texto corta que puede contener hasta 255 caracteres Unicode.
TreePath	Una estructura de árbol de bifurcación, como una ruta de acceso de área o una ruta de acceso de iteración.Debe escoger un elemento en una lista de valores válidos.Puede buscar elementos de trabajo que son iguales que una estructura de árbol o están bajo ella.Para obtener más información, vea Crear y modificar áreas e iteraciones.

Volver al principio

Operadores de consulta

Puede usar operadores de consulta en la tabla siguiente para especificar cómo debe relacionarse cada valor en una cláusula con el valor correspondiente en un elemento de trabajo.Para obtener información sobre el tipo de datos que está asignado a los campos de elemento de trabajo, vea Referencia de campos de elementos de trabajo para Visual Studio ALM.

Operador de consulta	Devuelve elementos de trabajo si el valor en el elemento de trabajo coincide con los criterios mostrados	Tipos de datos aplicables
=	Coincide con el valor en la cláusula.	Número, que incluye Double, GUID, Integer, y String, DateTime, y TreePath
<>	No coincide con el valor en la cláusula.	Número, String, DateTime, y TreePath
>	Es mayor que el valor en la cláusula.	Número, String, y DateTime
<	Es menor que el valor en la cláusula	Número, String, y DateTime
>=	Es mayor o igual que el valor en la cláusula.	Número, String, y DateTime
<=	Es menor o igual que el valor en la cláusula.	Número, String, y DateTime
=[Campo]	Busca el valor contenido en el campo especificado.	Nombre de un campo con el mismo tipo de datos que el campo especificado
<>[Campo]	No busca el valor contenido en el campo especificado.	Nombre de un campo con el mismo tipo de datos que el campo especificado
>[Campo]	Es mayor que el valor contenido en el campo especificado	Nombre de un campo con el mismo tipo de datos que el campo especificado
<[Campo]	Es menor que el valor contenido en el campo especificado	Nombre de un campo con el mismo tipo de datos que el campo especificado
>=[Campo]	Es mayor o igual que el valor contenido en el campo especificado	Nombre de un campo con el mismo tipo de datos que el campo especificado
<=[Campo]	Es menor o igual que el valor contenido en el campo especificado	Nombre de un campo con el mismo tipo de datos que el campo especificado
Contiene	Contiene una coincidencia exacta o parcial de la cadena de texto dentro del campo que seleccionó para filtrar.	String
No contiene	No contiene una coincidencia exacta o parcial de la cadena de texto dentro del campo que seleccionó para filtrar.	String
Contiene las palabras	Contiene la cadena de texto o palabras exactas dentro del campo que haya seleccionado para filtrar.También puede especificar las palabras parciales o las frases que contienen el carácter comodín, *.Para las restricciones, vea Búsquedas de texto completo para los requisitos del servidor y la intercalación.	Campos de Largo- texto que se indizan para la búsqueda de texto completo, que corresponden a todos los campos de PlainText y de HTML y a Título.
No contiene las palabras.	No contiene la cadena de texto o palabras exactas dentro del campo que haya seleccionado para filtrar.	Campos de texto que están indizados para búsqueda de texto completo.
In	Coincide con cualquier valor de un conjunto delimitado.Por ejemplo, puede buscar elementos de trabajo cuyos identificadores son 100, 101 y 102 si especifica esos valores para el campo ID. Importante Separe los valores con el separador de lista que corresponde a la configuración regional definida en el equipo cliente.Por ejemplo, se puede utilizar la coma (,).	Número, String, DateTime, TreePath
En grupo	Coincide con un valor que es un miembro del grupo en la cláusula.Puede especificar un valor predeterminado, personalizado o un grupo de categorías de Team Foundation Server.Por ejemplo, puede crear una consulta para encontrar todos los elementos de trabajo que están asignados a miembros del grupo Contributors. Nota No puede especificar un grupo de seguridad o un grupo de distribución de correo electrónicos como valor.	String que coincide con el nombre de un grupo de usuarios o un grupo de categorías en Team Foundation Server. Nota Puede utilizar el operador En grupo sólo con los campos que usan el tipo de datos de String o el campo Tipo de elemento de trabajo. Para obtener información sobre los grupos de categorías, vea Definir categorías para agrupar los tipos de elementos de trabajo.
No en grupo	No coincide con ningún valor miembro del grupo de la cláusula.	String que coincide con el nombre de un grupo de usuarios en Team Foundation Server o un grupo de categorías definido para un proyecto de equipo. Nota Solo puede usar el operador No en el grupo con los campos que usan el tipo de datos String o el campo Tipo de elemento de trabajo. Para obtener información sobre los grupos de categorías, vea Definir categorías para agrupar los tipos de elementos de trabajo.
Fue	Coincide con el valor en la cláusula en cualquier punto anterior.	String, DateTime
Pertenece a	Coincide con el valor en la cláusula o está contenido bajo el nodo en la cláusula.	TreePath
No pertenece a	No coincide con el valor en la cláusula ni está contenido bajo el nodo en la cláusula.	TreePath

Volver al principio

Variables de consulta

Puede usar las variables de la tabla siguiente para buscar los elementos de trabajo relacionados con el usuario actual, el proyecto actual o la fecha actual.

Variable de consulta	Uso
@Me	Utilice esta variable para buscar automáticamente el alias del usuario actual en un campo que contiene los alias de usuario.Por ejemplo, puede buscar los elementos de trabajo que ha abierto si establece la columna Campo en Activado por, la columna Operador en = y la columna Valor en @Me.
@Project	Utilice esta variable para buscar elementos de trabajo en el proyecto de equipo actual.Por ejemplo, puede buscar todos los elementos de trabajo en el proyecto de equipo actual si establece la columna Campo en Proyecto de equipo, la columna Operador en = y la columna Valor en @Project.
@Today	Utilice esta variable para buscar los elementos de trabajo relacionados con la fecha actual o una fecha anterior.También puede modificar la variable @Today restando días.Por ejemplo, puede buscar todos los elementos activados la semana pasada si establece la columna Campo en Fecha de activación, la columna Operador en >= y la columna Valor en @Today - 7.
[Any]	Utilice esta variable para buscar los elementos de trabajo relacionados con cualquier valor definido para un campo determinado.

Volver al principio

Búsquedas de palabras de texto completo y parcial

Especifique Contiene o No contiene para buscar en coincidencias exactas o parciales de una palabra o una frase.Especifique Contiene palabras o No contiene palabras para buscar en una frase exacta o utilizar el carácter comodín, *.Estos operadores utilizan el índice de búsqueda de texto completo.Puede utilizar el carácter comodín al final de una palabra parcial o una frase.

Para obtener ejemplos, vea Buscar elementos de trabajo en función de palabras clave o frases y Ver el historial y buscar elementos de trabajo mediante el campo Historial.

[!NOTA]

No todas las búsquedas de texto completo compatible con de las implementaciones.Por ejemplo, SQL Express y SQL Azure, que admiten Team Foundation Service, no admiten la búsqueda de texto completo.En estos casos, verá sólo a los operadores Contiene y No contiene.

Contiene palabras y No contiene palabras filtran los elementos según el índice de búsqueda de texto completo creado para los campos de largo- texto.de Team Foundation índices automáticamente todos los campos de largo- texto con un tipo de datos de PlainText y de HTML y el campo Título para la búsqueda de texto completo.El índice y los operadores sólo están disponibles cuando SQL Server que admite Team Foundation Server admite la búsqueda de texto completo.

Las búsquedas de texto completo requieren una intercalación SQL que corresponda con un lenguaje que tenga un separador de palabras registrado con SQL Server.Si la configuración de intercalación para la base de datos de colección de proyectos de equipo utilizada para su instancia de Team Foundation Server no se corresponde con un lenguaje compatible, es posible que los resultados de búsqueda no coincidan con sus expectativas.En estos casos, podría probar el uso de los operadores Contiene o No contiene .

Para obtener más información, consulte Consultas de búsqueda de texto completo y la configuración de intercalación.

Campos indizados de consulta

Además del índice de búsqueda de texto completo, se crea un índice de la consulta.Se basa en los campos que tienen indización habilitada.El índice de la consulta mejora el tiempo de respuesta al ejecutar las consultas que incluyen campos indizados.

De forma predeterminada, se indizan los campos siguientes: Asignada a, Fecha de creación, Modificado por, Situación, Motivo, Identificador de área, Id de iteración, y Tipo de elemento de trabajo.Si hay otros campos que el equipo con frecuencia utiliza en las consultas, puede agregarlas al índice de la consulta.

Utilice el comando de witadmin indexfield de habilitar o deshabilitar la indización para un campo.Vea Administrar campos de elemento de trabajo [witadmin].

Vea también

Tareas

Especificar criterios de filtro para consultas

Trabajar con una consulta de lista plana (predeterminado)

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

Conceptos

Buscar errores, tareas y otros elementos de trabajo

Otros recursos

Trabajar con dependencias vinculadas (Vínculos directos)

Historial de cambios

Fecha	Historial	Motivo
Agosto de 2012	Tabla corregida que describe los tipos de datos de campo y Description quitado del conjunto de campos que se indizan para la búsqueda de texto completo.Agrega dos secciones en andn de las búsquedas de texto completo del índice de la consulta.	Mejora de la información.