Campos de consulta, operadores, valores e variáveis

Você encontra e cria listas de itens de trabalho criando consultas de itens de trabalho. Ao definir uma ou mais cláusulas, você realiza a filtragem entre todos os itens de trabalho dentro de um projeto da equipe ou coleção do projeto da equipe para retornar o conjunto de itens de trabalho em que está interessado. Para cada cláusula, você especifica um campo, um operador e um valor ou variável. Por exemplo, você pode pesquisar todos os itens de trabalho em um determinado projeto de equipe especificando o campo Projeto da Equipe o operador de igual (=) e o nome do projeto de equipe como o valor. Ao invés de especificar um valor, você pode especificar uma variável como @Project, que representa o projeto da equipe atual.

Cláusula de consulta de amostra

E/ou	Field	Operador	Valor
And	Projeto de Equipe	=	@Project

Para obter mais informações sobre consultas, consulte Consultar itens de trabalho. Para obter informações sobre como navegar no editor de consulta ou modo de exibição de consulta usando atalhos de teclado, consulte Atalhos do teclado para trabalhar no Team Web Access e no Team Explorer.

Neste tópico

• And/Or

• Campos e Valores de Consulta

• Operadores de Consulta

• Variáveis de Consulta

• Pesquisas de texto completo e palavras parciais

• Campos indexados de consulta

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

1. Na primeira linha vazia, no cabeçalho da coluna 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 de consulta e valores.

2. Na mesma linha, no cabeçalho da coluna 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, no cabeçalho da coluna Valor, digite um valor ou escolha a seta para baixo e escolha um item na lista.

4. Para obter mais informações sobre como usar variáveis para especificar o projeto da equipe atual, o usuário ou a 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, inserir uma cláusula após uma cláusula existente () e remover (), group () e desagrupar () cláusulas quando necessário.

And/Or

Especifique And ou Or para criar expressões lógicas de suas cláusulas de consulta. Especifique And para localizar itens de trabalho que atendem aos critérios na cláusula atual e na cláusula anterior. Especifique Or para localizar itens de trabalho que atendem aos critérios na cláusula atual ou na cláusula anterior.

Você pode adicionar uma nova cláusula a cada campo do item de trabalho para refinar seus critérios de pesquisa, para que somente o conjunto de itens de trabalho desejado seja retornado. Se você não receber os resultados esperados da consulta, poderá consultar, adicionar, remover, agrupar ou desagrupar cláusulas da consulta para refinar os resultados da consulta.

As cláusulas de consulta podem ser agrupadas para operar como uma única unidade separada do resto da consulta, semelhante a colocar uma equação matemática ou expressão lógica entre parênteses. Ao agrupar cláusulas, o operador AND ou OR para a primeira cláusula no grupo se aplica ao grupo inteiro.

Como mostrado no exemplo a seguir, as cláusulas agrupadas são traduzidas para a expressão lógica correspondente. A primeira expressão retorna itens de trabalho que são de prioridade 1, bem como todos os bugs ativos de qualquer prioridade. A segunda expressão retorna todos os itens de trabalho ativos de prioridade 1 e todos os bugs de prioridade 1, ativos ou não.

Cláusulas agrupadas	Expressão lógica
	Prioridade=1 OR (Tipo de Item de Trabalho=Bug AND Estado=Ativo)
	Prioridade=1 AND (Tipo de Item de Trabalho=Bug OR Estado=Ativo)

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

Campos e Valores de Consulta

O valor especificado para um campo deve estar em conformidade com o tipo de dados para esse campo. A tabela a seguir lista tipos de dados compatíveis:

Tipo de dados	Dados armazenados
DateTime	Um horário em UTC (Tempo Universal Coordenado). 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 uma ID exclusiva.
History	Campo com formatação personalizada usado para acompanhar informações históricas. Esse tipo de dados é usado somente para oferecer suporte ao campo Histórico. Esse campo é indexado automaticamente para a pesquisa de texto completo quando esse tipo de pesquisa está disponível. Consulte Pesquisas de texto completo e palavras parciais, descritas posteriormente neste tópico.
HTML	Cadeias de texto que oferecem suporte a descrições formatadas, como os campos Descrição ou Etapas de Reprodução. Esses campos são indexados automaticamente para a pesquisa de texto completo quando esse tipo de pesquisa está disponível. Consulte Pesquisas de texto completo e palavras parciais, descritas posteriormente neste tópico. Dica Ao atualizar o Team Foundation Server, o campo Descrição é alterado de um tipo de campo de PlainText para HTML.Usando o comando witadmin changefield, você pode reverter o tipo de dados para esse campo quando necessário.Consulte Gerenciar campos de item de trabalho [witadmin].
Integer	Um inteiro de 32 bits assinado, como 0, 1, 2, 34.
PlainText	Cadeias de texto que oferecem suporte a descrições longas, como o campo Informações de Inicialização do Aplicativo. Esses campos são indexados automaticamente para a pesquisa de texto completo quando esse tipo de pesquisa está disponível. Consulte Pesquisas de texto completo e palavras parciais, descritas 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 um caminho de Área ou Iteração. Você deve escolher um item na lista de valores válidos. Você pode encontrar itens de trabalho que são iguais ou que estão sob uma estrutura de árvore. Para obter mais informações, consulte Adicionar e modificar área e caminhos de iteração.

Voltar ao início

Operadores de Consulta

Você pode usar os operadores de consulta da 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 campo de item de trabalho do Visual Studio ALM.

Operador de consulta	Retorna itens de trabalho se o valor no item de trabalho corresponder aos critérios listados	Tipos de dados aplicáveis
=	Corresponde ao valor na cláusula.	Número, que inclui Double, GUID, Integer, e String, DateTime, e TreePath
<>	Não corresponde ao valor na cláusula.	Número, String, DateTime, e TreePath
& gt;	É maior que o valor na cláusula.	Número, String, e DateTime
& lt;	É menor que o valor na cláusula.	Número, String, e DateTime
>=	É maior 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 ao valor contido no campo especificado.	Número de um campo com o mesmo tipo de dados que o campo especificado
<>[Field]	Não corresponde ao valor contido no campo especificado.	Número de um campo com o mesmo tipo de dados que o campo especificado
>[Field]	É maior que o valor contido no campo especificado.	Número de um campo com o mesmo tipo de dados que o campo especificado
<[Field]	É menor que o valor contido no campo especificado.	Número de um campo com o mesmo tipo de dados que o campo especificado
>=[Field]	É maior ou igual ao valor contido no campo especificado.	Número de um campo com o mesmo tipo de dados que o campo especificado
<=[Field]	É menor ou igual ao valor contido no campo especificado.	Número de um campo com o mesmo tipo de dados que o campo especificado
Contains	Contém uma correspondência exata ou parcial da cadeia de texto dentro do campo selecionado para filtragem.	String
Não Contém	Não contém uma correspondência exata ou parcial da cadeia de texto dentro do campo selecionado para filtragem.	String
Contém Palavras	Contém a cadeia de texto ou as palavras exatas dentro do campo selecionado para filtragem. Você também pode inserir palavras ou frases parciais que contenham o caractere curinga, *. Para conhecer as restrições, consulte Pesquisas de texto completo para obter os requisitos de servidor e agrupamento.	Campos de texto longo que são indexados para pesquisa de texto completo, que corresponde a todos os campos PlainText e HTML e ao Título.
Não Contém Palavras	Não contém a cadeia de texto ou as palavras exatas dentro do campo selecionado para filtragem.	Campos de texto são indexados para a pesquisa de texto completo.
Em	Corresponde a qualquer valor no conjunto delimitado. Por exemplo, você pode encontrar itens de trabalho cujos IDs sejam 100, 101 e 102 se especificar esses valores para o campo ID. Importante Separe os valores com o separador de lista correspondente às configurações regionais definidas para seu computador cliente.Por exemplo, você pode usar uma vírgula (,).	Número, String, DateTime, TreePath
Está Em Grupo	Corresponde a um valor que é um membro do grupo na cláusula. Grupos correspondem ao nome de uma categoria ou um grupo do TFS. Por exemplo, você pode criar uma consulta para localizar todos os itens de trabalho que estão atribuídos aos membros do grupo Colaboradores ou a uma equipe. Grupos de equipe são criados ao criar uma equipe. O nome dos grupos da equipe segue o padrão [Nome do Projeto da Equipe]\ Nome da Equipe. Não é possível especificar um grupo de segurança ou de distribuição de e-mails como um valor. Para obter os exemplos trabalhados, consulte Consultas de exemplo.	String que corresponde ao nome de um grupo de usuários ou de um grupo de categorias em Team Foundation Server. Dica Você pode usar o operador Está Em Grupo somente com campos que usam o tipo de dados String ou o campo Tipo do Item de Trabalho. Para obter informações sobre grupos de categorias, consulte Usar categorias para agrupar tipos de itens de trabalho.
Não Está Em Grupo	Não corresponde a um valor que é um membro do grupo na cláusula.	String que corresponde ao nome de um grupo de usuários em Team Foundation Server ou de um grupo de categorias definido para um projeto de equipe. Dica Você pode usar o operador Não Está Em Grupo somente com campos que usam o tipo de dados String ou o campo Tipo do Item de Trabalho. Para obter informações sobre grupos de categorias, consulte Usar categorias para agrupar tipos de itens de trabalho.
Nunca	Corresponde ao valor na cláusula em qualquer ponto anterior.	String, DateTime
Em	Corresponde ao valor na cláusula ou é contido pelo nó na cláusula.	TreePath
Fora	Corresponde ao valor na cláusula e não está sob o nó na cláusula.	TreePath

