Definir uma consulta de item de trabalho no Azure Boards
Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019 | TFS 2018
Visual Studio 2019 | Visual Studio 2022
As consultas de item de trabalho geram listas de itens de trabalho com base nos critérios de filtro fornecidos. Em seguida, você pode salvar e compartilhar essas consultas gerenciadas com outras pessoas. Por outro lado, pesquisas semânticas listam itens de trabalho, mas não podem ser salvas ou compartilhadas.
Crie consultas do portal da Web ou de um cliente com suporte, como o Visual Studio Team Explorer. Você também pode definir e importar uma consulta de item de trabalho usando a sintaxe WIQL e um arquivo .wiq. Para dar suporte a atualizações ou adições em massa, importe ou exporte consultas usando arquivos do Excel ou .csv.
Crie consultas do portal da Web ou de um cliente com suporte, como o Visual Studio Team Explorer. Você também pode definir e importar uma consulta de item de trabalho usando a sintaxe WIQL e um arquivo .wiq. Para dar suporte a atualizações ou adições em massa, importe ou exporte consultas usando o Excel.
Se você achar que suas consultas levam muito tempo para retornar resultados, examine as Diretrizes para criar consultas de alto desempenho.
Neste artigo, você aprenderá sobre:
- Como adicionar ou criar uma consulta
- Como consultar entre projetos
- Como agrupar e desagrupar cláusulas de consulta
- Como criar uma árvore de itens de trabalho ou uma consulta de links diretos
Para obter acesso rápido a todas as tarefas de consulta, os operadores com suporte, como, Contains, In, In Groupe <>(não operador) , com base no tipo de dados de campo e nos exemplos de consulta, consulte Referência rápida de consulta.
Escolher um filtro de consulta
No Editor de Consultas, exerça as seguintes funções de filtro. Escolha o filtro para ir para um artigo com consultas de exemplo. Junto com os filtros de consulta, você pode aplicar filtros interativamente aos resultados da consulta.
Observação
As consultas gerenciadas não dão suporte a pesquisas de proximidade, no entanto, pesquisas semânticas dão. Além disso, pesquisas semânticas são compatíveis com caracteres * curinga e ? você pode usar mais de um caractere curinga para corresponder a mais de um caractere. Para saber mais, confira Pesquisa de item de trabalho funcional.
Filtrar recursos
Macros
Junto com os filtros que você usa do Editor de Consultas, você pode filtrar interativamente um resultado de consulta usando a 
função Filter. Para saber como, confira Filtrar interativamente listas de pendências, quadros, consultas e planos.
Pré-requisitos
- Por padrão, todos os membros do projeto e usuários com acesso ao Stakeholder podem exibir e executar todas as consultas compartilhadas. Você pode alterar as permissões definidas para uma pasta de consulta compartilhada ou uma consulta compartilhada. Para obter detalhes, consulte Definir permissões de consulta.
- Para adicionar e salvar uma consulta em Consultas compartilhadas, você deve receber acesso básico ou superior. Além disso, você deve ter a permissão Contribuir definida como Permitir para a pasta à qual deseja adicionar a consulta. Por padrão, o grupo Colaboradores não tem essa permissão.
Observação
Os usuários com acesso de stakeholders para um projeto público têm acesso total aos recursos de consulta, assim como os usuários com acesso básico . Para obter detalhes, consulte Referência rápida de acesso de stakeholders.
- Por padrão, todos os membros do projeto e usuários com acesso ao Stakeholder podem exibir e executar todas as consultas compartilhadas. Você pode alterar as permissões definidas para uma pasta de consulta compartilhada ou uma consulta compartilhada. Para obter detalhes, consulte Definir permissões de consulta.
- Para adicionar e salvar uma consulta em Consultas compartilhadas, você deve receber acesso básico ou superior. Além disso, você deve ter a permissão Contribuir definida como Permitir para a pasta à qual deseja adicionar a consulta. Por padrão, o grupo Colaboradores não tem essa permissão.
Abrir consultas
No navegador da Web, (1) verifique se você selecionou o projeto certo, (2) escolha Consultas de Quadros> e, em seguida, (3) escolha Todos.
Se for sua primeira vez abrindo Consultas, a página será aberta para Favoritos. Esta página lista as consultas que você indicou serem as favoritas. Caso contrário, você pode escolher Todos para exibir todas as consultas que definiu e as consultas compartilhadas definidas para o projeto.
Dica
Consultas que você ou sua equipe escolheram como favoritos aparecem na página Favoritos . As consultas favoritas, juntamente com outros objetos, também aparecem na página projeto . Para saber mais, confira Definir favoritos pessoais ou de equipe.
No navegador da Web, abra Consultas de Quadros>.
Definir uma consulta de lista simples
Você pode iniciar uma nova consulta na guia Consultas no portal da Web ou na guia Itens de Trabalho no Team Explorer.
O Editor de Consultas é exibido com as seguintes configurações padrão: Lista simples de itens de trabalho, Tipo de Item de Trabalho=[Qualquer]e Estado=[Qualquer].
Você pode modificar os Valores e adicionar ou remover cláusulas. Ou altere o Tipo de consulta para Itens de trabalho e links diretos ou para uma Árvore de itens de trabalho.
O Editor de Consultas é exibido com as seguintes configurações padrão: Lista simples de itens de trabalho, Team Project=@Project (o projeto atual), Tipo de Item de Trabalho=[Qualquer]e Estado=[Qualquer].
Você pode modificar os Valores e adicionar ou remover cláusulas. Ou altere o Tipo de consulta para Itens de trabalho e links diretos ou para uma Árvore de itens de trabalho.
Consultar entre projetos ou dentro de projetos
O escopo de novas consultas para o projeto atual por padrão. No entanto, você pode criar consultas para localizar itens de trabalho definidos na organização ou na coleção de projetos. No entanto, todas as consultas salvas são salvas em um projeto específico.
Para listar itens de trabalho definidos em dois ou mais projetos, marque a marca de seleção Consulta entre projetos. Por exemplo, a consulta a seguir localiza todos os recursos criados em todos os projetos nos últimos 30 dias.
Com a consulta entre projetos marcada, você pode adicionar o campo Projeto de Equipe para filtrar para um número selecionado de projetos.
Observação
Separe vários nomes de projeto com o separador de lista que corresponde às configurações regionais definidas para o computador cliente, por exemplo, uma vírgula (,).
O campo Projeto de Equipe está disponível somente depois que você verifica a Consulta entre projetos. Além disso, quando a consulta entre projetos é desmarcada , somente os campos desses tipos de item de trabalho, conforme definido no projeto atual, aparecem no menu suspenso Campo . Quando a consulta entre projetos é verificada, todos os campos de todos os tipos de item de trabalho definidos em todos os projetos da coleção aparecem no menu suspenso Campo .
Definir uma cláusula
Você cria uma consulta definindo uma ou mais cláusulas. Cada cláusula define um critério de filtro para um único campo.
Cláusula de consulta de amostra
| E/Ou | Campo | Operador | Valor |
|---|---|---|---|
| And | Atribuído a | = | @Me |
Para obter uma lista de operadores disponíveis com base no tipo de dados de campo, consulte Referência rápida do índice de consulta.
Todas as cláusulas adicionadas são adicionadas como uma instrução And . Escolha Ou para alterar o agrupamento. Você agrupa cláusulas para garantir que as instruções de cláusula sejam executadas na sequência necessária.
Escolha Adicionar nova cláusula para adicionar outra cláusula no final da consulta e escolha Campo,Operador e Valor para essa cláusula.
Por exemplo, pesquise todos os itens de trabalho atribuídos a você especificando o campo Atribuído a , o operador equals (=) e a macro @Me , que representa a identidade do usuário.
Excluir Cláusula.
Executar ou 
Salvar Consulta.Dica
Para exibir a sintaxe WIQL de uma consulta e como os parênteses são usados para agrupar cláusulas, instale o Editor do Wiql do Marketplace. Essa extensão dá suporte à exibição da sintaxe WIQL e à exportação dela para um arquivo WIQL para uso em chamadas à API REST. Para saber mais, confira Sintaxe da WIQL (Linguagem de Consulta de Item de Trabalho).
Lista de verificação de como definir uma cláusula de consulta
Na primeira linha vazia, no título 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 e valores de consulta.
Na mesma linha, no título 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.
Na mesma linha, no título Da coluna Valor , digite um valor ou escolha a seta para baixo e escolha um item na lista.
Para obter mais informações sobre como usar uma macro ou variável para especificar o projeto atual, o usuário, a data ou outra seleção, consulte Variáveis.
Para adicionar uma cláusula, escolha Adicionar nova cláusula.
Você pode adicionar uma cláusula ao final da consulta ou executar as seguintes tarefas com os ícones correspondentes:
Inserir nova linha de filtro
Remover essa linha de filtro
Cláusulas selecionadas do grupo
Desagrupar cláusulas
Usar uma árvore de itens de trabalho para exibir hierarquias
Use a 
consulta Árvore de Itens de Trabalho para exibir uma lista aninhada de itens de trabalho de várias camadas. Por exemplo, você pode exibir todos os itens da lista de pendências e suas tarefas vinculadas. Para se concentrar em diferentes partes da árvore, escolha 
Expandir tudo ou 
Recolher tudo.
Observação
Você não pode construir uma consulta que mostre uma exibição hierárquica de Test Plans, Conjuntos de Testes e Casos de Teste. Esses itens não são vinculados juntos usando tipos de link pai-filho. No entanto, você pode criar uma consulta de links diretos que lista itens de trabalho relacionados ao teste. Além disso, você pode exibir a hierarquia por meio da página Test Plans.
Defina os critérios de filtragem para os itens de trabalho pai e filho. Para localizar filhos vinculados, selecione Corresponder itens de trabalho de nível superior primeiro. Para localizar pais vinculados, selecione Corresponder itens de trabalho vinculados primeiro.
Usar links diretos para exibir dependências
Use a 
consulta Itens de trabalho e links diretos para acompanhar itens de trabalho que dependem de outros trabalhos rastreados, como tarefas, bugs, problemas ou recursos. Por exemplo, você pode exibir itens da lista de pendências que dependem de outros itens que estão sendo implementados ou um bug que está sendo corrigido.
Use a consulta de links diretos para rastrear dependências entre equipes. A consulta também ajuda você a gerenciar compromissos que sua equipe faz. Escolha os critérios de filtro para os itens de trabalho principais e vinculados. E selecione os tipos de links para filtrar as dependências.
Filtre a lista da primeira camada de itens de trabalho escolhendo uma destas opções:
Retorna apenas itens que têm links correspondentes: os itens de trabalho de primeira camada retornam, mas somente se eles tiverem links para itens de trabalho especificados pelos critérios de filtro de itens de trabalho vinculados.
Retornar todos os itens de nível superior: todos os itens de trabalho de primeira camada retornam apesar dos critérios de filtro de itens de trabalho vinculados. Os itens de trabalho de segunda camada que estão vinculados à primeira camada retornam se corresponderem aos critérios de filtro de itens de trabalho vinculados.
Retorna apenas itens que não têm links correspondentes: os itens de trabalho de primeira camada são retornados, mas somente se eles não tiverem links para itens de trabalho especificados pelos critérios de filtro de itens de trabalho vinculados.
Para saber mais sobre cada tipo de link, confira Vinculação, rastreabilidade e gerenciamento de dependências.
Expressão lógica And/Or
E ouou para criar expressões lógicas de suas cláusulas de consulta. Especifique E para localizar itens de trabalho que atendam aos critérios na cláusula atual e na cláusula anterior. Especifique Ou para localizar itens de trabalho que atendam ao critério na cláusula atual ou na cláusula anterior.
Adicione uma nova cláusula para cada campo de item de trabalho para refinar os critérios de pesquisa. Adicione cláusulas para retornar apenas o conjunto de itens de trabalho desejados. Se você não receber os resultados esperados da consulta, refina-os. Você pode adicionar, remover, agrupar ou desagrupar cláusulas de consulta para melhorar os resultados da consulta.
Cláusulas de consulta de grupo para operar como uma única unidade separada do restante da consulta. Cláusulas de agrupamento são semelhantes a colocar parênteses em torno de uma expressão em uma equação matemática ou instrução lógica. Quando você agrupa cláusulas , AND ouOR para a primeira cláusula no grupo se aplica a todo o grupo.
Cláusulas de grupo
As cláusulas agrupadas operam como uma única unidade separada do restante da consulta. Cláusulas de agrupamento são semelhantes a colocar parênteses em torno de uma equação matemática ou expressão lógica. O operador And ou Or para a primeira cláusula no grupo se aplica a todo o grupo.
Como mostram os exemplos a seguir, as cláusulas agrupadas são convertidas para a expressão lógica correspondente.
Dica
Para exibir a sintaxe WIQL de uma consulta, instale a extensão do editor de consultas WIQL que permitirá que você veja a versão WIQL de qualquer entrada de interface do usuário de consulta. Essa extensão permite que você veja exatamente como as cláusulas agrupadas AND/OR são tratadas.
| Consulta | Cláusulas agrupadas | Expressão lógica |
|---|---|---|
| 1 |  |
 |
