Variáveis, campos, operadores e valores de consulta

Artigo
08/01/2011

Quando você cria uma consulta para procurar por itens de trabalho em Visual Studio Team Foundation Server 2010, é possível definir uma ou mais cláusulas que identifiquem 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 em um projeto de equipe específico, especificando o campo projeto de equipe, o operador de igual (=) e o nome do projeto da equipe como valor. Em vez de especificar um valor, você pode especificar uma variável como, por exemplo, @ projeto, que representa o atual projeto de equipe.

Cláusula de consulta de amostra

E/ou	Campo	Operador	Valor
And	Projeto de equipe	=	@ O projeto

Para obter informações gerais sobre consultas, consulte Localização de Bugs, tarefas e outros itens de trabalho. Para obter informações sobre como navegar dentro do editor de consulta ou modo de exibição de consulta usando atalhos de teclado, consulte Atalhos de teclado para o Editor de consulta e exibição de resultados de consulta.

Neste tópico

E/ou
Valores e campos de consulta
Operadores de consulta
Variáveis de consulta

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

Na primeira linha vazia, clique sob o título de coluna do 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 campos de consulta e valores.
Na mesma linha, clique no cabeçalho da coluna de 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 operadores.
Na mesma linha, clique no cabeçalho de coluna de 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 atual projeto de equipe, o usuário ou a data, consulte variáveis de.
Para adicionar uma cláusula, clique em Clique aqui para adicionar uma nova cláusula.

Você pode adicionar uma cláusula ao final da consulta, inserir uma cláusula após uma cláusula existente () e remover (), grupo () e desagrupar () cláusulas conforme necessário. Você também pode copiar e colar o conteúdo de uma cláusula para um novo local. Para obter mais informações, consulte Especificar critérios de filtro de consulta.

E/ou

Você pode usar essa coluna para especificar como as cláusulas são testadas. Você pode especificar e se você desejar localizar os itens de trabalho que satisfazem os critérios de tanto essa cláusula como a cláusula anterior. Você pode especificar ou se você desejar localizar os itens de trabalho que atendem o critério na cláusula anterior ou desta cláusula.

Valores e campos de consulta

Quando você especifica um valor para cada campo, o valor deve estar de acordo com o tipo de dados desse campo. Todos os campos Team Foundation ter um dos tipos de dados listados na tabela a seguir:

Tipo de dados	Dados armazenados
DateTime	Um momento de tempo Universal Coordenado (UTC) no tempo. Você pode especificar uma variável, como @Today ou @Today-1, ou um valor, como, por exemplo, 1/1/2009.
Double	Um número real, como 0,2 ou 3.5.
GUID	Uma seqüência de caracteres que representa uma ID exclusiva.
HTML	Seqüências de texto formatadas de descrições de suporte.
Integer	Um inteiro de 32 bits assinado, como, por exemplo, 0, 1, 2, 34.
Texto sem formatação	As seqüências de texto longas descrições, como, por exemplo, os campos Descrição ou histórico de suporte são definidas para um item de trabalho. Você pode encontrar itens de trabalho baseados em uma frase ou palavra-chave que está contido dentro de um campo de texto sem formatação.
String	Seqüência de texto que contém até 255 caracteres Unicode.
TreePath	Uma ramificação estrutura de árvore, como, por exemplo, um caminho de caminho de área ou de iteração. Você deve clicar em um item em uma lista de valores válidos. Você pode encontrar itens de trabalho que é igual ou estão sob uma estrutura de árvore.

Voltar ao topo

Operadores de consulta

Você pode usar os operadores de consulta na tabela a seguir para especificar como cada valor em uma cláusula deve se relacionam com o valor correspondente em um item de trabalho. Para obter informações sobre o tipo de dados que é atribuído a campos de item de trabalho, consulte Usando os campos de sistema e definidas pelos modelos de processo do MSF.

