Exibir, executar ou enviar por email uma consulta de item de trabalho

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Para localizar itens de trabalho atribuídos a você ou sua equipe, você pode executar uma consulta. Seu processo pode incluir várias consultas predefinidas que você pode acessar e executar. Muitas vezes, é mais fácil criar uma nova consulta modificando a definição de uma consulta existente.

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.

Abrir consultas

Navegador

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.

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 uma consulta no Azure Boards

Para executar qualquer consulta, expanda uma pasta e escolha o título da consulta. A exibição é aberta para mostrar a consulta Resultados.

Você também pode executar uma consulta usando a interface de linha de comando do Azure DevOps.

Navegador

Dica

A página Consultas, como acontece com outras páginas do portal da Web, lembra a exibição acessada pela última vez e leva você até ela.

1. Selecione Tudo para abrir a página em que você pode exibir todas as consultas que definiu ou que são compartilhadas em seu projeto.

   

2. Escolha Minhas Consultas conforme necessário.

   • Para exibir todos os itens de trabalho atribuídos a você, escolha Atribuído a mim. Essa consulta usa a macro @Me para listar todos os itens de trabalho atribuídos a você.
   • Para exibir todos os itens de trabalho que você está seguindo, escolha Itens de trabalho seguidos. Essa consulta usa a macro @Follows (ID em @Follows) para listar todos os itens de trabalho que você optou por seguir. Para obter mais informações, confira Seguir um item de trabalho ou uma pull request.

3. Escolha Consultas Compartilhadas para expandir a pasta e acessar consultas salvas como consultas compartilhadas.

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 do Team Explorer, 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.

  

Executar uma consulta na linha de comando

Você pode executar uma consulta na CLI com o comando az boards query. Para começar, confira Introdução à CLI do Azure DevOps.

az boards query [--id]
                [--org]
                [--path]
                [--project]
                [--wiql] 

Parâmetros

• id: s ID de uma consulta existente. Obrigatório, a menos que --path ou --wiql seja especificado.
• wiql: a consulta no formato WIQL (Work Item Query Language). É ignorado se --id ou --path for especificado.
• caminho: o caminho de uma consulta existente. Ignorado, se --id tiver sido especificado.
• org: a URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado usando git config. Exemplo: --org https://dev.azure.com/MyOrganizationName/.
• project: nome ou ID do projeto. Você pode configurar o grupo padrão usando az devops configure -d project=NAME_OR_ID. Obrigatório se não estiver configurado como padrão ou selecionado usando git config.

Exemplo

O comando a seguir executa uma consulta com a ID especificada e mostra o resultado no formato de tabela.

az boards query --id 6c286d74-26a5-4cce-bfcf-bf9123495bfe  --output table

Priority    Node Name         Work Item Type    Title                             Remaining Work
----------  ----------------  ----------------  --------------------------------  ----------------
1           Voice             Bug               Apply fix elsewhere as needed
2           CMMI              Bug               Slow response on form
1           Fiber             Bug               Check issues with permissions     0
2           Fiber             Bug               Voicemail hang issue              0
2           FabrikamBB        Bug               Research slow response time
1           FabrikamBB        Bug               Fix performance issues            0 

O comando a seguir executa uma consulta com o WIQL especificado e mostra o resultado no formato de tabela.

az boards query --wiql "SELECT [Microsoft.VSTS.Common.Priority], [System.NodeName], [System.WorkItemType], [System.Title], [Microsoft.VSTS.Scheduling.RemainingWork], [System.AssignedTo], [System.State], [System.Tags], [System.AreaPath] FROM workitems WHERE [System.WorkItemType] = 'Bug' AND [System.AreaPath] = 'Fabrikam Fiber' ORDER BY [System.WorkItemType]" --output table

Priority    Node Name       Work Item Type    Title                  Remaining Work
----------  --------------  ----------------  ----------------       ----------------
2           Fabrikam Fiber  Bug               Slow response on form
2           Fabrikam Fiber  Bug               Check permissions
2           Fabrikam Fiber  Bug               Fix performance issue
2           Fabrikam Fiber  Bug               Secure Sign-in 

Diretório de consulta, pastas de consulta e trilhas

Observação

Você não pode adicionar pastas a Meus Favoritos ou Favoritos da Equipe.

