Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Visual Studio 2019 | Visual Studio 2022
Você pode organizar suas consultas pessoais ou compartilhadas adicionando pastas 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
As imagens a seguir exibem a interface do usuário com o recurso Novo Hub do Boards habilitado por padrão. Para obter mais informações, consulte Gerenciar ou habilitar recursos.
Pré-requisitos
| Categoria | Requisitos |
|---|---|
| Níveis de Acesso | – Para exibir e executar consultas compartilhadas: membro do projeto. – Para adicionar e salvar uma consulta compartilhada: no mínimo, acesso Básico. |
| Permissões | 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.
| Categoria | Requisitos |
|---|---|
| Níveis de Acesso | – Para exibir e executar consultas compartilhadas: membro do projeto. – Para adicionar e salvar uma consulta compartilhada: no mínimo, acesso Básico. |
| Permissões | 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. |
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.
Copiar, editar e salvar uma consulta
Você pode copiar uma consulta no mesmo projeto selecionando uma consulta e salvando-a com um novo nome usando a opção Salvar como .
Para definir uma consulta com eficiência, comece com uma consulta compartilhada existente. O exemplo a seguir mostra como localizar todos os bugs fechados modificando a consulta compartilhada bugs ativos que vem com o modelo de processo Agile. Os exemplos usam a interface 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ê trabalha 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 > o Team Explorer 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. Consultas abrangem automaticamente 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ê trabalha 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 > o Team Explorer 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. Consultas abrangem automaticamente 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
Se você desabilitar o recurso Novos Painéis de Hubs, a seleção Salvar como será exibida 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 , selecione 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 executar uma destas tarefas:
- Adicionar a consultas de equipe: selecione a equipe para adicionar a consulta como favorito da equipe
- Segurança...: defina permissões para a consulta. Para obter mais informações, confira Definir permissões de consulta.
- Adicionar ao painel: adiciona um widget de bloco de consulta ao painel 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 de permissões de Exclusão para renomear ou mover uma consulta ou pasta compartilhada e de permissões de Colaboraçã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.
Selecione Tudo. Expanda Minhas Consultas ou Consultas Compartilhadas, dependendo de onde você deseja adicionar uma pasta de consulta.
Para adicionar uma pasta, selecione o ícone de ações para uma pasta existente ou a pasta de contêiner superior e 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 selecionar Mais comandos
para uma consulta existente, selecionar Editar e, em seguida, selecionar Salvar como. Na caixa de diálogo Salvar consulta como, selecione a pasta na qual você deseja salvar a consulta.
Você adiciona pastas de consulta da página Boards > Consultas > Todas.
Selecione Tudo. 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 selecionar Mais comandos
para uma consulta existente, selecionar Editar e, em seguida, selecionar Salvar como. Na caixa de diálogo Salvar consulta como, selecione a pasta na qual você deseja salvar a consulta.
Salvar uma consulta como favorito da equipe
Para salvar uma consulta compartilhada como um favorito da equipe, você deve ser um membro da equipe.
Você pode adicionar uma consulta compartilhada aos favoritos da equipe. Você compartilha consultas com sua equipe adicionando-as a uma pasta no contêiner de 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 da página Consultas.Selecione Adicionar aos favoritos da equipe e selecione entre as equipes listadas. Somente as equipes para as quais você é membro aparecem na lista.
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.Selecione Adicionar aos favoritos da equipe e selecione entre as equipes listadas. Somente as equipes para as quais você é membro aparecem na lista.
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 painel , selecione o painel ao qual você deseja adicionar a consulta.
Abra o painel e verifique se o bloco de consulta é exibido. 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 painel , selecione o painel ao qual você deseja adicionar a consulta.
Abra o painel e verifique se o bloco de consulta é exibido. 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.