Campos Consulta, Operadores, Valores e Variáveis

Você localiza e cria listas de itens de trabalho criando consultas de item de trabalho.Definindo uma ou mais cláusulas, você filtra de todos os itens de trabalho em uma coleção de projeto de equipe ou projeto de equipe retornar o conjunto de itens de trabalho de seu interesse.Para cada cláusula, especifique um campo, um operador e um valor, ou uma variável.Por exemplo, você pode procurar por todos os itens de trabalho no projeto de equipe determinada especificando o campo de Projeto de Equipe , o operador de igual (=), 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.

Cláusula de consulta de exemplo

E/Ou	Campo	Operator	Valor
And	Projeto de equipe	=	@Project

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

Neste tópico

• E/Ou

• Campos Consulta e Valores

• Operadores de Consulta

• Variáveis de consulta

• Pesquisa de texto completo da palavra e parciais

• Campos consulta indexados

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

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

   Para obter mais informações, consulte Campos consulta e valores.

2. Na mesma linha, sob o título de coluna de Operador , escolha a seta para baixo para exibir a lista de operadores disponíveis, e escolha um item na lista.

   Para obter mais informações, consulte Operadores.

3. Na mesma linha, sob o título de coluna de Valor , ou digite um valor, ou escolhe a seta para baixo, e escolhe um item na lista.

4. Para obter mais informações sobre como usar variáveis para especificar o projeto de equipe atual, o usuário, ou data, consulte Variáveis.

5. Para adicionar uma cláusula, escolha Clique aqui para adicionar uma nova cláusula ou Adicionar uma nova cláusula.

   Você pode adicionar uma cláusula ao final da consulta, para inserir uma cláusula após uma cláusula existente (), e remove (), agrupa (), e desagrupar cláusulas () quando necessário.

E/Ou

Você especifica EOu ou para criar expressões lógicas das cláusulas de consulta.Especificar E para localizar itens de trabalho que atendam ao critério na cláusula atual e da cláusula anterior.Especifique Ou para localizar itens de trabalho que atendam ao critério na cláusula atual ou na cláusula anterior.

Você pode adicionar uma nova cláusula para cada campo de item de trabalho para refinar seus critérios de pesquisa, de modo que retorna somente o conjunto de itens de trabalho que você deseja.Se você não receber os resultados que você espera de sua consulta, você pode adicionar, remover, para agrupar ou desagrupar cláusulas de consulta para refinar seus resultados de consulta.

As cláusulas de consulta podem ser agrupadas para operar como uma única unidade separada do restante de consulta, semelhante a coloque parenteses em torno de uma expressão em uma instrução da equação ou de matemática lógica.Quando você agrupa cláusulas, E ou OU para a primeira cláusula no grupo se aplicam ao grupo inteiro.

Como mostra o exemplo a seguir, as cláusulas são agrupadas traduzidas a expressão lógica correspondente.Os primeiros da expressão retorna os itens de trabalho que são a prioridade 1, assim como quaisquer erros ativos da prioridade.A segunda expressão retorna todos os itens ativos de trabalho prioridade 1, mais todos os erros de prioridade 1 se são ativos ou não.

Cláusulas agrupadas	Expressão lógica
	Priority=1 OU () State=Active Type=Bug item de trabalho)
	Priority=1) (Type=Bug OU State=Active item de trabalho)

Para obter mais informações, consulte Especificar critérios de filtro de consulta.

Campos Consulta e Valores

O valor que você especifica para um campo deve estar de acordo com o tipo de dados para o campo.A tabela a seguir lista os tipos de dados suportados:

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/2012.
Double	Um número real, como 0,2 ou 3,5.
GUID	Uma cadeia de caracteres que representa um ID exclusivo.
History	Campo formatado personalizado usado para controlar informações históricas.Este tipo de dados é usado somente para oferecer suporte ao campo de Histórico .Este campo será indexado automaticamente para a pesquisa de texto completo quando a pesquisa de texto completo está disponível.Consulte Pesquisa de texto completo da palavra e parciais descrito posteriormente neste tópico.
HTML	Cadeias de caracteres de texto que suportam descrições formatados, como os campos de Descrição ou de Etapas de Reprodução .Esses campos são indexados automaticamente para a pesquisa de texto completo quando a pesquisa de texto completo está disponível.Consulte Pesquisa de texto completo da palavra e parciais descrito posteriormente neste tópico. Observação Quando você atualiza Team Foundation Server, o campo de Descrição é alterado de um tipo de campo de PlainText a HTML.Usando o comando de witadmin changefield você pode reverter o tipo de dados para este campo quando necessário.Consulte Gerenciar campos de item de trabalho [witadmin].
Integer	Um inteiro de 32 bits que é assinado, como 0, 1, 2, 34.
PlainText	Cadeias de caracteres de texto que suportam descrições longas, como o campo de Informações de início do aplicativo .Esses campos são indexados automaticamente para a pesquisa de texto completo, quando a pesquisa de texto completo está disponível.Consulte Pesquisa de texto completo da palavra e parciais descrito posteriormente neste tópico.
String	Cadeia de caracteres de texto curto que pode conter até 255 caracteres Unicode.
TreePath	Uma estrutura de árvore de ramificação, como a Caminho de Área ou Caminho de iteração.Você deve escolher 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.Para obter mais informações, consulte Criar e modificar áreas e iterações.