| 2 |  |
 |
| 3 |  |
 |
Essas consultas retornam itens de trabalho que são do tipo Bug e atendem às seguintes expressões lógicas:
- Consulta 1:
AND State=Active OR Assigned to @Me - Consulta 2:
AND (State=Active OR Assigned to @Me) - Consulta 3:
OR (State=Active AND Assigned to @Me)
Para agrupar uma ou mais cláusulas, selecione-as e escolha o ícone de cláusulas de 
grupo.
Você também pode agrupar várias cláusulas agrupadas. Marque as caixas de cada cláusula que já foi agrupada. Em seguida, escolha o ícone de cláusulas de grupo.
Se os resultados da consulta não retornarem os resultados esperados, siga estas etapas:
- Verifique se cada cláusula está definida como você pretendia.
- Verifique as atribuições de E/Ou a cada cláusula. Se seus resultados contiverem mais itens de trabalho do que o esperado, normalmente uma cláusula Ou está presente em vez da cláusula E.
- Determine se você precisa agrupar ou alterar o agrupamento das cláusulas da consulta e as atribuições de E/Ou de cada cláusula agrupada.
- Adicione mais cláusulas de consulta para refinar seus critérios de filtragem de consulta.
- Examine as opções disponíveis para especificar campos, operadores e valores.
Desagrupar uma cláusula
Para desagrupar uma cláusula, escolha o 
ícone de cláusulas de desagrupar para a cláusula agrupada.
ícone de cláusulas de desagrupar para a cláusula agrupada, Visual Studio.Exibir resultados da consulta em um painel
Os dois widgets a seguir exibem os resultados da consulta. Você pode abrir itens de trabalho diretamente desses widgets.
- Trabalho atribuído a mim: lista todos os itens de trabalho propostos ou ativos atribuídos ao usuário conectado. Lista os campos ID, Estado e Título.
- Widget de resultados da consulta: exibe os resultados de uma consulta simples, de árvore ou de links diretos. Você pode configurar os campos exibidos por meio do widget, redimensionar os campos de coluna e expandir e recolher a consulta de árvore e links diretos.
Para saber mais sobre como adicionar widgets a um painel, consulte Adicionar widgets a um painel.
Exibir o widget de resultados da consulta com títulos pai
Você pode exibir os resultados de uma consulta com o título Pai exibido. Para fazer isso, execute estas etapas:
- Crie a consulta que filtra os itens de trabalho de interesse. A consulta pode ser uma consulta de lista simples, árvore ou links diretos.
- Adicione o campo Pai como uma coluna.
- Salve a consulta como uma consulta compartilhada ou Favorito da equipe.
- Adicione o widget Resultados da consulta ao painel e configure a consulta. Verifique se o campo Pai está definido para ser exibido.
A imagem a seguir ilustra um widget de resultados da consulta que exibe o campo Pai .
Artigos relacionados
Essa é a noção básica sobre como definir consultas. Para obter um índice de exemplos de consulta, consulte Referência rápida de consulta.