Exibir, executar ou enviar por e-mail 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 uma definição de consulta existente.

Nota

As imagens do navegador usadas neste artigo são do novo recurso de hubs de placas, que é ativado por padrão. Se esse recurso não estiver habilitado, você pode estar usando a experiência de placas anterior. Para exibir as imagens da experiência anterior, selecione a versão deste artigo do Azure DevOps Server 2022.

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 a permissão Contribuir definida como Permitir para a pasta à qual você deseja adicionar uma consulta. Por padrão, o grupo de Colaboradores não tem essa permissão.

Nota

Os usuários com acesso de partes interessadas para um projeto público têm acesso total aos recursos de consulta, assim como os usuários com acesso Básico . Para obter mais informações, veja Referência rápida sobre o acesso de Interveniente.

Consultas abertas

Browser

No seu projeto, escolha Consultas de painéis > e, em seguida, escolha Todos.

A página Consultas é aberta na guia Favoritos que lista as consultas definidas como favoritas. Você pode escolher a guia Todos para exibir todas as consultas definidas e compartilhadas para o projeto.

Gorjeta

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

Visual Studio

Importante

É altamente recomendável que todos usem o modo de exibição padrão em vez desse modo de exibição herdado. Ele foi projetado para que você acesse rapidamente uma lista de itens de trabalho com base em sua atribuição, seguimento, mencionado ou atualizações recentes. O modo de exibição herdado não está mais sendo aprimorado e esperamos removê-lo em uma versão futura do Visual Studio.

1. Na home page 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 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 para a consulta selecionada.
• Nova consulta: Abre o Editor de Consultas com as novas opções de consulta padrão.
• Abrir no Microsoft Excel (Plano): Abre a consulta no Microsoft Excel.
• Enviar para o Microsoft Outlook: Abrir
• Recortar: corta 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 aos Meus Favoritos: adiciona a consulta à seção Meus Favoritos.
• Adicionar aos Favoritos da Equipa: adiciona a consulta à secção Favoritos da Equipa.
• Segurança: Abre a caixa de diálogo Permissões para a consulta.

Executar uma consulta nos Painéis do Azure

Para executar qualquer consulta, expanda uma pasta e escolha o título da consulta. O modo de exibição é aberto para exibir os Resultados da consulta.

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

Browser

Gorjeta

A página Consultas , tal como acontece com outras páginas do portal Web, memoriza a vista para a qual foi pela última vez e devolve-o a essa vista.

1. Escolha Tudo para abrir a página onde pode ver todas as consultas que definiu ou que são partilhadas no seu projeto.

   

2. Escolha Minhas consultas conforme necessário.

   • Para ver todos os itens de trabalho atribuídos a si, selecione Atribuído a mim. Esta 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ê segue. Para obter mais informações, consulte Seguir um item de trabalho ou solicitação pull.

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

Visual Studio

Importante

É altamente recomendável que todos usem o modo de exibição padrão em vez desse modo de exibição herdado. Ele foi projetado para que você acesse rapidamente uma lista de itens de trabalho com base em sua atribuição, seguimento, mencionado ou atualizações recentes. O modo de exibição herdado não está mais sendo aprimorado e esperamos removê-lo 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 com o mouse) e escolha Exibir Resultados. Ou clique duas vezes na consulta para abri-la.

  

Executar uma consulta a partir da linha de comando

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

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

Parâmetros

• id: A ID de uma consulta existente. Necessário a menos que --path or--wiql seja especificado.
• wiql: A consulta no formato WIQL (Work Item Query Language). Ignorado se --id ou --path for especificado.
• path: O caminho de uma consulta existente. Ignorado if--id é especificado.
• org: URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URLo . Obrigatório se não estiver configurado como padrão ou coletado usando git configo . Exemplo: --org https://dev.azure.com/MyOrganizationName/.
• projeto: Nome ou ID do projeto. Você pode configurar o projeto padrão usando az devops configure -d project=NAME_OR_ID. Obrigatório se não estiver configurado como padrão ou coletado usando git configo .

Exemplo

O comando a seguir executa uma consulta com a ID especificada e mostra o resultado em 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 em 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 trilha

Nota

Não é possível adicionar pastas aos Meus Favoritos ou aos Favoritos da Equipa.

Browser

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

Quando estiver a trabalhar nas páginas Consultas , pode ir para uma pasta, subpasta ou página de consulta.

Você também pode selecionar uma consulta favorita ou retornar à página Todas as consultas no menu suspenso de uma consulta aberta.

Visual Studio

A página Itens de Trabalho exibe a mesma estrutura de pastas definida 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, consulte Gerenciar e organizar consultas

Para obter mais informações, consulte Perguntas frequentes sobre consultas, navegação e pastas.

Todas as tarefas suportadas e Favoritos

Você pode executar a maioria das tarefas para exibir e executar consultas de cada uma das páginas da lista de consultas, conforme indicado na tabela a seguir. Somente as consultas salvas em Minhas consultas e favoritas aparecem em Meus favoritos. Apenas as consultas guardadas em Consultas Partilhadas podem ser favoritas por uma equipa.

Task	Favoritos (Navegador)	Todos (Navegador)	Itens de Trabalho (Explorador de Equipa)
Veja todas as consultas favoritas, 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 )		✔️
Desmarcar uma consulta (para portal da Web, escolha )	✔️	✔️	✔️
Adicionar uma nova consulta: Escolha	✔️	✔️	✔️

Filtrar a lista de consultas

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

Para obter mais informações, consulte Perguntas frequentes sobre consultas, navegação e pastas.

Itens de consulta por e-mail ou compartilhar um URL de consulta

Browser

A partir da vista Editor de Consultas ou Resultados , pode enviar por correio eletrónico uma lista formatada de itens de consulta ou copiar o URL de consulta.

Escolha o ícone de mais ações para abrir o menu e selecione entre as opções listadas, Consulta de e-mail ou Copiar URL de consulta.

Você só pode enviar o e-mail para o endereço individual de um membro do projeto que o sistema reconheça. Não há suporte para adicionar um grupo de equipe ou grupo de segurança à linha "Para". Se adicionar uma conta de e-mail que o sistema não reconhece, receberá uma mensagem a informar que um ou mais destinatários do seu e-mail não têm permissões para ler os itens de trabalho enviados por correio.

Nota

Para enviar uma lista formatada por e-mail 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. Para o Azure DevOps local, todas as ações de email exigem que um servidor SMTP seja configurado. Se você não tiver um servidor SMTP configurado, poderá contornar isso usando Copiar como HTML.

Visual Studio

Você pode enviar por e-mail uma lista de consulta formatada escolhendo a opção Enviar para o Microsoft Outlook no menu de contexto.

Nota

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

Próximos passos

Definir uma consulta

Artigos relacionados

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