De volta ao topo

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.Para obter informações sobre o tipo de dados que é atribuído a campos de item de trabalho, consulte Referência de campos de item de trabalho para o Visual Studio ALM.

Operador de consulta	Retorne todos os itens de trabalho se o valor no item de trabalho corresponder aos critérios listados	Tipos de dados aplicáveis
=	Corresponde com o valor na cláusula.	Número, que inclui Double, GUID, Integer, e String, DateTime, e TreePath
<>	Não corresponde com o valor na cláusula.	Número, String, DateTime, e TreePath
>	É maior que o valor na cláusula.	Número, String, e DateTime
<	É menor que o valor na cláusula.	Número, String, e DateTime
>=	É maior que ou igual ao valor na cláusula.	Número, String, e DateTime
<=	É menor ou igual ao valor na cláusula.	Número, String, e DateTime
=[Field]	Corresponde com valor que é contido no campo especificado.	Nome de um campo que é do mesmo tipo de dados do campo especificado
<>[Field]	Não corresponde ao valor que é contido no campo especificado.	Nome de um campo que é do mesmo tipo de dados do campo especificado
>[Field]	É maior que o valor da cláusula contida no campo especificado.	Nome de um campo que é do mesmo tipo de dados do campo especificado
<[Field]	É menor ou igual ao valor da cláusula contida no campo especificado.	Nome de um campo que é do mesmo tipo de dados do campo especificado
>=[Field]	É maior que ou igual ao valor da cláusula contida no campo especificado.	Nome de um campo que é do mesmo tipo de dados do campo especificado
<=[Field]	É menor ou igual ao valor da cláusula contida no campo especificado.	Nome de um campo que é do mesmo tipo de dados do campo especificado
Contém	Contém uma correspondência exata ou parcial da cadeia de caracteres de texto no campo que você selecionou filtragem.	String
Não contém	Não contém uma correspondência exata ou parcial da cadeia de caracteres de texto no campo que você selecionou filtragem.	String
Contém palavra	Contém a cadeia de caracteres de texto ou a palavra exatas no campo que você selecionou filtragem.Você também pode inserir as palavras parciais ou frases que contêm o caractere curinga, *.Para limitações, consulte Pesquisas de texto completo para o servidor e requisitos de agrupamento.	Campos de texto Longo- que são indexados para a pesquisa de texto completo, que correspondem a todos os campos de PlainText e de HTML e a Título.
Não contém palavra	Não contém a cadeia de caracteres de texto ou palavras exatas dentro do campo que você selecionou filtragem.	Campos de texto que são indexados para a pesquisa de texto completo.
Em	Corresponde qualquer valor em um conjunto limitado.Por exemplo, você pode localizar itens de trabalho cujos IDs são 100, 101 e 102 se você especificar estes valores no campo ID. Importante Valores separados pelo separador de lista que corresponde às configurações regionais que são definidas para seu computador cliente.Por exemplo, você pode usar uma vírgula (,).	Número, String, DateTime, TreePath
Em Grupo	Corresponde com um valor que é membro do grupo na cláusula.Você pode especificar uma opção, um personalizado, ou um grupo de categorias em Team Foundation Server.Por exemplo, você pode criar uma consulta para localizar todos os itens de trabalho que são atribuídos aos membros do grupo de colaboradores. Observação Você não pode especificar uma segurança ou enviar por correio eletrônico o grupo de distribuição como um valor.	String que corresponde ao nome de um grupo de usuários ou um grupo de categorias em Team Foundation Server. Observação Você pode usar o operador de Em Grupo apenas com campos que usam o tipo de dados de String ou o campo de Tipo de Item de Trabalho . Para obter informações sobre grupos de categorias, consulte Definir categorias para agrupar os tipos de item de trabalho.
Não em Grupo	Não coincide com um valor que seja um membro do grupo na cláusula.	String que corresponde ao nome de um grupo de usuários em Team Foundation Server ou um grupo de categorias definido para um projeto de equipe. Observação Você pode usar o operador de Não Está Em Grupo apenas com campos que usam o tipo de dados de String ou o campo de Tipo de Item de Trabalho . Para obter informações sobre grupos de categorias, consulte Definir categorias para agrupar os tipos de item de trabalho.
Já Foi	Corresponde ao valor na cláusula em qualquer ponto anterior.	String, DateTime
Sob	Corresponde ao valor na cláusula ou não está contido sob o nó na cláusula.	TreePath
Não Sob	Não corresponde ao valor na cláusula e não está contido sob o nó na cláusula.	TreePath

