Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Use consultas para listar bugs, histórias de usuário ou outros itens de trabalho com base nos critérios de campo especificados. As equipes usam essas listas para triagem de trabalho, atualizar itens em massa ou revisar hierarquias. A pesquisa semântica oferece funcionalidades sobrepostas e complementares que vale a pena explorar.
Use consultas gerenciadas para:
- Atualizar itens de trabalho em massa usando o portal da Web
- Fazer uma triagem e atualizar itens de trabalho
- Revisar uma hierarquia de itens de trabalho
- Compartilhar uma lista de itens de trabalho com um colega de equipe
Você pode criar consultas e pastas de consulta no portal da Web ou no Visual Studio Team Explorer. As alterações feitas em um cliente aparecem nas outras porque todas as alterações são armazenadas no armazenamento de dados de acompanhamento de trabalho.
Introdução ao uso de consultas
Se você estiver começando, leia Exibir, executar ou enviar por email uma consulta de item de trabalho. Para ter uma referência rápida de consultas de tarefas do editor e consultas de exemplo, consulte Referência rápida de consulta.
- Para localizar itens de trabalho atribuídos a você, use a macro @Me como o valor do campo Atribuído a em uma cláusula.
- Todos os usuários válidos com acesso padrão podem criar consultas e pastas em Minhas Consultas. Para criar consultas ou pastas em Consultas Compartilhadas, você deve ter a permissão Contribuir. Consulte Definir permissões em consultas.
- Modifique qualquer consulta adicionando critérios para se concentrar em uma área do produto, em uma iteração ou em outro campo. Para modificar uma consulta, abra o editor de consultas.
- Abra qualquer consulta no Excel para atualizar campos e publicar alterações no banco de dados.
- Visualize o status ou o progresso criando um gráfico de pizza, coluna ou tendência para consultas de lista simples. Para obter detalhes, consulte Gráficos.
Capacidades de consulta
As seções a seguir resumem as funções que você usa para definir e gerenciar consultas de item de trabalho.
- Defina filtros de consulta com o Editor de Consultas.
- Use macros de consulta em cláusulas para direcionar campos dinamicamente.
- Gerenciar resultados e pastas de consulta na página Resultados da Consulta.
Filtros de consulta
A tabela a seguir resume as funções de filtro de consulta compatíveis com cada versão do Azure DevOps.
Observação
As consultas gerenciadas não dão suporte a pesquisas de proximidade. Entretanto, as pesquisas semânticas dão. Além disso, as pesquisas semânticas dão suporte a * e ? como caracteres curinga e você pode usar mais de um caractere curinga para corresponder a mais de um caractere. Para obter mais informações, confira Pesquisa de itens de trabalho funcional.
Função de filtro
Suporte à consulta
Versões com suporte
Pesquisas de cadeia de caracteres de texto (texto único, texto de várias linhas, rich text)
As pesquisas não diferenciam maiúsculas de minúsculas.
Todas as versões
Curinga =*
Todas as versões
Localize itens de trabalho com base em links diretos ou em tipos de link topológicos/hierárquicos.
Filtre itens de trabalho vinculados com base em MODE (sintaxe WIQL)
Todas as versões
Agrupe e aninhe cláusulas usando os operadores boolianos AND e OR.
Todas as versões
Encontre itens de trabalho com base em uma correspondência de campo com um valor anterior.
Operador com suporte: Was Ever localize itens de trabalho com base em um valor definido em uma data específica.
Operador com suporte: ASOF (sintaxe WIQL)
Todas as versões
Use macros para criar consultas em relação a uma data, outras ferramentas, como caminho da área de equipe, iteração de equipe e muito mais.
Todas as versões
Encontre itens de trabalho em um ou mais projetos em uma organização ou coleção. O padrão é o projeto atual. Use o campo Projeto de Equipe para consultar dois ou mais projetos.
Todas as versões
Encontre itens de trabalho com base em como dois campos se comparam um ao outro.
Operadores com suporte: =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field]
Todas as versões
Localize itens de trabalho que contêm ou não uma marca.
Operadores com suporte: Contains, Does Not Contain
Todas as versões
Localize itens de trabalho com campos html/rich text vazios ou não.
Operadores com suporte: Is Empty, Is Not Empty
Todas as versões
Localize trabalho cujo valor de campo corresponda a qualquer valor em um conjunto delimitado, como um conjunto de tipos de item de trabalho, estados de fluxo de trabalho ou valores de lista de seleção. 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 (,).
Todas as versões
Localize itens de trabalho com base no valor do campo booliano.
Todas as versões
Encontre itens de trabalho com base em palavras-chave ou frases adicionadas por meio da Discussão.
Todas as versões
Localize itens de trabalho com base em sua coluna, raia ou status Em execução/concluído.
Todas as versões
Filtre os resultados da consulta com base em uma palavra-chave ou campos selecionados.
Todas as versões
Para mover, copiar ou colar cláusulas de consulta em massa, instale e use o editor WIQL.
Macros compatíveis
A tabela a seguir resume as macros ou variáveis de consulta compatíveis com as versões do Azure DevOps. Você pode usar algumas dessas macros para filtrar notificações.
Observação
Você pode usar determinadas macros somente no portal da Web. Isso inclui as macros @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity e @TeamAreas. Essas macros não têm suporte ao exportar uma consulta para o Excel, filtros de notificação ou quando usadas no Team Explorer ou em APIs REST.
Para obter descrições e links mais detalhados para exemplos, consulte Campos, operadores e macros de consulta.
Macro
Suporte à consulta
Versões com suporte
Localize qualquer tipo de item de trabalho, Work Item Type=[Any], ou qualquer Estado, State=[Any].
Todas as versões
Localize trabalho em que Identity field=logged in user.
Todas as versões
Localize trabalho em que Date-Time field=today.
Todas as versões
Localize o trabalho definido em um ou mais projetos.
Todas as versões
Localize o trabalho definido na iteração atual para uma equipe.
Todas as versões
Localize o trabalho definido em +/- da iteração atual para uma equipe.
Todas as versões
Encontre o trabalho que o usuário conectado atualmente está seguindo, ID In @Follows.
Todas as versões
Encontre itens de trabalho alterados recentemente, ID In @MyRecentActivity; consulte também Exibir e adicionar itens de trabalho, página Itens de Trabalho.
Todas as versões
Localize o trabalho em que o campo de data e hora selecionado está dentro do dia, mês, semana ou ano atuais com um deslocamento de mais/menos, por exemplo: Closed Date>=@StartOfDay-7.
Todas as versões
Localize o trabalho atribuído a um Caminho de Área ou Caminho de Iteração da equipe especificada; para ver exemplos, confira Consultar por área ou caminho de iteração.
Todas as versões
Recursos de resultados da consulta e gerenciamento de consulta
Os recursos a seguir dão suporte para trabalhar com resultados de consulta, salvar e compartilhar consultas e muito mais.
-
Adicionar um gráfico de consulta a um painel
-
Aplicar filtros interativos
-
Escolher classificação de coluna
-
Escolher opções de coluna de consulta
-
Copiar resultados da consulta
-
Copiar URL de consulta
-
Criar gráficos de consulta
-
Criar pastas de consulta
Recursos sem suporte
As consultas só dão suporte a itens de trabalho e itens de trabalho vinculados a outros itens de trabalho. Consultas gerenciadas não dão suporte a:
- Exibições hierárquicas de Planos de Teste, Conjuntos de Testes e Casos de Teste (esses itens não usam links pai-filho). Em vez disso, exiba a hierarquia por meio da página Planos de Teste > .
- Exibições que mostram objetos vinculados, como builds, lançamentos, código ou outros objetos não relacionados a itens de trabalho.
- Listando itens de trabalho vinculados de um projeto para outro.
- Exportar uma consulta entre projetos para o Excel (consultas de links diretos exportam como uma lista simples).
Tipos de consulta (simples, links diretos, árvore)
O Azure Boards dá suporte a três tipos de consulta; o ícone ao lado de uma consulta indica seu tipo. Escolha o tipo com base nos resultados necessários.
Tipo de consulta
Diretriz de uso
Lista simples de itens de trabalho
- Listar itens para executar atualizações em massa
- Fazer a triagem de uma lista de itens de trabalho
- Criar um gráfico de consulta e adicioná-lo a um painel
- Criar um gráfico para contar itens ou somar um campo numérico
- Exportar uma lista para o Excel para atualizar campos
Itens de trabalho e links diretos
- Listar itens que dependem de outros itens de trabalho
- Localizar itens relacionados ou dependentes
- Listar itens de trabalho vinculados para fazer atualizações em massa
- Triagem de itens de trabalho vinculados, incluindo links relacionados a testes
- Localizar itens de pendência órfãos (itens sem pai)
Observação
Consultas de links diretos e itens de trabalho são exportadas para o Excel como uma lista simples. O Excel os importa como uma lista simples porque o Excel não dá suporte à modificação de vários tipos de link.
Árvore de itens de trabalho
- Listar uma árvore de itens de trabalho relacionados pai-filho ou outros tipos de links de topologia de árvore
- Triagem de listas hierárquicas de itens de trabalho
- Exportar uma lista hierárquica para o Excel para atualizar campos ou modificar a hierarquia
Para saber mais sobre os tipos de link, confira Referência de tipos de link.
Minhas Consultas, Consultas Compartilhadas e Favoritos
Somente você pode exibir e executar consultas salvas em Minhas Consultas. Favoritar uma consulta para que ela apareça no seletor de consulta.
As consultas salvas em Consultas Compartilhadas são visíveis para todos com acesso ao projeto. Organize consultas compartilhadas em pastas e favorite-as para acesso rápido. Você pode definir permissões em pastas e consultas para impedir que outras pessoas as movam ou editem.
Para saber mais, veja:
- Gerenciar consultas e pastas de consulta
- Definir permissões de consulta
- Marcar uma consulta como favoritos e Definir favoritos pessoais ou da equipe
Diretório de consulta, pastas de consulta e trilhas de navegação
A página Consultas fornece as guias Favoritos e Todos. Cada guia mostra uma exibição de diretório que você pode filtrar para localizar consultas específicas.
Ao navegar pelas páginas de Consultas , você pode abrir uma pasta, uma subpasta ou uma página de consulta.
À medida que você faz seleções, os breadcrumbs aparecem na parte superior da página. Use-os para navegar até uma pasta, subpasta ou página de consulta.
Você também pode selecionar uma consulta favorita ou voltar para a página de consultas Todas a partir do menu suspenso de uma consulta aberta.
Para obter mais informações, confira Perguntas frequentes sobre consultas, Navegar e Pastas.
Consultar gráficos e widgets
Crie gráficos de barra, setores, pivô e tendência a partir de uma consulta de lista plana (as consultas devem retornar 1000 ou menos itens de trabalho). Adicione gráficos de consulta aos dashboards, renomeie-os e reconfigure-os conforme for necessário.
Widgets baseados em consulta exibem informações de consulta em um painel (por exemplo, número de bugs ativos ou uma lista interativa de itens de trabalho). Para saber mais, confira:
- Definir uma consulta de lista simples
- Widget de gráfico para itens de trabalho
- Widget de resultados da consulta
- Widget do bloco de consulta
Adicionar um campo personalizado para dar suporte a consultas
Para adicionar um campo personalizado para consultas, consulte Personalizar sua experiência de acompanhamento de trabalho.
Itens do quadro de tarefas versus itens da lista de consultas
Se o conteúdo do quadro de tarefas for diferente dos resultados de uma consulta criada, consulte os itens do Quadro de Tarefas versus itens da lista de consultas para obter detalhes.
Consultas de pesquisa de texto completo e configurações de ordenação
Se você usar consultas de pesquisa de texto completo com os operadores Contains ou Contains Words , verifique se a ordenação do SQL Server corresponde a um idioma com um separador de palavras registrado. Idiomas sem suporte podem produzir resultados inesperados.
Para saber mais, veja:
API REST
Para interagir programaticamente com consultas, confira um destes recursos da API REST:
- Referência da API REST do Azure DevOps Services
- Consultas
- Linguagem de consulta de item de trabalho
- Buscar itens de trabalho com consultas programaticamente