Partilhar via


Exibir, executar ou enviar por e-mail uma consulta de item de trabalho

Serviços de DevOps do Azure | 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:
    • Tenha acesso às partes interessadas para visualizar e executar consultas compartilhadas. Todos os membros do projeto têm acesso às partes interessadas por padrão. Para obter mais informações, consulte Alterar as permissões para uma consulta ou pasta compartilhada.
    • Ter acesso Básico ou superior para adicionar e salvar uma consulta compartilhada.
  • 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.

  • Níveis de acesso: Por padrão, todos os membros do projeto e usuários com acesso de partes interessadas podem exibir e executar todas as consultas compartilhadas. Você pode alterar as permissões definidas para uma pasta de consulta compartilhada ou consulta compartilhada. Para obter mais informações, consulte Definir permissões de consulta.
  • Permissões: para adicionar e salvar uma consulta em Consultas compartilhadas, você deve receber acesso Básico ou superior. Além disso, você deve ter sua permissão Contribuir definida como Permitir para a pasta à qual deseja adicionar a consulta. Por padrão, o grupo de Colaboradores não tem essa permissão.

Consultas abertas

No seu navegador da Web, (1) verifique se você selecionou o projeto certo, (2) escolha Consultas de painéis > e, em seguida, (3) escolha Todos.

Captura de ecrã da página de consultas.

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.

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

Captura de ecrã da página de consultas.

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.

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.

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 você pode exibir todas as consultas que você definiu ou são compartilhadas dentro do seu projeto.

    Captura de ecrã da vista de todas as consultas.

  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. Esta consulta usa a macro @Follows (ID in @Follows) para listar todos os itens de trabalho que você escolheu seguir. 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.

  4. Escolha uma pasta dentro de uma trilha para abrir uma pasta de consulta.

    Captura de tela do exemplo de trilha de consultas.

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.

    Captura de ecrã da vista de todas as consultas.

  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.

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.

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.

Captura de ecrã da página de consultas.

À medida que você faz seleções, as migalhas de pão são mostradas na parte superior da página. Você pode navegar até uma pasta, subpasta ou página de consulta.

Captura de ecrã de pão ralado na 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.

Captura de ecrã da lista pendente de consulta.

Captura de ecrã do menu pendente de navegação da consulta.

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 Favorito) ✔️
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.

Captura de tela mostrando todas as consultas no projeto filtradas por um critério de palavra-chave.

Captura de tela mostrando todas as consultas no projeto filtradas por um critério de palavra-chave.

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

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 ações para abrir o menu e selecione entre as opções listadas, Consulta de e-mail ou Copiar URL de consulta.

Captura de ecrã de Escolher consulta de e-mail ou Copiar 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.

Captura de ecrã de Escolher 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.

Próximos passos