Campos Consulta, Operadores, Valores e Variáveis (Team Explorer Everywhere)

Artigo
07/27/2011

Quando você criar uma consulta para procurar itens de trabalho, você pode definir uma ou mais cláusulas que identificam o conjunto de itens de trabalho que você deseja localizar. Para cada cláusula, você pode especificar um campo, um operador e um valor ou variável. Por exemplo, você pode procurar todos os itens de trabalho de um projeto de equipe determinada especificando o campo Projeto de Equipe, o igual (=), o operador e o nome do projeto de equipe como o valor. Em vez de especificar um valor, você pode especificar uma variável como @Project, que representa o projeto de equipe atual.

A tabela seguinte mostra um exemplo de cláusula de consulta:

E/Ou	Campo	Operador	Valor
And	Nome do projeto	=	@Project

Para obter informações mais gerais sobre consultas, consulte Localizando Bugs, Tarefas e Outros Itens de Trabalho (Team Explorer Everywhere). Para obter informações sobre como navegar dentro do editor de consulta ou exibição de consulta usando os atalhos do teclado, consulte Atalhos de teclado para o Editor de Consulta e Exibição de Resultados da Consulta (TEE).

Neste tópico

Lista de verificação de como definir uma cláusula de consulta:

Na primeira linha vazia, clique sob o título de coluna Campo , clique na seta para baixo para exibir a lista de campos disponíveis e clique em um item na lista.

Para obter mais informações, consulte Query Fields and Values.
Na mesma linha, clique sob o título de coluna Operador , clique na seta para baixo para exibir a lista de operadores disponíveis e clique em um item na lista.

Para obter mais informações, consulte Query Operators.
Na mesma linha, clique sob o título de coluna Valor.
Digite um valor ou clique na seta para baixo e clique em um item na lista.

Para obter mais informações sobre como usar variáveis para especificar o projeto de equipe, o usuário ou data atual, consulte Query Variables.
Para adicionar a cláusua, clique em * na coluna mais à esquerda.

Observação

Você deve preencher os campos de cláusula adicionada antes que possa adicionar uma segunda cláusula.

Você pode acrescentar uma cláusula ao término da consulta ou entre cláusulas existentes e você pode remover, agrupar e desagrupar cláusulas quando necessário. Você também pode copiar e colar o conteúdo de uma cláusula em um outro local. Para obter mais informações, consulte Especifique os Critérios de Consulta.

Observação
Você deve preencher os campos de cláusula adicionada antes que possa adicionar uma segunda cláusula.

E/Ou

Você pode usar esta coluna para especificar como as cláusulas são testadas. Você pode especificar E se você deseja localizar itens de trabalho que atendam ao critério desta cláusula e da cláusula anterior. Você pode especificar Ou se você desejar localizar itens de trabalho que atendam ao critério desta cláusula ou da cláusula anterior.

Campos Consulta e Valores

Quando você especificar um valor para cada campo, o valor deve estar de acordo com o tipo de dados daquele campo. Todos os campos em Team Foundation têm um dos tipos de dados listados na tabela seguinte:

Tipo de dados	Dados armazenados
DateTime	Um horário de Tempo Universal Coordenado (UTC). Você pode especificar uma variável, como @Today ou @Today-1 ou um valor, como 1/1/2009.
Double	Um número real, como 0,2 ou 3,5.
GUID	Uma cadeia de caracteres que representa um ID exclusivo.
HTML	Sequências de texto que suportam descrições formatadas.
Integer	Um inteiro de 32 bits que é assinado, como 0, 1, 2 ou 34.
PlainText	Uma cadeia de texto que suportes descrições longas, como os campos Descrição ou Histórico. Você pode localizar itens de trabalho com base em uma frase ou palavra-chave que estão contidas dentro de um campo de Texto puro.
String	Uma cadeia de texto que contém até 255 caracteres Unicode.
TreePath	Uma estrutura de árvore de ramificação, como a Caminho de Área ou Caminho de iteração. Você deve clicar em um item em uma lista de valores válidos. Você pode localizar itens de trabalho que são iguais ou estão sob uma estrutura de árvore.

Operadores de Consulta

Você pode usar os operadores de consulta na seguinte tabela para especificar como cada valor em uma cláusula deve se relacionar ao valor correspondente em um item de trabalho.

