Especificar critérios de filtro de consulta

Você pode especificar os critérios de filtro para a sua consulta localizar itens de trabalho e muito mais facilmente, selecione os dados filtrados que você deseja usar. Usando os critérios de filtro diferente, você pode verificar o que é atribuído a você, suas tarefas ativas que são ou ver uma lista dos recursos atribuídos a você ou sua equipe.

Todas as consultas de item de trabalho consistem em uma ou mais cláusulas de consulta; Cada cláusula inclui um campo, um operador e um valor. Você pode adicionar, modificar e cláusulas de grupo e campos em consultas que você criar filtrando o conjunto de itens para atender às suas necessidades de trabalho.

Neste tópico

Para especificar os critérios de filtro, conclua os procedimentos a seguir até que você tenha o conjunto de itens de trabalho listados na Resultados da consulta modo de exibição:

  1. Selecione o tipo de consulta

  2. Especificar critérios de filtro de consulta de nível superior

  3. Adicionar, remover, grupo ou desagrupar as cláusulas de consulta

  4. Executar ou cancelar uma consulta e os resultados da consulta de seleção

  5. Ajustar seus critérios de filtro de consulta

    ObservaçãoObservação

    Os procedimentos a seguir são gravados por Team Explorer. Os procedimentos para Team Web Access são semelhantes, mas pode variar ligeiramente em detalhes.

Para filtrar os critérios com base em um valor de data ou um valor que pertence a um grupo, consulte os seguintes procedimentos:

  • Especificar um filtro com base em um valor de data e hora

  • Especificar um filtro com base na participação em um grupo

Permissões necessárias

Para executar esses procedimentos, você deve ser um membro da leitores group, ou seu Exibir itens de trabalho nesse nó permissão deve ser definida Permitir para cada projeto de equipe na consulta. Para salvar uma consulta como uma consulta de equipe, você deve ser um membro da Administradores de projeto grupo. Para obter mais informações, consulte Permissões de Team Foundation Server.

Selecione o tipo de consulta

Para selecionar seu tipo de consulta em Team Explorer

  1. Abra o projeto de equipe, expanda o Itens de trabalho nó e selecione Consultas da equipe ou Minhas consultas.

  2. Sobre o equipe menu, clique em Adicionar consulta Add Query. Ou, com o botão direito do Itens de trabalho, Minhas consultas, ou Consultas da equipe nó e depois clique em Adicionar consulta Add Query.

    Uma nova Simples lista de itens de trabalho (padrão) abre de consulta.

  3. Na barra de ferramentas de consulta, selecione o De consulta do tipo com base no tipo de itens de trabalho ou de modo que você deseja localizar:

    • Simples de lista de itens de trabalho (padrão): Retorna um único nível (Consulta simples lista plana) de itens de trabalho que correspondam aos seus critérios de filtro. Use este tipo de consulta para localizar itens de trabalho que você deseja vincular a outros itens de trabalho, exportar itens de trabalho para Office Excel e Office Project para atualizações para os campos de coluna em massa ou gerar um relatório sobre um conjunto de itens de trabalho. Para obter mais informações, consulte Itens de trabalho da lista (lista de tela plana padrão).

    • Links diretos e itens de trabalho: Retorna um conjunto de duas camadas de itens de trabalho (Consulta de vínculos diretos) que correspondam aos critérios de filtro e todos os itens de trabalho que estão vinculados a eles com base em critérios de filtro secundário. Este modo exibe os itens de trabalho em uma exibição recolhível expansível. Para obter mais informações, consulte Exibir e modificar itens de trabalho em uma exibição de Links diretos.

    • Árvore de itens de trabalho: Retorna um conjunto de vários níveis de itens de trabalho (Consulta de árvore) que correspondem aos critérios de filtro e inclui todos os itens de trabalho que estão vinculados aos itens de trabalho de nível superior com base em links de pai-filho. Este modo exibe os itens de trabalho em uma exibição hierárquica expansível ou recolhível. Para obter mais informações, consulte Exibir e modificar itens de trabalho em um modo de exibição de árvore.

Voltar ao topo

Especifique os critérios de filtro de consulta nível superior

Os critérios de filtro de nível superior limita os resultados da consulta para um projeto de equipe e um tipo de item de trabalho.

ObservaçãoObservação

