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 Colaboradores nã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.
- Por padrão, todos os membros do projeto e usuários com acesso ao Stakeholder podem exibir e executar todas as consultas compartilhadas. Você pode alterar as permissões definidas para uma pasta de consulta compartilhada ou uma consulta compartilhada. Para obter mais informações, confira Definir permissões de consulta.
- Para adicionar e salvar uma consulta em Consultas compartilhadas, você deve receber acesso Básico ou superior. Além disso, você deve ter a permissão Contribuir definida como Permitir para a pasta à qual 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 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.
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, escolha Exibir>Explorer de Equipe no menu de nível 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.
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, escolher Editar e, em seguida, escolher 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.
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.
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.
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.
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.
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.