Gerenciar e organizar consultas no Azure Boards e no Azure DevOps

Azure DevOps Services | 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 consultas do portal da Web ou de um cliente com suporte, como o Team Explorer do Visual Studio.

Observação

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

Pré-requisitos

• Você deve ter acesso ao Stakeholder para exibir e executar consultas compartilhadas. Todos os membros do projeto têm acesso ao Stakeholder por padrão. Para obter mais informações, confira 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 de Contribuição definida como Permitir para a pasta à qual deseja adicionar uma consulta. Por padrão, o grupo Colaboradoresnão tem essa permissão.

Observação

Os usuários com acesso de Stakeholders para um projeto público têm acesso completo aos recursos de consultas, assim como os usuários com acesso Básico. Para mais informações, veja Referência rápida de acesso das partes interessadas.

Abrir uma consulta

Navegador

No navegador da Web, (1) verifique se você selecionou o projeto certo, (2) escolha Boards > Consultas e, em seguida, (3) escolha Tudo.

Se for sua primeira vez abrindo Consultas, a página será aberta em Favoritos. Esta página lista as consultas que você indicou como favoritas. Caso contrário, você pode escolher Todas para exibir todas as consultas que você definiu e consultas compartilhadas definidas para o projeto.

Dica

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 Projeto. Para obter mais informações, confira Definir favoritos pessoais ou de equipe.

Visual Studio

Importante

É altamente recomendável que todos usem a exibição padrão em vez dessa exibição herdada. Ele foi projetado para acessar rapidamente uma lista de itens de trabalho com base em sua atribuição, seguidores, menções ou atualizações recentes. A exibição herdada não está mais sendo aprimorada e esperamos removê-la em uma versão futura do Visual Studio.

1. Na página inicial do Team Explorer, escolha Itens de Trabalho.

   

2. Para abrir uma consulta, abra o menu de contexto da consulta (clique com o botão direito do mouse) e escolha Exibir Resultados. Ou clique duas vezes na consulta para abri-la.

   

Ou, selecione uma das seguintes opções:

• Editar Consulta: abre o Editor de Consultas na consulta selecionada.
• Nova Consulta: abre o Editor de Consultas com as novas opções de consulta padrão.
• Abrir no Microsoft Excel (Simples): abre a consulta no Microsoft Excel.
• Enviar para o Microsoft Outlook: abre
• Recortar: recorta a consulta. Em seguida, você pode colar a consulta em uma pasta diferente.
• Copiar: copia a consulta. Em seguida, você pode colar a consulta na mesma pasta ou em uma pasta diferente.
• Excluir: exclui a consulta.
• Renomear: permite renomear a consulta.
• Adicionar a Meus Favoritos: adiciona a consulta à seção Meus Favoritos.
• Adicionar aos Favoritos da Equipe: adiciona a consulta à seção Favoritos da Equipe.
• Segurança: abre a caixa de diálogo Permissões para a consulta.

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 Bugs Ativos fornecida com o modelo de processo Agile. Os exemplos são baseados na interface do usuário fornecida por meio do portal da Web.

Navegador

1. Abra uma consulta compartilhada. Por exemplo, no portal da Web, abra Bugs Ativos ou uma consulta de lista plana semelhante.

   

   Dica

   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>Explorer de Equipe no menu de nível superior.

2. Edite a consulta para localizar bugs fechados e execute a consulta. Use para inserir uma cláusula acima da cláusula atual. Use para excluir uma cláusula. As consultas são definidas automaticamente para o projeto atual. Para localizar itens de trabalho definidos em vários projetos, confira Consulta entre projetos.

   

3. Salve a consulta na pasta Minhas Consultas.

   

   Para salvar uma consulta na pasta Consultas Compartilhadas, você precisa ser um membro do Grupo Administradores de Projeto ou ter suas permissões de Contribuir na pasta definidas como Permitir. Para obter mais informações, confira Definir permissões de consulta.