Operador de consulta	Retorne todos os itens de trabalho se o valor no item de trabalho corresponder aos critérios listados	Tipos de campo aplicáveis
=	Corresponde com o valor na cláusula.	Número, texto, Data, Árvore
<>	Não corresponde com o valor na cláusula.	Número, texto, Data, Árvore
>	É maior que o valor na cláusula.	Número, texto, data
<	É menor que o valor na cláusula.	Número, texto, data
>=	É maior ou igual ao valor na cláusula.	Número, texto, data
<=	É menor ou igual ao valor na cláusula.	Número, texto, data
=[Field]	Corresponde com valor que é contido no campo especificado.	Qualquer campo que seja do mesmo tipo de dados como o campo especificado
<>[Field]	Não corresponde ao valor que é contido no campo especificado.	Qualquer campo que seja do mesmo tipo de dados como o campo especificado
>[Field]	É maior ou igual ao valor da cláusula contida no campo especificado.	Qualquer campo que seja do mesmo tipo de dados como o campo especificado
<[Field]	É menor ou igual ao valor da cláusula contida no campo especificado.	Qualquer campo que seja do mesmo tipo de dados como o campo especificado
>=[Field]	É maior ou igual ao valor da cláusula contida no campo especificado.	Qualquer campo que seja do mesmo tipo de dados como o campo especificado
<=[Field]	É menor ou igual ao valor da cláusula contida no campo especificado.	Qualquer campo que seja do mesmo tipo de dados como o campo especificado
Contém	Contém o valor de texto na cláusula.	Texto
Não contém	Não contém o valor de texto na cláusula.	Texto
Em	Corresponde a qualquer valor em um conjunto delimitado por vírgulas. Por exemplo, você pode localizar itens de trabalho cujos IDs são 100, 101 e 102 se você especificar estes valores no campo ID.	Número, texto, Data, Árvore
Em Grupo	Corresponde com um valor que é membro do grupo na cláusula. Por exemplo, você pode usar este campo para localizar todos os itens de trabalho que são atribuídos a qualquer membro de uma lista de distribuição.	Sequência ou o nome de um grupo de categoria Observação Você pode usar o operador Em Grupo apenas com aqueles campos que usam o tipo de dados de Sequência de caracteres ou o campo de Tipo de Item de Trabalho. Para obter informações sobre grupos de categorias, consulte a página seguinte: Agrupar Tipos de Itens de Trabalho em Categorias.
Não em Grupo	Não correspondem a quaisquer valores que são membros do grupo na cláusula.	Sequência ou o nome de um grupo de categoria Observação Você pode usar o operador Não está em Grupo apenas com aqueles campos que usam o tipo de dados de Sequência de caracteres ou o campo de Tipo de Item de Trabalho. Para obter informações sobre grupos de categorias, consulte a página seguinte: Agrupar Tipos de Itens de Trabalho em Categorias.
Já Foi	Corresponde ao valor na cláusula em qualquer ponto anterior.	Texto, Data
Sob	Corresponde ao valor na cláusula ou não está contido sob o nó na cláusula.	Tree
Não Sob	Não corresponde ao valor na cláusula e não está contido sob o nó na cláusula.	Tree

Variáveis de consulta

Você pode usar as variáveis na seguinte tabela para localizar itens de trabalho que se relacionam com o usuário, projeto ou data atuais.

Variável de consulta	Uso
@Me	Use esta variável para procurar automaticamente pelo alias atual do usuário em um campo que contenha as aliases de usuário. Por exemplo, você pode localizar os itens de trabalho abertos se você definir a coluna Campo como Aberta Por, a coluna Operador para =e a coluna Valor para @Me.
@Project	Use esta variável para procurar pelos itens de trabalho no projeto de equipe atual. Por exemplo, você pode localizar todos os itens de trabalho do projeto de equipe atual se você definir a coluna Campo como Projeto de Equipe, a coluna Operador para =e a coluna Valor para @Project.
@Today	Use esta variável para procurar itens de trabalho que relacionam com a data atual ou com a anterior. Você também pode modificar a variável @Today pela subtração de dias. Por exemplo, você pode localizar todos os itens que foram ativados na última semana se você definir a coluna Campo como Activated Date, a coluna Operador para > =, e a coluna Valor para @ Hoje - 7.
[Any]	Use esta variável para procurar por itens de trabalho que relacionam a qualquer valor definido para um campo específico.