Variables, valores, operadores y campos de consulta

Para buscar y crear listas de elementos de trabajo, cree consultas de elementos de trabajo. Al definir una o más cláusulas, puede filtrar el conjunto de elementos de trabajo que le interesen de entre todos los elementos de trabajo de un proyecto de equipo o colección de proyectos de equipo. Para cada cláusula, se especifica un campo, un operador y un valor o una variable. Por ejemplo, puede buscar todos los elementos de trabajo de 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

Y/O	Campo	Operator	Valor
Y	Proyecto de equipo	=	@Project

Para obtener más información sobre consultas, vea Consultar elementos de trabajo. Para obtener más información sobre cómo desplazarse por el editor de consultas o la vista de consultas usando métodos abreviados de teclado, vea el tema sobre Métodos abreviados de teclado: Visual Studio Online, portal web de TFS y Team Explorer.

En este tema

• Y/O

• Campos de consulta y valores

• Operadores de consulta

• Variables de consulta

• Búsquedas de texto completo y de palabras parciales

• Consultar campos indizados

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

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

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

2. En la misma fila, bajo el encabezado de columna Operador, elija la flecha abajo para mostrar la lista de operadores disponibles y elija 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, escriba un valor o elija la flecha abajo, y elija 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.

Y/O

Especifique Y u O para crear expresiones lógicas de las cláusulas de consulta. Puede especificar Y si desea buscar los elementos de trabajo que cumplen los criterios tanto de la cláusula actual como de la anterior. Puede especificar O si desea buscar los elementos de trabajo que cumplen el criterio ya sea de la cláusula actual o de la anterior.

Puede agregar una nueva cláusula para cada campo de elemento de trabajo con el fin de afinar los criterios de búsqueda y devolver solo el conjunto de elementos de trabajo que desea. 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 Y y O de la primera cláusula del grupo se aplican a todo el grupo.

Tal y como se muestra en el ejemplo siguiente, las cláusulas agrupadas se convierten en la expresión lógica correspondiente. La primera expresión devuelve los 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 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
	Prioridad=1 O (Tipo de elemento de trabajo=Error Y Estado=Activo)
	Prioridad=1 (Tipo de elemento de trabajo=Error O Estado=Activo)

Para obtener más información, vea el tema sobre Especificar criterios de filtro para consultas.

Campos de consulta y valores

El valor que se especifique para un campo debe ser del mismo tipo de datos que ese campo. En la tabla siguiente se enumeran los tipos de datos 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 usado para realizar un seguimiento de la información histórica. Este tipo de datos solo se usa para admitir el campo Historial. Este campo se indiza automáticamente para la búsqueda de texto completo cuando esta está disponible. Vea la sección Búsquedas de texto completo y de palabras parciales, que se 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 automáticamente para la búsqueda de texto completo cuando esta está disponible. Vea la sección Búsquedas de texto completo y de palabras parciales, que se describe más adelante en este tema. Nota Cuando se actualiza Team Foundation Server, el tipo de campo del campo Descripción cambia de PlainText a HTML.Use el comando witadmin changefield para revertir el tipo de datos de este campo según sea necesario.Consulte Administrar campos de elementos 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 automáticamente para la búsqueda de texto completo cuando esta está disponible. Vea la sección Búsquedas de texto completo y de palabras parciales, que se 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 elegir 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 Agregar y modificar rutas de acceso de área e iteración.

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 se asigna a los campos de los elementos 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, 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]	Coincide con el valor contenido en el campo especificado.	Nombre de un campo con el mismo tipo de datos que el campo especificado
<>[Campo]	No coincide con 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 palabras	Contiene la cadena de texto o las palabras exactas dentro del campo que haya seleccionado para filtrar. También puede escribir palabras parciales o frases que contengan el carácter comodín, *. Para las restricciones, vea Búsquedas de texto completo para los requisitos del servidor y de intercalación.	Campos de texto largo que se indizan para búsquedas de texto completo, que corresponden a todos los campos PlainText y HTML y Título.
No contiene palabras	No contiene la cadena de texto o las palabras exactas dentro del campo que haya seleccionado para filtrar.	Campos de texto que están indizados para búsqueda de texto completo.
Entrada	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. Los grupos se corresponden con el nombre de una categoría o un grupo de TFS. Por ejemplo, puede crear una consulta para encontrar todos los elementos de trabajo que están asignados a miembros del grupo Colaboradores o a un equipo. Los grupos de equipo se crean al crear un equipo. El nombre de los grupos de equipo sigue el patrón [Nombre de proyecto de equipo]\ Nombre de equipo. No puede especificar un grupo de seguridad o un grupo de distribución de correos electrónicos como valor. Para ejemplos elaborados, vea Consultas de ejemplo.	String que coincide con el nombre de un grupo de usuarios o un grupo de categorías de Team Foundation Server. Nota Solo puede usar el operador En grupo con los campos que usan el tipo de datos String o el campo Tipo de elemento de trabajo. Para obtener información acerca de los grupos de categorías, vea Usar categorías para agrupar tipos de elementos de trabajo.
No en grupo	No coincide con ningún valor que sea 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 grupo con los campos que usan el tipo de datos String o el campo Tipo de elemento de trabajo. Para obtener información acerca de los grupos de categorías, vea Usar categorías para agrupar 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 texto completo y de palabras parciales

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

Si desea ver algunos ejemplos, consulte Ejemplo de consultas de elementos de trabajo y Consulta para elementos de trabajo mediante el campo Historial.

Nota

No todas las implementaciones admiten búsquedas de texto completo.Por ejemplo, SQL Express y SQL Azure, que admiten Visual Studio Online, no admiten búsquedas de texto completo.En estos casos, verá únicamente los operadores Contiene y No contiene.

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

Las búsquedas de texto completo requieren una intercalación de SQL que se corresponda con un idioma 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 usada para la instancia de Team Foundation Server no se corresponde con un idioma compatible, es posible que los resultados de la 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, vea Consultas de búsqueda de texto completo y la configuración de intercalación.

Consultar campos indizados

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

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

Use el comando witadmin indexfield para habilitar o deshabilitar la indexación de un campo. Consulte Administrar campos de elementos de trabajo [witadmin].

Vea también

Conceptos

Consultar elementos de trabajo