Voltar ao início

Variáveis de Consulta

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

Variável da consulta	Uso
@Me	Use essa variável para pesquisar automaticamente o alias do usuário atual em um campo que contém alias de usuários. Por exemplo, você pode localizar itens de trabalho abertos se definir a coluna Campo como Ativado Por, a coluna Operador como = e a coluna Valor como @Me.
@Project	Use essa variável para pesquisar itens de trabalho no projeto da equipe atual. Por exemplo, você pode localizar todos os itens de trabalho no projeto da equipe atual se definir a coluna Campo como Projeto da Equipe, a coluna Operador como = e a coluna Valor como @Project.
@Today	Use essa variável para pesquisar itens de trabalho relacionados à data atual ou a uma data anterior. Também é possível modificar a variável @Today adicionando ou subtraindo dias. Por exemplo, você pode localizar todos os itens de trabalho na semana passada se definir a coluna Campo como Data da Ativação, a coluna Operador como = e a coluna Valor como @Today - 7.
[Any]	Use essa variável para pesquisar itens de trabalho relacionados a qualquer valor que é definido para um determinado campo.

Voltar ao início

Pesquisas de texto completo e palavras parciais

Especifique Contém ou Não Contém para realizar uma pesquisa relativa a correspondências exatas ou parciais de uma palavra ou frase. Escolha Contém Palavras ou Não Contém Palavras para realizar uma pesquisa relativa a uma frase exata ou para usar o caractere curinga *. Esses operadores usam o índice de pesquisa de texto completo. Você pode usar somente o caractere curinga no final de uma palavra ou frase parcial.

Para obter exemplos, consulte Exemplo de consultas de item de trabalho e Consultar itens de trabalho usando o campo Histórico.

Dica

Nem todas as implantações são compatíveis com pesquisas de texto completo.Por exemplo, o SQL Express e o SQL Azure, que oferecem suporte ao Visual Studio Online, não são compatíveis com a pesquisa de texto completo.Nessas instâncias, você verá apenas os operadores Contém e Não Contém.

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

Pesquisas de texto completo requerem um agrupamento de SQL que corresponde a uma linguagem com um separador de palavras registrado no SQL Server. Se as configurações de agrupamento para o banco de dados de agrupamento do projeto da equipe usado para sua instância do Team Foundation Server não for correspondente a uma linguagem com suporte, seus resultados de pesquisa podem não corresponder às suas expectativas. Nesses casos, você pode tentar usar os operadores Contém ou Não Contém.

Para obter mais informações, consulte Definições de Consultas de Pesquisar de Texto Completo e Agrupamento.

Campos indexados de consulta

Além do índice de pesquisa de texto completo, um índice de consulta é criado. Ele se baseia nos campos que possuem a indexação habilitada. O índice da consulta melhora o tempo de resposta ao executar consultas de 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, Identificação de iteração, e Tipo de item de trabalho. Se houver outros campos que sua equipe utiliza com frequência em suas consultas, você pode adicioná-los ao índice da consulta.

Use o comando witadmin indexfield para habilitar ou desabilitar a indexação para um campo. Consulte Gerenciar campos de item de trabalho [witadmin].

Consulte também

Conceitos

Consultar itens de trabalho