Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Serviços de DevOps do Azure | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020
Use consultas para listar bugs, histórias de usuários ou outros itens de trabalho com base nos critérios de campo especificados. As equipes executam essas listas para fazer triagem, atualizar itens em massa ou revisar hierarquias. A pesquisa semântica oferece capacidades sobrepostas e complementares que vale a pena explorar.
Utilize consultas geridas para:
- Atualizar itens de trabalho em massa usando o portal da Web
- Triagem e atualização de itens de trabalho
- Rever uma hierarquia de itens de trabalho
- Partilhar uma lista de itens de trabalho com um colega de equipa
Você pode criar consultas e pastas de consulta do portal da Web ou do Visual Studio Team Explorer. As alterações feitas num cliente aparecem nos restantes porque todas as alterações são guardadas no armazenamento de dados de rastreio de trabalho.
Introdução ao uso de consultas
Se você estiver começando, leia Exibir, executar ou enviar por e-mail uma consulta de item de trabalho. Para obter uma referência rápida às tarefas do editor de consultas 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 de produto, uma iteração ou 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 estado ou progresso criando um gráfico circular, de colunas ou de tendências para consultas de lista simples. Para obter detalhes, consulte Gráficos.
Recursos 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.
- Gerencie os resultados da consulta e as pastas na página Resultados da Consulta.
Filtros de consultas
A tabela a seguir resume as funções de filtro de consulta suportadas por cada versão do Azure DevOps.
Nota
As consultas gerenciadas não suportam pesquisas de proximidade, mas as pesquisas semânticas. Além disso, as pesquisas semânticas suportam caracteres curinga * e você pode usar mais de um caractere ? curinga para corresponder a mais de um caractere. Para obter mais informações, consulte Pesquisa de itens de trabalho funcionais.
Função de filtro
Suporte a consultas
Versões suportadas
Pesquisas de cadeia de texto (texto único, texto com várias linhas, rich text)
As pesquisas não diferenciam maiúsculas de minúsculas.
Todas as versões
Curinga = *
Todas as versões
Encontre itens de trabalho com base em links diretos ou tipos de links topológicos/hierárquicos.
Filtrar itens de trabalho vinculados com base em MODE (sintaxe WIQL)
Todas as versões
Agrupar e aninhar cláusulas usando operadores booleanos AND e OR.
Todas as versões
Encontre itens de trabalho com base em uma correspondência de campo com um valor anterior.
Operador suportado: Was Ever Encontre itens de trabalho com base em um valor definido em uma data específica.
Operador suportado: ASOF (sintaxe WIQL)
Todas as versões
Use macros para criar consultas relativas a uma data, outras ferramentas, como caminho da área da equipe, iteração da 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 entre si.
Operadores suportados: =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field]
Todas as versões
Encontre itens de trabalho com base no facto de conterem ou não uma etiqueta.
Operadores suportados: Contains, Does Not Contain
Todas as versões
Encontre itens de trabalho com base em campos HTML/rich text vazios ou não vazios.
Operadores suportados: Is Empty, Is Not Empty
Todas as versões
Encontre um 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 opções. Separe valores com o separador de lista que corresponde às configurações regionais definidas para o computador cliente. Por exemplo, você pode usar uma vírgula (,).
Todas as versões
Encontre itens de trabalho com base no valor do campo booleano.
Todas as versões
Encontre itens de trabalho com base em palavras-chave ou frases adicionadas através da Discussão.
Todas as versões
Encontre itens de trabalho com base na coluna, raia ou status Concluído/concluído.
Todas as versões
Filtre os resultados da consulta com base em uma palavra-chave ou selecione campos.
Todas as versões
Para mover, copiar ou colar cláusulas de consulta em massa, instale e use o editor WIQL.
Macros suportadas
A tabela a seguir resume as macros de consulta ou variáveis suportadas pelas versões do Azure DevOps. Você pode usar algumas dessas macros para filtrar notificações.
Nota
Você pode usar determinadas macros somente do portal da Web. Estes incluem as macros @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity e @TeamAreas . Essas macros não são suportadas ao exportar uma consulta para o Excel, filtros de notificação ou exercidas a partir do Team Explorer ou APIs REST.
Para obter descrições mais detalhadas e links para exemplos, consulte Campos de consulta, operadores e macros.
Macro
Suporte a consultas
Versões suportadas
Encontre qualquer tipo de item de trabalho, Work Item Type=[Any], ou qualquer Estado, State=[Any].
Todas as versões
Encontre trabalho onde Identity field=logged in user.
Todas as versões
Encontre trabalho onde Date-Time field=today.
Todas as versões
Encontre trabalho definido em um ou mais projetos.
Todas as versões
Encontre o trabalho definido na iteração atual para uma equipe.
Todas as versões
Encontre o trabalho definido em +/- n da iteração atual para uma equipe.
Todas as versões
Encontrar trabalho atual usuário conectado está seguindo, ID In @Follows.
Todas as versões
Localizar itens de trabalho recentemente alterados, ID In @MyRecentActivity Consulte também Ver e adicionar itens de trabalho, página Itens de Trabalho.
Todas as versões
Encontre trabalho em que o campo data-hora selecionado esteja dentro do dia, mês, semana ou ano atual com um deslocamento para mais/menos, por exemplo: Closed Date>=@StartOfDay-7.
Todas as versões
Encontre o trabalho atribuído a um Caminho de Área ou Caminho de Iteração de uma equipe especificada, por exemplo, consulte Consulta por área ou caminho de iteração.
Todas as versões
Resultados da consulta e recursos de gerenciamento de consultas
Os recursos a seguir fornecem suporte para trabalhar com resultados de consulta, salvar e compartilhar consultas e muito mais.
-
Adicionar um gráfico de consulta a um dashboard
-
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
Funcionalidades não suportadas
As consultas suportam apenas itens de trabalho e itens de trabalho vinculados a outros itens de trabalho. As consultas gerenciadas não suportam:
- Vistas hierárquicas de Planos de Teste, Suítes de Teste e Casos de Teste (esses itens não usam links pai-filho). Em vez disso, visualize a hierarquia na página > Planos de Teste.
- Visualizações que mostram objetos associados, como compilações, lançamentos, código ou outros objetos que não são de item de trabalho.
- Listar itens de trabalho vinculados de um projeto para outro.
- Exportar uma consulta entre projetos para o Excel (consultas de links diretos são exportadas como uma lista simples).
Tipos de consulta (flat, 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 que você precisa.
Tipo de consulta
Orientações de utilização
Lista simples de itens de trabalho
- Listar itens para executar atualizações em massa
- 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 ligações diretas
- 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
- Itens de trabalho vinculados à triagem, incluindo links relacionados ao teste
- Localizar itens órfãos da lista de pendências (itens sem pai)
Nota
Itens de trabalho e consultas de links diretos exportam para o Excel como uma lista simples. O Excel importa-os como uma lista simples porque o Excel não suporta a modificação de vários tipos de ligação.
Árvore de itens de trabalho
- Listar uma árvore de itens de trabalho relacionados do tipo Pai-Filho ou outros tipos de ligação em 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 tipos de link, consulte Referência de tipo de link.
Minhas consultas, consultas compartilhadas e favoritos
Somente você pode visualizar e executar consultas salvas em Minhas consultas. Favorifique uma consulta para que ela apareça no seletor de consultas.
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 obter mais informações, consulte:
- Gerenciar consultas & pastas de consulta
- Definir permissões de consulta
- Favoritar uma consulta e Definir favoritos pessoais ou de equipa
Diretório de consulta, pastas de consulta e trilha
A página Consultas fornece os separadores Favoritos e Todos. Cada guia mostra uma exibição de diretório que você pode filtrar para encontrar consultas específicas.
Ao navegar pelas páginas Consultas , você pode abrir uma pasta, uma subpasta ou uma página de consulta.
À medida que você faz seleções, as migalhas de pão 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 retornar à página consultas todas no menu suspenso de uma consulta que esteja aberta.
Para obter mais informações, consulte Perguntas frequentes sobre consultas, navegação e pastas.
Consultar gráficos e widgets
Crie gráficos circulares, de barra, de pivô e de tendência a partir de uma consulta de lista plana (as consultas devem retornar 1000 ou menos de itens de trabalho). Adicione gráficos de consulta a painéis, renomeie-os e reconfigure-os conforme necessário.
Os 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, consulte:
- Representar um gráfico de uma consulta de lista simples
- Widget Gráfico para itens de trabalho
- Widget de resultados da consulta
- Widget de 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.
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 Itens do quadro de tarefas versus itens da lista de consultas para obter detalhes.
Consultas de pesquisa de texto completo e configurações de agrupamento
Se você usar consultas de pesquisa de texto completo com os operadores Contém ou Contém Palavras , verifique se o agrupamento do SQL Server corresponde a um idioma com um separador de palavras registrado. Idiomas não suportados podem produzir resultados inesperados.
Para obter mais informações, consulte:
API REST
Para interagir programaticamente com consultas, consulte um destes recursos da API REST:
- Referência da API REST dos Serviços de DevOps do Azure
- Consultas
- Linguagem de consulta de item de trabalho
- Buscar itens de trabalho com consultas programaticamente