Navegador

A página Consultas contém uma guia Favoritos e Todos. Cada uma contém uma exibição focada no diretório que você pode filtrar para localizar consultas específicas de interesse.

Ao trabalhar nas páginas Consultas, você pode acessar uma pasta, subpasta, ou página de consulta.

Você também pode selecionar uma consulta favorita ou voltar para a página de consultas Todas a partir do menu suspenso de uma consulta aberta.

Visual Studio

A página Itens de Trabalho exibe a mesma estrutura de pastas conforme definido no portal da Web. As alterações feitas por meio do Visual Studio são refletidas no portal da Web.

Você pode expandir e recolher pastas, renomear pastas e arrastar e soltar consultas de uma pasta para outra. Para obter mais informações, confira Gerenciar e organizar consultas

Para obter mais informações, confira Perguntas frequentes sobre consultas, Navegar e Pastas.

Tarefas com suporte de Todos e Favoritos

Você pode realizar a maioria das tarefas para exibir e executar consultas de cada uma das páginas de lista de consultas, conforme indicado na tabela a seguir. Somente as consultas salvas em Minhas Consultas e que foram favoritadas são mostradas em Meus Favoritos. Somente as consultas salvas em Consultas Compartilhadas podem ser favoritadas por uma equipe.

Tarefa	Favoritos (Navegador)	Todos (Navegador)	Itens de trabalho (Team Explorer)
Exibir todas as consultas favoritadas, suas ou de uma equipe à qual você pertence	✔️		✔️
Exibir todas as suas consultas ou consultas compartilhadas para o projeto atual		✔️	✔️
Executar uma consulta, abrir o menu de contexto de uma consulta	✔️	✔️	✔️
Expandir ou recolher pastas de contêiner ou pastas de consulta	✔️	✔️	✔️
Filtrar a lista de consultas	✔️	✔️
Favoritar uma consulta (para o portal da Web, escolha )		✔️
Retire uma consulta dos favoritos (para o portal da Web, escolha )	✔️	✔️	✔️
Adicione uma nova consulta: Escolha	✔️	✔️	✔️

Filtrar a lista de consultas

Insira um palavra-chave na caixa de filtro para filtrar o conjunto de consultas exibidas nas páginas Favoritos ou Todos. Para saber mais sobre filtragem, confira Filtrar listas de pendências, quadros, consultas e planos.

Para obter mais informações, confira Perguntas frequentes sobre consultas, Navegar e Pastas.

Itens de consulta por email ou compartilhar uma URL de consulta

Navegador

Na exibição Editor de Consultas ou Resultados, você pode enviar por email uma lista formatada de itens de consulta ou copiar a URL da consulta.

Escolha o ícone de mais ações para abrir o menu e selecione entre as opções listadas, Enviar consulta por email ou Copiar URL da consulta.

Você só poderá enviar o email para o endereço individual de um membro do projeto que o sistema reconheça. Não há suporte para a adição de um grupo de equipe ou grupo de segurança à linha "Destinatário". Se adicionar uma conta de email que o sistema não reconheça, você receberá uma mensagem informando que um ou mais destinatários do seu email não têm permissões para ler os itens de trabalho enviados por email.

Observação

Para enviar uma lista formatada por email para pessoas que não são membros do projeto, você precisará usar a opção Copiar como HTML descrita em Copiar uma lista de itens de trabalho. No Azure DevOps local, todas as ações de email exigem que um servidor SMTP esteja configurado. Se você não tiver um servidor SMTP configurado, poderá contornar isso usando Copiar como HTML.

Visual Studio

Você pode enviar por email uma lista de consultas formatada escolhendo a opção Enviar para o Microsoft Outlook no menu de contexto.

Observação

Esse recurso exige que você tenha o Microsoft Outlook instalado. No Azure DevOps local, todas as ações de email exigem que um servidor SMTP esteja configurado. Se você não tiver um servidor SMTP configurado, poderá contornar isso usando Copiar como HTML no portal da Web.

Próximas etapas

Definir uma consulta

Artigos relacionados

• Gerenciar consultas e pastas de consulta
• Filtrar interativamente listas de pendências, quadros, consultas e planos
• Alterar opções de coluna
• Definir favoritos pessoais e de equipe
• Atalhos de teclado