Especifique os Critérios de Consulta

Você pode especificar critérios para sua consulta para localizar itens de trabalho. Usando critérios diferentes, você pode verificar o que é atribuído a você, identificar suas tarefas ativas ou pode exibir uma lista de recursos que são atribuídos a você ou sua equipe.

Todas as consultas de item de trabalho consistem em uma ou mais cláusulas e cada cláusula inclui um campo, um operador e um valor. Você pode filtrar o conjunto de itens de trabalho para satisfazer suas necessidades adicionando, modificando e agrupando cláusulas e campos em consultas que você cria.

Conteúdo do Tópico

Para especificar os critérios para uma consulta, conclua os seguinte procedimentos até que uma lista de itens de trabalho apareça em Resultados de Consulta:

1. Selecione o Tipo de Consulta

2. Especifique os Critérios de Nível Superior

3. Adicione, Remova, Agrupe ou Desagrupe Cláusulas

4. Execute uma Consulta

5. Ajuste os Critérios

Para obter informações sobre como filtrar seus critérios baseados em um valor de data ou associação a um grupo, consulte os seguintes procedimentos:

• Especifique um Filtro Baseado em um Valor Data-Hora

• Especifique um Filtro Baseado em Associação a um grupo

Permissões Necessárias

Para executar estes procedimento, você deve ser membro do grupo Leitores , ou sua permissão Exibir itens de trabalho neste nó deve estar definida para Permitir para cada projeto de equipe na consulta. Para salvar uma consulta de equipe, você deve ser membro do grupo Administradores de Projeto. Para obter mais informações, consulte a seguinte página: Permissões do Team Foundation Server.

Selecione o Tipo de Consulta

Para selecionar seu tipo de consulta

• Abra seu projeto de equipe, clique com o botão direito no nó de Itens de Trabalho, Minhas Consultas, ou Consultas de Equipe e então clique em Nova Consulta.

  Uma nova consulta é aberta.

  Observação
  O Plug-in do Team Foundation Server para Eclipse suporta apenas as consultas da lista plana. Você deve usar um cliente diferente para Team Foundation se deseja criar ou modificar uma consulta em camadas múltiplas.

Especifique os Critérios de Nível Superior

Os critérios de nível superior limitam os resultados da consulta por projeto de equipe e tipo de item de trabalho.

Observação
Por padrão, uma consulta retorna a todos os itens de trabalho (Tipo de Item de Trabalho=[Qualquer um] e Estado=[Qualquer um]) que são atribuídas a você(Atribuídas a=@Mim) no projeto da equipe atual(Projeto da Equipe=@Projeto).

Se você trabalhar vários projetos de equipe, você pode desejar pesquisar por todos usando uma única consulta.

Para especificar o nível superior de critérios de filtragem

1. Especifique o projeto de equipe ou projetos que contenham os itens de trabalho que você deseja localizar.

   • Se você desejar localizar itens de trabalho no projeto de equipe atual, mantenha Team Project=@Project.

   • Se você deseja localizar os itens de trabalho em outro projeto de equipe, digite o nome do projeto na coluna Valor do campo Projeto de Equipe.

   • Se você desejar localizar itens de trabalho em vários projetos de equipe, especifique os valores na tabela seguinte:

     E/Ou	Campo	Operador	Valor
     	Projeto de equipe	Em	FirstTeamProjectName, SecondTeamProjectName, ...

     Separe os nomes de projetos de equipe usando vírgulas (,).

2. Especifique o tipo de itens de trabalho que você deseja localizar.

   • Se você deseja localizar todos os tipos de itens de trabalho, mantenha o Tipo de Item de Trabalho = [Qualquer].

   • Se você desejar localizar um único tipo de item de trabalho, clique na coluna Valor do campo Tipo de Item de Trabalho e então clique no tipo de item de trabalho que você deseja localizar.

   • Se você deseja localizar diversos tipos de itens de trabalho, especifique os valores na tabela seguinte:

     E/Ou	Campo	Operador	Valor
     And	Tipo de item de trabalho	Em	FirstWorkItemType, SecondWorkItemType, ...

     Separe os nomes dos tipos de itens de trabalho usando vírgulas (,).

   • Se você deseja localizar todos os tipos de itens de trabalho que pertencem a uma categoria nomeada, especifique os valores na tabela seguinte:

     E/Ou	Campo	Operador	Valor
     And	Tipo de item de trabalho	Em Grupo	NameOfWorkItemTypeCategory

     Para obter informações sobre como definir categorias de tipos de item de trabalho, consulte a página seguinte: Personalizar Caregoria de Tipos de Itens de Trabalho.

     Para obter mais informações sobre modos de especificar critérios de nível superior, consulte Query Operators.

3. Na barra de ferramentas, clique em Executar Consulta, e confirme que sua consulta retornou os resultados esperados.

   Você também pode clicar com o botão direito na janela da consulta e, em seguida, clicar em Executar Consulta.

4. No menu Arquivo, escolha Salvar ou Salvar como.

   Você também pode pressionar CTRL+S para salvar.

Adicione, Remova, Agrupe ou Desagrupe Cláusulas de Consulta

