Variables, valores, operadores y campos de las consultas

Al crear una consulta para buscar elementos de trabajo en Visual Studio Team Foundation Server 2010, puede definir una o varias cláusulas que identifiquen el conjunto de elementos de trabajo que desea buscar. Para cada cláusula, puede especificar 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
And	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

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 abajo para mostrar la lista de campos disponibles y haga clic en 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 abajo para mostrar la lista de operadores disponibles y haga clic en un elemento en la lista.

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

3. En la misma fila, haga clic bajo el encabezado de la columna Valor.

4. Escriba un valor o haga clic en la flecha abajo y haga clic en un elemento en la lista.

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

6. Para agregar una cláusula, haga clic en Haga clic aquí para 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. También puede copiar y pegar el contenido de una cláusula a una nueva ubicación. Para obtener más información, vea Especificar criterios de filtro para consultas.

And/Or

Puede usar esta columna para especificar cómo se prueban las cláusulas. Puede especificar And si desea buscar los elementos de trabajo que cumplen los criterios en esta cláusula y la cláusula anterior. Puede especificar Or si desea buscar los elementos de trabajo que cumplen el criterio en esta cláusula o la cláusula anterior.

Campos de consulta y valores

Al especificar un valor para cada campo, el valor debe ajustarse al tipo de datos de ese campo. Todos los campos en Team Foundation tienen uno de los tipos de datos enumerados en la tabla siguiente:

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/2009.
Double	Un número real, como 0,2 o 3,5.
GUID	Una cadena de caracteres que representa un identificador único.
HTML	Cadenas de texto que admiten descripciones con formato.
Integer	Un entero de 32 bits con signo, como 0, 1, 2, 34.
PlainText	Cadenas de texto que admiten descripciones largas, como los campos Descripción o Historial definidos para un elemento de trabajo. Puede buscar elementos de trabajo basándose en una frase o palabra clave contenida dentro de un campo PlainText.
String	Cadena de texto que contiene 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 hacer clic en 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.

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 Usar campos del sistema y campos definidos por las plantillas de proceso de MSF.

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, Texto, Fecha, Árbol
<>	No coincide con el valor en la cláusula.	Número, Texto, Fecha, Árbol
>	Es mayor que el valor en la cláusula.	Número, Texto, Fecha
<	Es menor que el valor en la cláusula	Número, Texto, Fecha
>=	Es mayor o igual que el valor en la cláusula.	Número, Texto, Fecha
<=	Es menor o igual que el valor en la cláusula.	Número, Texto, Fecha
=[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 el valor de texto en la cláusula.	Texto
No contiene	No contiene el valor de texto en la cláusula.	Text
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, Texto, Fecha, Árbol
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.	Cadena 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 sobre los grupos de categorías, vea Agrupar los tipos de elemento de trabajo en categorías.
No en grupo	No coincide con ningún valor que sea miembro del grupo de la cláusula.	Cadena 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 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 sobre los grupos de categorías, vea Agrupar los tipos de elemento de trabajo en categorías.
Fue	Coincide con el valor en la cláusula en cualquier punto anterior.	Texto, Fecha
Pertenece a	Coincide con el valor en la cláusula o está contenido bajo el nodo en la cláusula.	Tree
No pertenece a	No coincide con el valor en la cláusula ni está contenido bajo el nodo en la cláusula.	Árbol

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

Vea también

Tareas

Especificar criterios de filtro para consultas

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

Buscar errores, tareas y otros elementos de trabajo

Otros recursos

Compartir elementos de trabajo y consultas con los miembros del equipo

Historial de cambios

Fecha	Historial	Motivo
Julio de 2010	Se han corregido algunos datos sobre el delimitador que se utiliza al especificar varios valores.	Comentarios de los clientes.
Septiembre de 2010	Se han corregido algunos datos sobre los valores que pueden especificarse en los operadores En grupo y No en grupo.	Comentarios de los clientes.