Gerir e organizar consultas no Azure Boards e Azure DevOps

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Organize suas consultas pessoais ou compartilhadas adicionando uma pasta de consulta. Em seguida, você pode adicionar consultas ou mover consultas existentes para essas pastas. Você pode criar consultas e pastas de consulta a partir do portal da Web ou de um cliente suportado, como o Visual Studio Team Explorer.

Nota

Para criar e gerenciar consultas no Visual Studio 2019, você precisa definir a experiência de itens de trabalho para a opção herdada. Além disso, você pode executar o arrastar e soltar em massa de consultas em pastas de consulta do Visual Studio, mas não do portal da Web.

Pré-requisitos

  • Você deve ter acesso de partes interessadas para exibir e executar consultas compartilhadas. Todos os membros do projeto têm acesso às partes interessadas por padrão. Para obter mais informações, consulte Alterar as permissões para uma consulta ou pasta compartilhada.
  • Você deve ter acesso Básico ou superior para adicionar e salvar uma consulta compartilhada.
  • Você deve ter sua permissão Contribuir definida como Permitir para a pasta à qual deseja adicionar uma consulta. Por padrão, o grupo de Colaboradores não tem essa permissão.

Nota

Os usuários com acesso de partes interessadas para um projeto público têm acesso total aos recursos de consulta, assim como os usuários com acesso Básico . Para obter mais informações, veja Referência rápida sobre o acesso de Interveniente.

  • Por padrão, todos os membros e usuários do projeto com acesso de partes interessadas podem exibir e executar todas as consultas compartilhadas. Você pode alterar as permissões definidas para uma pasta de consulta compartilhada ou consulta compartilhada. Para obter mais informações, consulte Definir permissões de consulta.
  • Para adicionar e guardar uma consulta em Consultas partilhadas, tem de lhe ser concedido acesso Básico ou superior. Além disso, você deve ter sua permissão Contribuir definida como Permitir para a pasta à qual deseja adicionar a consulta. Por padrão, o grupo de Colaboradores não tem essa permissão.

Abrir uma consulta

No seu navegador da Web, (1) verifique se você selecionou o projeto certo, (2) escolha Consultas de painéis >e, em seguida, (3) escolha Todos.

Consultas Open Boards>, navegação vertical

Se for a primeira vez que abre Consultas, a página abre para Favoritos. Esta página lista as consultas que indicou serem favoritas. Caso contrário, você pode escolher Todos para exibir todas as consultas definidas e compartilhadas definidas para o projeto.

Gorjeta

As consultas que você ou sua equipe escolheram como favoritas aparecem na página Favoritos . As consultas favoritas, juntamente com outros objetos, também aparecem na página do Projeto. Para obter mais informações, consulte Definir favoritos pessoais ou de equipe.

Executar, editar e salvar uma consulta

A maneira mais fácil de definir uma consulta é começar com uma consulta compartilhada existente. O exemplo a seguir mostra como localizar todos os bugs fechados modificando a consulta compartilhada Ative Bugs fornecida com o modelo de processo Agile. Os exemplos baseiam-se na interface do utilizador fornecida através do portal Web.

  1. Abra uma consulta compartilhada. Por exemplo, no portal da Web, abra o Ative Bugs ou uma consulta de lista simples semelhante.

    Executar consulta de bugs ativos

    Gorjeta

    Se você estiver trabalhando no Visual Studio Team Explorer, abra a página Trabalho para acessar suas consultas e consultas compartilhadas. Se o Team Explorer não estiver visível, escolha Exibir>Team Explorer no menu de nível superior.

  2. Edite a consulta para localizar bugs fechados e, em seguida, execute a consulta. Use Inserir nova linha de filtro para inserir uma cláusula acima da cláusula atual. Use Remover esta linha de filtro para excluir uma cláusula. As consultas têm automaticamente o escopo do projeto atual. Para localizar itens de trabalho definidos em vários projetos, consulte Consulta entre projetos.

    Portal da Web, página Consultas, nova experiência de consultas, modo Editor de uma Consulta de Lista Simples

  3. Salve a consulta na pasta Minhas Consultas .

    Caixa de diálogo de consulta Salvar como, nova experiência

    Para salvar uma consulta na pasta Consultas Compartilhadas, você precisa ser membro do grupo Administradores de Projeto ou ter suas permissões de Contribuição na pasta definidas como Permitir. Para obter mais informações, consulte Definir permissões de consulta.

Renomear ou excluir uma consulta