De volta ao topo

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 itens de trabalho abertos se você definir a coluna de Campo pela Ativado por, a coluna da Operador=, e a coluna de Valor a @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 no projeto de equipe atual se você definir a coluna de Campo a Projeto de Equipe, a coluna da Operador=, e a coluna de Valor a @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 de @Today subtraindo dias.Por exemplo, você pode localizar todos os itens ativados na última semana se você definir a coluna de Campo a Data ativada, a coluna de Operador a >=, e a coluna de Valor a @Today - 7.
[Any]	Use esta variável para procurar por itens de trabalho que relacionam a qualquer valor definido para um campo específico.

De volta ao topo

Pesquisas da palavra de texto completo e parciais

Especificar Contém ou Não Contém para procurar em correspondências exatas ou parciais de uma palavra ou uma sentença.Especificar Contém Palavras ou Não Contém Palavras para procurar com uma frase ou exata para usar o caractere curinga, *.Esses operadores usam o índice de pesquisa de texto completo.Você pode usar o caractere curinga no final de uma palavra parciais ou uma sentença.

Por exemplo, consulte Localizar itens de trabalho com base em palavras-chave ou expressões e Exibir Histórico e Localizar Itens de Trabalho Usando o Campo Histórico.

Observação
Nem todas as implantações suportam pesquisas de texto completo.Por exemplo, o SQL express e SQL properties, que suportam o serviço do team foundation, não oferecem suporte a pesquisa de texto completo.Nestas instâncias, você verá apenas os operadores de Contém e de Não Contém .

Contém Palavras e itens de filtro de Não Contém Palavras com base no índice de pesquisa de texto completo criado para longo- campos de texto.Team Foundation indexa automaticamente todos os campos de longo- texto com um tipo de dados de PlainText e de HTML e o campo de Título para a pesquisa de texto completo.O índice e operadores estão disponíveis somente quando o SQL Server que oferece suporte a pesquisa de texto completo de suporte de Team Foundation Server .

As pesquisas de texto completo requerem um agrupamento SQL que corresponde a um linguagem que tem um separador de palavras registrado com o SQL Server.Se as configurações de agrupamento para o banco de dados de coleção de projeto de equipe usado para sua instância de Team Foundation Server não correspondem a um idioma suportado, resultados de pesquisa podem não corresponder suas expectativas.Nesses casos, você pode tentar usar os operadores de Contém ou de Não Contém .

Para obter mais informações, consulte Consultas e configurações de agrupamento de pesquisa de texto completo.

Campos consulta indexados

Em adição ao índice de pesquisa de texto completo, um índice de consulta é criado.É baseado naqueles campos que têm a indexação ativada.O índice de consulta melhora o tempo de resposta em que você executa consultas que incluem campos indexados.

Por padrão, os seguintes campos são indexados: Atribuído a, Data de criação, Alterado por, Estado, Motivo, Identificação de Área, ID de Iteração e Tipo de Item de Trabalho.Se houver outros campos que sua equipe usa frequentemente nas consultas, você pode adicioná-los ao índice da consulta.

Você usar o comando de witadmin indexfield ativar ou desativar a indexação para um campo.Consulte Gerenciar campos de item de trabalho [witadmin].

Consulte também

Tarefas

Especificar critérios de filtro de consulta

Trabalhando com uma consulta em lista plana (padrão)

Trabalhando com hierarquias vinculadas (Árvore de Itens de Trabalho)

Conceitos

Localizar bugs, tarefas e outros itens de trabalho

Outros recursos

Trabalhando com dependências vinculadas (links diretos)

Alterar Histórico

Date	History	Razão
Em agosto de 2012	Tabela fixa que descreve os tipos de dados do campo e Description removido do conjunto de campos que são indexados para a pesquisa de texto completo.Adicionar duas seções no andn das pesquisas de texto completo a consulta indexa.	Aprimoramento de informações.