Você pode adicionar uma cláusula para cada campo de item de trabalho para refinar seus resultados de consulta. Se você não receber os resultados que você espera de sua consulta, você poderá adicionar, remover, agrupar ou desagrupar as cláusulas para refinar seus resultados. Para obter mais informações sobre os elementos em uma cláusula, consulte Campos Consulta, Operadores, Valores e Variáveis (Team Explorer Everywhere).

Cada cláusula de consulta inclui um nome de campo, operador de consulta e valor. Use quantas cláusulas quanto necessário para obter resultados úteis.

Você pode agrupar cláusulas de consulta para operar como uma única unidade que está separada do resto da consulta. Esta abordagem se assemelha à colocação de parênteses ao redor de uma expressão em uma equação matemática ou instrução de lógica. Quando você agrupa cláusulas, o E ou OU da primeira cláusula no grupo se aplica ao grupo inteiro.

Para adicionar, remover, agrupar ou desagrupar as cláusulas de consulta

1. Adicione uma cláusula por uma das seguintes maneiras:

   1. Para adicionar a cláusula depois da última cláusula da sua consulta, clique em * na coluna mais à esquerda.

   2. Para inserir uma cláusula entre duas cláusulas, apenas clique com o botão direito abaixo de onde você deseja inserir a cláusula e então clique em Inserir Cláusula.

      Uma linha de cláusula aparece acima de onde o ponteiro estava.

   3. Para especificar que a cláusula deve ser tratada como uma cláusula Ou , clique na coluna E/Ou e então clique na lista Ou.

      Clique em E se os resultados devem corresponder a esta cláusula e a cláusula anterior. Clique em Ou se os resultados devem corresponder apenas a uma cláusula: esta ou a anterior.

   4. Especifique os valores para Campo, Operadore Valor, como mostra a tabela seguinte:

      Coluna Consulta	Uso
      Campo	Especifique um campo para o tipo de item de trabalho que você deseja localizar. O conjunto de itens de trabalho é filtrado baseado no Operador e os Valores que são definidos para o campo. Pressione as teclas ALT + SETA PARA BAIXO ou digite o nome do campo que você deseja especificar.
      Operador	Especifique como a consulta compara o valor no campo especificado em um registro. Exemplos de escolhas de operador são = (iguala), < > (não iguale), > (mais que), < (menos que), > = (mais que ou iguala), < = (menor ou igual a), Contém, não Contenha, Em, e, Já Era.
      Valor	Especifique o valor que você deseja localizar no campo selecionado. Se você puder especificar um valor de uma lista, clique na seta para especificar um a sua escolha. Se você deseja filtrar em diversos valores, use o operador In para especificar uma lista de valores delimitada por vírgulas. Para especificar um valor dinâmico, especifique uma variável de consulta válida.

      Para obter mais informações, consulte Campos Consulta, Operadores, Valores e Variáveis (Team Explorer Everywhere).

2. Exclua uma cláusula de consulta clicando com o botão direito do mouse na linha esquerda da cláusula que você deseja excluir e então clique em Excluir Cláusulas.

3. Para agrupar cláusulas, siga estas etapas:

   1. Em sua consulta, especifique as clausulas de consulta que você deseja agrupar segurando o CTRL e clicando na célula mais à esquerda de cada linha.

   2. Clique com o botão direito nas cláusulas realçadas e então clique em Agrupar Cláusulas.

   3. Um colchete aparece na margem esquerda da coluna E/Ou para mostrar que as cláusulas são agrupadas.

4. Para desagrupar cláusulas, siga estas etapas:

   1. Em sua consulta, realce todas as cláusulas do grupo segurando o CTRL e clicando na célula mais à esquerda de cada linha.

   2. Clique com o botão direito no grupo e então clique em Desagrupar Cláusulas.

      O colchete desaparece da margem esquerda da consulta e as cláusulas são desagrupadas.

      Observação
      Se a Desagrupar Cláusulas não estiver disponível, você não destacou todas as cláusulas no agrupamento de consulta. Realce todas as cláusulas e tente novamente.

Execute uma Consulta

Se um item de trabalho se altera para que corresponde ou não mais corresponda aos critérios, você pode executar novamente a consulta para atualizar seus resultados.

Para executar uma consulta

1. Na barra de ferramentas, clique em Executar Consulta.

   Você também pode clicar com o botão direito na consulta e, em seguida, clicar em Executar Consulta.

   Observação
   Você pode alterar quais colunas aparecem em seus resultados e como elas são classificadas adicionando qualquer campo que foi definido para os itens de trabalho que você está pesquisando. Para obter mais informações, consulte Adicione, Remova, Reordene e Classifique Colunas (Team Explorer Everywhere).

2. Revise seus resultados de consulta. Se eles não corresponderem a seus critérios de pesquisa, revise e modifique os critérios.

   Observação
   Você não pode cancelar uma consulta em execução nesta versão do Plug-in do Team Foundation Server para Eclipse.

Ajuste os Critérios

Se os resultados de sua consulta não corresponderem com suas expectativas, siga as etapas neste procedimento.

Para ajustar seus critérios