Na página Favoritos ou Todos, escolha o ícone de ações de uma consulta para executar, editar, renomear ou excluir a consulta.

Nova experiência de consulta, página Favoritos, menu de contexto da consulta

Para consultas compartilhadas, você também pode optar por executar uma destas tarefas:

  • Adicionar às consultas da equipe: selecione a equipe para adicionar a consulta como favorita da equipe
  • Segurança...: para definir permissões para a consulta. Para obter mais informações, consulte Definir permissões de consulta.
  • Adicionar ao painel: adiciona um widget de bloco Consulta ao painel da equipe selecionado. Para obter mais informações, consulte Adicionar widgets a um painel.

Adicionar uma pasta de consulta e mover itens para uma pasta

Gorjeta

Você precisa de permissões de Exclusão para renomear ou mover uma consulta ou pasta compartilhada e permissões de Contribuição para a pasta para a qual você move a consulta. Para exibir ou definir permissões, consulte Definir permissões em consultas e pastas de consulta.

Adicionar pastas de consulta a partir da página Consultas de painéis>>todos.

  1. Escolha Tudo. Expanda Minhas Consultas ou Consultas Compartilhadas, dependendo de onde você deseja adicionar uma pasta de consulta.

  2. Para adicionar uma pasta, escolha o ícone de ações para uma pasta existente ou a pasta de contêiner superior e escolha Nova pasta.

    Abra o menu Ações, escolha Nova pasta

  3. Digite o nome da pasta na caixa de diálogo Nova pasta. Se desejar alterar o local da pasta, selecione-a no menu suspenso Pasta.

    Introduza o nome e a localização da pasta.
  4. Para mover itens para uma pasta, arraste e solte uma consulta na pasta. No portal da Web, você só pode arrastar uma única consulta de fora de uma pasta para uma pasta.

    Opcionalmente, você pode escolher Mais comandos para uma consulta existente, escolher Editar e, em seguida, escolher Salvar como. Na caixa de diálogo Salvar consulta como, escolha a pasta na qual deseja salvar a consulta.

    Salvar consulta como caixa de diálogo

Guardar uma consulta como favorita da equipa

Para salvar uma consulta compartilhada como favorita da equipe, você deve ser um membro da equipe.

Para adicionar uma consulta a um painel, abra o menu do ícone de ações (ouícone de contexto) da consulta e adicione-o a um painel específico ou como favorito da equipe.

Partilhe consultas com a sua equipa adicionando-as a uma pasta no contentor Consultas Partilhadas . Para salvar uma consulta em uma pasta Consultas Compartilhadas, seja adicionado ao grupo Administradores de Coleção de Projetos ou tenha suas permissões definidas para uma pasta em Consultas Compartilhadas.

Você só pode adicionar consultas compartilhadas a painéis ou como favoritos da equipe e somente se tiver permissões de administrador de equipe ou administrador de projeto.

  1. Para salvar uma consulta como favorita da equipe, abra Mais ações ou o menu de contexto da consulta na página Consultas.

  2. Escolha Adicionar aos favoritos da equipe e selecione entre as equipes listadas. Apenas as equipas das quais é membro são listadas.

    Captura de ecrã da consulta Guardar como favorito da equipa.

Adicionar um bloco de consulta a um painel

Um bloco de consulta exibe uma contagem dos itens de trabalho em uma consulta. Você também pode abrir rapidamente a consulta no painel. Você pode adicionar um bloco de consulta a um painel na página Consultas usando as etapas a seguir ou seguindo as etapas descritas em Adicionar widgets a um painel.

Nota

Você só pode adicionar uma consulta compartilhada a um painel. E, para adicionar ou editar um widget de um painel de equipe, você deve ser um membro da equipe ou receber permissões para editar o painel.

  1. Para adicionar uma consulta a um painel a partir da página Consultas , abra o menu do ícone de ações (ou ícone de contexto) da consulta.

    Captura de tela do menu Mais ações, selecione Adicionar ao painel.

  2. Na caixa de diálogo Selecione um painel, escolha o painel ao qual deseja adicionar a consulta.

    Captura de ecrã da caixa de diálogo Selecionar um dashboard.

  3. Abra o painel e verifique se o bloco de consulta foi adicionado. Você pode configurar o bloco de consulta para alterar a cor padrão e especificar a cor para o bloco com base em uma regra condicional especificada.

    Captura de tela da caixa de diálogo Configurar para widget de bloco de consulta.