Os critérios de filtro padrão definidos para uma nova consulta retorna todos os itens de trabalho (tipo de Item de trabalho = [Any e estado = [Any) que são atribuídos a você (Atribuído To=@Me) para o projeto de equipe atual (Project=@Project da equipe).

Se você trabalhar em vários projetos de equipe, convém pesquisar todos eles com uma única consulta.

Para especificar os critérios de filtro de nível superior

  1. Especifique os projetos de equipe que contêm os itens de trabalho que você deseja localizar. Se você desejar retornar os itens de trabalho para:

    • O atual projeto de equipe, manter Project=@Project da equipe.

    • Outra equipe do projeto, digite o nome do projeto da equipe no valor coluna para o O projeto de equipe campo.

    • Vários projetos de equipe, digite os valores mostrados na tabela a seguir:

      E/ou

      Campo

      Operador

      Valor

       

      Projeto de equipe

      Em

      < primeiro team project name >, < segundo team project name >,...

      Separe os nomes de projeto de equipe com vírgulas (,).

  2. Especifique o tipo de itens de trabalho que você deseja localizar. Se você desejar retornar os itens de trabalho para:

    • Todos os tipos, manter Work Item Type = [Any.

    • Um único tipo, clique no valor coluna para o Tipo de Item de trabalho de campo e clique no tipo de item de trabalho desejado.

    • Vários tipos de itens de trabalho, digite os valores mostrados na tabela a seguir:

      E/ou

      Campo

      Operador

      Valor

      And

      Tipo de Item de trabalho

      Em

      < primeiro item de trabalho tipo >, < segundo item de trabalho tipo >,...

      Separe os nomes de cada tipo de item de trabalho com vírgulas (,).

    • Todos os tipos de itens de trabalho que pertencem a uma categoria nomeada, insira os valores mostrados na tabela a seguir:

      E/ou

      Campo

      Operador

      Valor

      And

      Tipo de Item de trabalho

      No grupo

      < nome do grupo de tipo de item de trabalho >

      Para obter informações sobre como definir grupos de tipo de item de trabalho, consulte Personalizando as categorias de tipos de Item de trabalho [witadmin].

      Para obter opções adicionais que você pode usar para filtrar os critérios de nível superior, consulte "Operadores" seção Variáveis, campos, operadores e valores de consulta.

  3. Na barra de ferramentas de consulta, clique em Executar consulta Executare confirme que a consulta retornou os resultados esperados.

  4. Click Salvar Save or Save as. Para obter mais informações, consulte Salvar, copiar, renomear e excluir as consultas de itens de trabalho.

Voltar ao topo

Adicionar, remover, grupo ou desagrupar as cláusulas de consulta

Você pode adicionar uma nova cláusula para cada campo de item de trabalho refinar seus critérios de pesquisa e retornar apenas o conjunto de itens de trabalho que você deseja. Se você não receber os resultados que você espera da sua consulta, você pode adicionar, remover, agrupar ou desagrupar as cláusulas de consulta para refinar os resultados da consulta. Para obter informações sobre os elementos em uma cláusula de consulta, consulte Variáveis, campos, operadores e valores de consulta.

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

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

Como mostra a tabela a seguir, as cláusulas agrupadas são traduzidas para a expressão lógica correspondente. A primeira expressão que retorna os itens de trabalho que são de prioridade 1 e todos os ativos de bugs de qualquer prioridade. A segunda expressão retorna todos os itens de trabalho ativo de prioridade 1 e todos os bugs de prioridade 1, independentemente de estarem ativos ou não.

Cláusulas agrupadas

Expressão lógica

OU operador com a cláusula AND agrupada

Prioridade = 1 ou (tipo de Item de trabalho = estado do Bug E = ativo)

E o operador com agrupados ou cláusula

Prioridade = 1 AND (tipo de Item de trabalho Bug ou estado de = = ativo)

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

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

    1. Para adicionar a cláusula final dos critérios de filtro, clique em Clique aqui para adicionar uma nova cláusula.

    2. Ou, para inserir uma cláusula, o botão direito do mouse onde você deseja que a cláusula inserida e clique em Inserir cláusula de consulta Inserir cláusula.

      Uma nova linha de cláusula de consulta é adicionada acima de onde o ponteiro era.

    3. Se você desejar que a cláusula deve ser tratado como um ou cláusula, clique em ee em seguida, clique em ou.

      Selecione e se a cláusula e a cláusula anterior devem ambos estar true para corresponder ao resultado. Selecione ou se a cláusula anterior ou desta cláusula deve ser true para corresponder ao resultado.

    4. Especificar os valores para campo, operador, e valor.

      Coluna de consulta

      Uso

      Campo

      Especifica um campo para o tipo de itens de trabalho que você deseja localizar. O conjunto de itens de trabalho é filtrado com base na operador e o valores definido para o campo.

      Pressione ALT + Seta para baixo ou digite o nome do campo que você deseja selecionar.

      Operador

      Especifique como a consulta compara o valor encontrado no campo especificado em um registro. São exemplos de opções do operador = (igual), < > (não igual a), > (maior que), < (menor que), > = (maior ou igual a), < = (menor ou igual a), contém, Não contém, eme, Nunca foi.

      Valor

      Especifique o valor que você deseja localizar no campo selecionado. Se houver uma lista de valores disponíveis para seleção, clique na seta para selecionar o valor que você deseja. Você pode especificar uma variável de consulta para adicionar dinamicamente os valores para a sua consulta.

      Se houver uma lista de valores disponíveis para seleção, clique na seta para selecionar aquele que você deseja. Se houver vários valores que você deseja filtrar, use o em operador para especificar uma lista delimitada por ponto-e-vírgula dos valores. Para especificar um valor dinâmico, especifica uma variável de consulta válida.

      Para obter mais informações, consulte Variáveis, campos, operadores e valores de consulta.

  2. Excluir uma cláusula de consulta, clicando-se à esquerda da linha de cláusula que você deseja excluir e clique em Excluir cláusula de consulta Excluir cláusulas.

  3. Grupo de item de trabalho cláusulas de consulta seguindo estas etapas:

    1. Na consulta, selecione cláusulas de consulta que você deseja combinar em um grupo, clicando na célula mais à esquerda nas linhas. Pressione CTRL e clique para selecionar várias linhas.

    2. As cláusulas selecionadas com o botão direito e clique em Agrupar cláusula de consulta Grupo cláusulas.

      Um colchete aparecerá na margem esquerda da consulta que mostra que as cláusulas são agrupadas.

  4. Desagrupe cláusulas de consulta de item de trabalho seguindo estas etapas:

    1. Na consulta, selecione cláusulas de consulta totalmente agrupada que você deseja desagrupar clicando na célula mais à esquerda nas linhas. Pressione CTRL e clique para selecionar várias linhas.

    2. Clique com o botão direito no grupo e clique em Desagrupar cláusula de consulta Cláusulas desagrupar.

      O suporte é removido da margem esquerda da consulta e as cláusulas forem desagrupadas.

      ObservaçãoObservação

      Se Cláusulas desagrupar está disponível, você não selecionou todas as cláusulas de agrupamento de consulta. Selecione todas as cláusulas e tente novamente.

Voltar ao topo

Executar ou cancelar uma consulta e os resultados da verificação

Você pode executar uma consulta de item de trabalho para pesquisar os itens de trabalho em seu projeto de equipe que corresponde aos critérios da consulta. Se você alterar os itens de trabalho para alterar os resultados de uma consulta, você pode executar novamente a consulta para atualizar os resultados.

Para executar ou cancelar uma consulta com base nos critérios de filtro de consulta

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

    ObservaçãoObservação

    Você pode adicionar qualquer campo definido para os itens de trabalho que está sendo pesquisados para controlar como os resultados da consulta são exibidos e classificados. Para obter mais informações, consulte Adicionar, remover, reorganizar e classificar colunas.

  2. Para cancelar a sua pesquisa de consulta, clique em Parar consulta Parar consulta, ou, no equipe menu, clique em Parar atualização.

  3. Revise os resultados da consulta. Se a lista de itens de trabalho não correspondem aos critérios de pesquisa esperada, examinar e modificar os critérios de filtro, conforme necessário.

Voltar ao topo

Ajustar seus critérios de filtro de consulta

Para ajustar seus critérios de filtro

  • Se os resultados da consulta não retornar a seu conjunto esperado de itens de trabalho, execute as seguintes verificações:

    1. Verifique cada cláusula para certificar-se de que ela é definida como pretendido.

    2. Verifique o e /oatribuições de r para cada cláusula. Se os resultados conter itens de trabalho mais do que o esperado, geralmente um ou cláusula está presente em vez de um e cláusula.

    3. Verifique o agrupamento das cláusulas de consulta e o e/ou as atribuições de cada cláusula agrupada.

    4. Adicione mais cláusulas de consulta para refinar seus critérios de filtro de consulta.

    5. Examine as opções disponíveis para especificar os campos, operadores e valores conforme descrito em Variáveis, campos, operadores e valores de consulta. Determine se você deseja modificar uma cláusula de consulta para usar um campo diferente, o operador ou o valor.

Voltar ao topo

Especificar um filtro com base em um valor de data e hora

Você pode classificar itens de trabalho, a data em que foram alteradas ou por um período de tempo específico. Se você limitar o escopo da consulta, ele pode ajudar com desempenho retornando somente os resultados que ajustar o intervalo de datas que você deseja incluir.

Para localizar os itens de trabalho com base nos critérios de filtro de data específica

  1. Procurar por itens de trabalho modificados hoje seguindo estas etapas:

    1. Selecione um campo isto é um tipo de dados de data para adicionar ou modificar uma cláusula de consulta.

      ObservaçãoObservação

      A maioria dos campos de data contêm a palavra "Data" o nome do campo.

    2. No operador coluna, selecione = (igual).

    3. No valor coluna, clique na seta e selecione @ Hoje para a data de hoje.

      ObservaçãoObservação

      Você pode modificar essa variável para procurar a data atual menos um número de dias. Por exemplo, para localizar todos os itens, iniciados na semana passada, você definiria a campo coluna para Ativado Data, o operador coluna para > =e o valor coluna para @Today - 7.

    4. Clique em Executar consulta Executare verificar os resultados da consulta.

  2. Procurar por itens de trabalho modificados em uma data específica, seguindo estas etapas:

    1. Selecione um campo isto é um tipo de dados de data para adicionar ou modificar uma cláusula de consulta.

    2. No operador coluna, selecione = (igual).

    3. No valor coluna, digite a data em que segue o formato aceito pelo sistema operacional do computador.

    4. Clique emExecutar consulta Executare verificar os resultados da consulta.

  3. Procurar por itens de trabalho modificados ao longo de um intervalo de datas, seguindo estas etapas:

    1. Selecione um campo isto é um tipo de dados de data para adicionar ou modificar uma cláusula de consulta.

    2. No operador colunaselecionar > (Maior que), se desejar somente itens após a data, ou > = (maior que ou igual A) se desejar que os itens que contenham a data em que você selecionar.

    3. No valor coluna, insira a primeira data no intervalo de datas que segue o formato de data aceito pelo sistema operacional do computador.

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

    5. No e/ou coluna de atribuições, selecione e.

    6. No operador coluna,selecionar < (Menor que) se desejar somente itens antes da data, ou < = (menor ou igual A) se desejar que os itens que contenham a data em que você selecionar.

    7. No valor coluna, insira a última data no intervalo de datas a seguir o formato de data aceito pelo sistema operacional do computador.

    8. No operador coluna, selecione = (igual).

    9. No valor coluna, digite a data em que segue o formato aceito pelo sistema operacional do computador.

    10. Selecione duas cláusulas de consulta específica de data e agrupá-los.

    11. Clique emExecutar consulta Executare verificar os resultados da consulta.

Voltar ao topo

Especificar um filtro com base na participação em um grupo

Você pode usar o In Group ou Não grupo operadores para filtrar uma consulta baseada em vários valores que são ou não são membros de um grupo. Você pode especificar grupos de distribuição em Team Foundation Server ou uma ou mais categorias de tipos de item de trabalho.

Para localizar os itens de trabalho com base em um valor que pertence a um grupo

  1. Especifique os seguintes tipos de cláusulas:

    • Adicione a seguinte cláusula para localizar itens de trabalho que são atribuídos a qualquer usuário que pertence ao grupo Administradores do projeto:

      E/ou

      Campo

      Operador

      Valor

      And

      Atribuído À

      No grupo

      Administradores de projeto

    • Adicione a seguinte cláusula para localizar itens de trabalho ativa de qualquer tipo de item de trabalho do grupo de categoria de teste:

      E/ou

      Campo

      Operador

      Valor

      And

      Estado

      =

      Active

      And

      Tipo de Item de trabalho

      No grupo

      Teste

    Para obter informações sobre grupos de categorias, consulte O agrupamento de tipos de Item de trabalho em categorias.

  2. Clique em Executar consultae verificar os resultados da consulta.

Voltar ao topo

Consulte também

Tarefas

Adicionar, remover, reorganizar e classificar colunas

Salvar, copiar, renomear e excluir as consultas de itens de trabalho

Itens de trabalho da lista (lista de tela plana padrão)

Exibir e modificar itens de trabalho em uma exibição de Links diretos

Exibir e modificar itens de trabalho em um modo de exibição de árvore

Conceitos

Variáveis, campos, operadores e valores de consulta

Localização de Bugs, tarefas e outros itens de trabalho

Histórico de alterações

Date

History

Motivo

Agosto de 2010

Adicionado o exemplo de como a uma cláusula agrupada logicamente é avaliada.

Comentários do cliente.

Setembro de 2010

Exemplo corrigido para o In Group operador.

Comentários do cliente.