Visual Studio

Importante

É altamente recomendável que todos usem a exibição padrão em vez dessa exibição herdada. Ele foi projetado para acessar rapidamente uma lista de itens de trabalho com base em sua atribuição, seguidores, menções ou atualizações recentes. A exibição herdada não está mais sendo aprimorada e esperamos removê-la em uma versão futura do Visual Studio.

Para salvar uma consulta como uma nova consulta, abra os resultados da consulta e, na barra de ferramentas, escolha Arquivo>Salvar QueryName Como....

Especifique o nome do arquivo e o local da pasta a serem usados para salvar a consulta.

Para salvar a consulta como um arquivo .wiq, escolha o botão de opção Arquivo e especifique o local do arquivo.

Renomear ou excluir uma consulta

Navegador

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

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

• Adicionar a consultas de equipe: selecione a equipe para adicionar a consulta como favorito da equipe
• Segurança...: para definir permissões para a consulta. Para obter mais informações, confira Definir permissões de consulta.
• Adicionar a dashboard: adiciona um widget de bloco de consulta ao dashboard da equipe que você selecionar. Para obter mais informações, confira Adicionar widgets a um painel.

Visual Studio

Importante

É altamente recomendável que todos usem a exibição padrão em vez dessa exibição herdada. Ele foi projetado para acessar rapidamente uma lista de itens de trabalho com base em sua atribuição, seguidores, menções ou atualizações recentes. A exibição herdada não está mais sendo aprimorada e esperamos removê-la em uma versão futura do Visual Studio.

Na página Itens de Trabalho, abra o menu de contexto da consulta que você deseja executar, editar, renomear ou excluir e escolha a opção correspondente.

Adicionar uma pasta de consulta e mover itens para uma pasta

Dica

Você precisa Excluir permissões 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, confira Definir permissões em consultas e pastas de consulta.

Navegador

Você adiciona pastas de consulta da página Boards>Consultas>Todas.

1. Escolha Todas. 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.

   

3. Insira o nome da pasta na caixa de diálogo Nova pasta. Se você quiser alterar o local da pasta, selecione-a no menu suspenso 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 escolha Salvar como. Na caixa de diálogo Salvar consulta como, escolha a pasta na qual você deseja salvar a consulta.

   

Visual Studio

Importante

É altamente recomendável que todos usem a exibição padrão em vez dessa exibição herdada. Ele foi projetado para acessar rapidamente uma lista de itens de trabalho com base em sua atribuição, seguidores, menções ou atualizações recentes. A exibição herdada não está mais sendo aprimorada e esperamos removê-la em uma versão futura do Visual Studio.

Todas as alterações feitas na estrutura da pasta de consulta no Visual Studio aparecem no portal da Web atualizando seu navegador.

1. Na página Itens de Trabalho, abra o menu de contexto Minhas Consultas, Consultas de Equipe ou uma pasta de consulta existente e escolha Nova Pasta.

   

   Uma Nova Pasta é adicionada na área selecionada. Selecione a pasta para renomeá-la.

2. Para mover consultas para uma pasta, arraste e solte uma consulta na pasta. Você pode selecionar várias consultas e arrastá-las para uma pasta ou de uma pasta para outra.

Salvar uma consulta como favorito da equipe

Para salvar uma consulta compartilhada como uma das favoritas da equipe, você deverá ser um membro da equipe.

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

Compartilhe consultas com sua equipe adicionando-as a uma pasta no contêiner Consultas Compartilhadas. 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 dashboards 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 favorito 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. Somente as equipes das quais você é membro são listadas.

   

Adicionar um bloco de consulta a um dashboard

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

Observação

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

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

   

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

   

3. Abra o dashboard 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 do bloco com base em uma regra condicional especificada.

   

Artigos relacionados

• Perguntas frequentes sobre consultas
• Definir permissões de consulta
• Atalhos de teclado
• Alterar permissões no nível do projeto