Operador de consulta	Retorna os itens de trabalho se o valor do item de trabalho coincide com os critérios listados	Tipos de dados aplicáveis
=	Corresponde ao valor na cláusula.	Número, texto, data, árvore
<>	Não corresponde ao valor da 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 que ou igual ao valor da cláusula.	Número, texto, data
<=	É menor ou igual ao valor da cláusula.	Número, texto, data
= [Field]	Corresponde ao valor que está contido no campo especificado	Nome de um campo que é do mesmo tipo de dados do campo especificado
< > [campo]	Não coincide com o valor contido no campo especificado	Nome de um campo que é do mesmo tipo de dados do campo especificado
> [campo]	É maior do que o valor contido no campo especificado	Nome de um campo que é do mesmo tipo de dados do campo especificado
< [campo]	É menor que o valor contido no campo especificado	Nome de um campo que é do mesmo tipo de dados do campo especificado
> = [Field]	É maior ou igual ao valor que está contido no campo especificado	Nome de um campo que é do mesmo tipo de dados do campo especificado
< = [Field]	É menor ou igual ao valor que está contido no campo especificado	Nome de um campo que é do mesmo tipo de dados do 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 de um conjunto delimitado. Por exemplo, você pode encontrar com IDs são 100, 101 e 102, se você especificar esses valores para o campo de identificação de itens de trabalho. Importante Separe os valores com o separador de lista que corresponde às configurações regionais que são definidas para o computador cliente.Por exemplo, você pode usar uma vírgula (,).	Número, texto, data, árvore
No grupo	Corresponde a um valor que seja membro do grupo na cláusula. Você pode especificar um grupo padrão, personalizado ou categoria na Team Foundation Server. Por exemplo, você pode criar uma consulta para localizar todos os itens de trabalho que são atribuídos a membros do grupo de colaboradores. Observação É possível especificar uma segurança ou o grupo de distribuição de email como um valor.	Seqüência de caracteres que corresponde ao nome de um grupo de usuário ou grupo de categoria em Team Foundation Server. Observação Você pode usar o In Group operador somente com campos que usam o tipo de dados de seqüência de caracteres ou o campo tipo de Item de trabalho. Para obter informações sobre grupos de categorias, consulte O agrupamento de tipos de Item de trabalho em categorias.
Não está no grupo	Não corresponde a um valor que seja membro do grupo na cláusula.	Seqüência de caracteres que corresponde ao nome de um grupo de usuário ou um grupo de categorias noTeam Foundation Server Observação Você pode usar o Não grupo operador somente com campos que usam o tipo de dados de seqüência de caracteres ou o campo tipo de Item de trabalho. Para obter informações sobre grupos de categorias, consulte O agrupamento de tipos de Item de trabalho em categorias.
Foi nunca	Corresponde ao valor na cláusula a qualquer momento anterior.	Texto, data
Em	Corresponde ao valor na cláusula ou está contido no nó na cláusula.	Tree
Não está em	Não corresponde ao valor da cláusula e não está sob o nó na cláusula.	Tree

Voltar ao topo

Variáveis de consulta

Você pode usar as variáveis na tabela a seguir para localizar os itens de trabalho relacionadas ao usuário atual, o projeto atual ou a data atual.

Variável de consulta	Uso
@Me	Use essa variável para pesquisar automaticamente o alias do usuário atual em um campo que contém o alias do usuário. Por exemplo, você pode encontrar itens de trabalho que você abriu, se você definir a campo coluna para Ativado por, o operador coluna para =e o valor coluna para @Me.
@Project	Use essa variável para procurar por itens de trabalho no projeto de equipe atual. Por exemplo, você pode localizar todos os itens de trabalho no projeto de equipe atual se você definir a campo coluna para O projeto de equipe, o operador coluna para =e o valor coluna para @Project.
@Today	Use essa variável para procurar por itens de trabalho que se relacionam a data atual ou para uma data anterior. Você também pode modificar o @Today a variável subtracting dias. Por exemplo, você pode encontrar todos os itens ativados na semana passada, se você definir a campo coluna para Ativado Data, o operador coluna para > =e o valor coluna para @Today - 7.
[Any]	Use essa variável para procurar por itens de trabalho que se relacionam com qualquer valor que é definido para um determinado campo.

Voltar ao topo

Consulte também

Histórico de alterações

Date	History	Motivo
Julho de 2010	Corrigido informações sobre o delimitor que você usa quando você especificar vários valores.	Comentários do cliente.
Setembro de 2010	Corrigida a informações sobre os valores que você pode especificar para o In Group e Não grupo operadores.	Comentários do cliente.

Julho de 2010

Corrigido informações sobre o delimitor que você usa quando você especificar vários valores.

Comentários do cliente.

Setembro de 2010

Corrigida a informações sobre os valores que você pode especificar para o In Group e Não grupo operadores.

Comentários do cliente.

Compartilhar via

Variáveis, campos, operadores e valores de consulta

E/ou

Valores e campos de consulta

Operadores de consulta

Variáveis de consulta

Consulte também

Tarefas

Conceitos

Outros recursos

Histórico de alterações

Recursos adicionais