1. Verifique se cada cláusula é definida como você pretendeu.

2. Verifique as atribuições E/Ou de cada cláusula.

   Se seus resultados contiverem mais itens de trabalho do que o esperado, uma cláusula Ou pode estar presente em vez de uma cláusula E.

3. Verifique o agrupamento das cláusulas.

4. Se a consulta retornar muitos resultados, adicione cláusulas para refinar seus critérios.

Especifique Critérios de Data-Hora

Você pode procurar por itens de trabalho que foram alterados em uma data específica ou durante um intervalo específico de datas. Se você limitar o escopo de sua consulta, você pode melhorar o desempenho devolvendo apenas estes resultados que ajustaram a data ou o intervalo de data que você deseja incluir.

Para procurar itens de trabalho que foram modificados hoje

1. Selecione um valor na coluna Campo que é um tipo de dado de Data.

   Observação
   A maioria dos campos Data contêm a palavra "data" no nome de campo.

2. Na coluna Operador, clique em = (Igual).

3. Na coluna Valor, clique na seta e então clique em @Today para obter a data de hoje.

   Observação
   Você pode modificar esta variável para procurar por itens de trabalho que foram alterados dentro de um número de dias específico anteriores a hoje. Por exemplo, você pode localizar todos os itens que foram criados na última semana se você definir a coluna Campo como Activated Date, a coluna Operador para > =, e a coluna Valor para @ Hoje - 7.

4. Na barra de ferramentas, clique em Executar Consultae analise seus resultados da consulta.

   Você também pode clicar com o botão direito na definição da consulta e, em seguida, clicar em Executar Consulta.

Para procurar itens de trabalho que foram modificados em uma data específica

1. Selecione um valor na coluna Campo que é um tipo de dado de Data para adicionar ou modificar uma cláusula de consulta.

2. Na coluna Operador, clique em = (Igual).

3. Na coluna Valor, digite a data em os itens deveriam ser modificados.

4. Na barra de ferramentas, clique em Executar Consultae analise seus resultados da consulta.

   Você também pode clicar com o botão direito na definição da consulta e, em seguida, clicar em Executar Consulta.

Para procurar itens de trabalho que foram modificados durante um intervalo de datas

1. Selecione um valor na coluna Campo que é um tipo de dado de Data para adicionar ou modificar uma cláusula de consulta.

2. Na coluna Operador, clique > (Maior Que) ou clica > = (Maior Que ou Iguala) para especificar a data mais recente no intervalo.

   Especifique > = (Maior Que ou Iguala) se você desejar localizar itens que foram modificados na data mais anterior no intervalo.

3. Na coluna Valor, digite a data mais recente no intervalo.

4. Insira outra cláusula de consulta diretamente sob a cláusula de consulta anterior.

5. Na coluna de atribuições E/ou clique em E.

6. Na coluna Operador, clique < (Menos Que) ou clica < = (Menor ou igual a) para especificar a mais recente data no intervalo.

   Especifique < = (Menor ou igual a) se você desejar localizar itens que foram modificados na mais recente data no intervalo.

7. Na coluna Valor, especifique a data mais recente no intervalo.

8. Agrupe as duas cláusulas que você criou.

9. Na barra de ferramentas, clique em Executar Consultae analise seus resultados da consulta.

   Você também pode clicar com o botão direito na definição da consulta e, em seguida, clicar em Executar Consulta.

Especifique um Filtro Baseado em Associação a um grupo

Você pode usar os operadores Em Grupo ou Não Está Em Grupo para especificar critérios baseados em vários valores que são ou não membros de um grupo. Exemplos de grupos são grupos dedistribuição que são definidos em Team Foundation Server, uma categoria de tipos de itens de trabalho ou todos os bugs ativos que são atribuídos a seus relatórios.

Para localizar itens de trabalho baseados em um valor que pertence a um grupo

1. Você pode procurar por itens de trabalho que atendam aos seguintes critérios:

   • Para localizar itens de trabalho que são ativos e atribuído a alguém que pertence ao grupo de Administradores do Projeto, adicione a cláusula que mostra a seguinte tabela:

     E/Ou	Campo	Operador	Valor
     And	Atribuído A	Em Grupo	Administradores de Projeto

   • Para localizar itens de trabalho que são ativos e atribuído a alguém que relata a você, adicione as cláusulas que mostra a seguinte tabela:

     E/Ou	Campo	Operador	Valor
     And	Estado	=	Active
     And	Atribuído A	Em Grupo	MyDirectReportsDistributionGroup

2. Na barra de ferramentas, clique em Executar Consultae analise seus resultados da consulta.

   Você também pode clicar com o botão direito na definição da consulta e, em seguida, clicar em Executar Consulta.

Consulte também

Outros recursos

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

Adicione, Remova, Reordene e Classifique Colunas (Team Explorer Everywhere)

Salve, Copie, Renomeie e Exclua Consultas de Itens de Trabalho (Team Explorer Everywhere)

Lista de Itens de Trabalho (Lista Plana Padrão) (Team Explorer Everywhere)

Localizando Bugs, Tarefas e Outros Itens de Trabalho (Team Explorer Everywhere)