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.
Observação
As imagens do navegador usadas neste artigo são do recurso Novos Hubs de Quadros, que é ativado por padrão. Se esse recurso não estiver ativado, você pode estar usando a experiência anterior de painéis. Para exibir as imagens da experiência anterior, selecione a versão Azure DevOps Server 2022 deste artigo.
Pré-requisitos
- Níveis de acesso:
- Para exibir e executar consultas compartilhadas, seja um membro do projeto.
- Para adicionar e salvar uma consulta compartilhada, tenha pelo menos acesso básico .
- Permissões: Tenha sua permissão Contribuir definida como Permitir para a pasta à qual você deseja adicionar uma consulta. Por padrão, o grupo Colaboradores não tem essa permissão definida.
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.
- Níveis de acesso:
- Para exibir e executar consultas compartilhadas, seja um membro do projeto.
- Para adicionar e salvar uma consulta compartilhada, tenha pelo menos acesso básico .
- Permissões: defina sua permissão de Contribuição como Permitir para a pasta à qual você deseja adicionar a consulta. Por padrão, o grupo Colaboradores não tem essa permissão definida.
Abrir uma consulta
No navegador da Web, (1) verifique se você selecionou o projeto correto, (2) selecione Boards > Consultas, e (3) selecione Todas.
A página Consultas é aberta na guia Favoritos que lista as consultas definidas como favoritas. Você pode selecionar a guia Todas para exibir todas as consultas que você definiu e consultas compartilhadas 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.
No projeto, selecione Boards > Consultas e então selecione Todas.
A página Consultas é aberta na guia Favoritos que lista as consultas definidas como favoritas. Você pode selecionar a guia Todas para exibir todas as consultas que você definiu e consultas compartilhadas 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.
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.
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, selecione Exibir>Team Explorer no menu superior.
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.
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.
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, selecione Exibir > Team Explorer no menu superior.
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.
Selecione Salvar como no menu Mais ações
.Observação
Quando o recurso Novos Hubs de Painéis não está habilitado, a seleção Salvar como fica na parte superior da página.
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.
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.
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.
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.
Você adiciona pastas de consulta da página Boards > Consultas > Todas.
Escolha Todas. Expanda Minhas Consultas ou Consultas Compartilhadas, dependendo de onde você deseja adicionar uma pasta de consulta.
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.
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.
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, escolha Editar e depois escolha Salvar como. Na caixa de diálogo Salvar consulta como, escolha a pasta na qual você deseja salvar a consulta.
Você adiciona pastas de consulta da página Boards > Consultas > Todas.
Escolha Todas. Expanda Minhas Consultas ou Consultas Compartilhadas, dependendo de onde você deseja adicionar uma pasta de consulta.
Para adicionar uma pasta, selecione Nova pasta.
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.
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, escolha Editar e depois escolha Salvar como. Na caixa de diálogo Salvar consulta como, escolha a pasta na qual você deseja salvar a consulta.
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.
Você pode adicionar uma consulta compartilhada aos favoritos 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 como favoritos da equipe se tiver permissões de administrador de equipe ou administrador de projeto.
Para salvar uma consulta como favorito da equipe, abra Mais ações
ou o menu de contexto 
da consulta na página Consultas.Escolha Adicionar aos favoritos da equipe e selecione entre as equipes listadas. Somente as equipes das quais você é membro são listadas.
Para salvar uma consulta como favorito da equipe, abra o menu de contexto Mais ações
da consulta nas Consultas compartilhadas na página Consultas.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ê deve ser membro da equipe ou ter permissões para editar o painel.
Para adicionar uma consulta a um painel na página Queries, abra o ícone de ações do menu Mais ações menu
(ou ícone de contexto ) da consulta.
Na caixa de diálogo Selecionar um dashboard, escolha o dashboard ao qual deseja adicionar a consulta.
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.
Para adicionar uma consulta a um painel na página Consultas, abra o menu Mais ações
da consulta.
Na caixa de diálogo Selecionar um dashboard, escolha o dashboard ao qual deseja adicionar a consulta.
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.