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

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server | 2019 TFS 2018

Visual Studio 2022 | | Visual Studio 2019 Visual Studio 2017 | Visual Studio 2015 | Visual Studio 2013

Para localizar itens de trabalho atribuídos a você ou à sua equipe, execute uma consulta. Muitas consultas de item de trabalho são predefinidas com seu processo. Os membros da sua equipe podem ter criado consultas compartilhadas que você pode exibir e executar. Geralmente, é mais fácil definir uma nova consulta com base na definição de consulta que já está disponível para você.

Pré-requisitos

  • 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 detalhes, consulte 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 sua permissão de Contribuição definida para Permitir para a pasta à qual deseja adicionar a consulta. Por padrão, o grupo Colaboradores não tem essa permissão.

Observação

Os usuários com acesso do Stakeholder para um projeto público têm acesso total aos recursos de consulta, assim como os usuários com acesso Básico . Para obter detalhes, consulte referência rápida de acesso do Stakeholder.

  • 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 detalhes, consulte 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 sua permissão de Contribuição definida para Permitir para a pasta à qual deseja adicionar a consulta. Por padrão, o grupo Colaboradores não tem essa permissão.

Abrir consultas

No navegador da Web, (1) verifique se você selecionou o projeto certo, (2) escolha Boards> Queries e, em seguida, (3) escolha Todos.

Open Boards>Queries, vertical nav

Se for a primeira vez que você abre consultas, a página será aberta para Favoritos. Esta página lista as consultas que você indicou serem as favoritas. Caso contrário, você pode escolher Tudo para exibir todas as consultas definidas e as consultas compartilhadas definidas para o projeto.

Dica

Consultas que você ou sua equipe escolheram como favoritos aparecem na página Favoritos . Consultas favoritas junto com outros objetos também aparecem na página Project. Para saber mais, consulte Definir favoritos pessoais ou de equipe.

No navegador da Web, abra Boards> Queries.

From your web browser, open Boards>Queries

Executar uma consulta no Azure Boards

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 Azure DevOps.

Dica

A página Consultas , como em outras páginas do portal da Web, lembra a exibição que você navegou pela última vez e retorna você para essa exibição.

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

    Web portal, choose Boards>Queries>All page

  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) @Follows) para listar todos os itens de trabalho que você escolheu seguir. Para saber mais, consulte Seguir um item de trabalho ou solicitação de 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.

    Screenshot of queries breadcrumb example.

Executar uma consulta na linha de comando

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

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

Parâmetros

  • id: A ID de uma consulta existente. Obrigatório, a menos que --path ou--wiql seja especificado.
  • wiql: a consulta no formato linguagem de consulta de item de trabalho. Ignorado se--id ou --path for especificado.
  • caminho: o caminho de uma consulta existente. Ignorado se--id for especificado.
  • org: Azure DevOps URL da organização. 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/.
  • 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 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 migalhas de pão

Pastas de consulta

Observação

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

A página Consultas contém uma exibição focada em diretório que você pode filtrar para encontrar consultas específicas de interesse. Ao trabalhar nas páginas consultas , você pode navegar até uma subpasta, pasta ou página.

Queries breadcrumbs

Além disso, você pode escolher uma consulta favorita no menu seletor ou pode optar por procurar todas as consultas, o que retorna você para a página Todas as Consultas .

Screenshot of Queries, Query selector.

A página Consultas exibe a estrutura da pasta no painel esquerdo. Você pode expandir e recolher pastas, renomear pastas e arrastar e soltar consultas de uma pasta para outra. Para saber mais, consulte Gerenciar e organizar consultas.

Screenshot of Queries page, TFS 2018 and earlier versions.

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

Tarefas compatíveis com 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 têm favoritos aparecem em Meus Favoritos. Somente consultas salvas em Consultas Compartilhadas podem ser favoritas por uma equipe.


Tarefa
Favoritos
(Navegador)
Tudo
(Navegador)
Itens de trabalho
(Team Explorer)
Exibir todas as consultas favoritas, suas ou uma equipe à qual você pertence ✔️ ✔️
Exibir todas as consultas ou consultas compartilhadas para o projeto atual ✔️ ✔️
Execute uma consulta, abra o menu de contexto para uma consulta ✔️ ✔️ ✔️
Expandir ou recolher pastas de contêiner ou pastas de consulta ✔️ ✔️ ✔️
Filtrar a lista de consultas ✔️ ✔️
Favorito de uma consulta (para o portal da Web, escolha Favorite) ✔️
Desfavorite uma consulta (para o portal da Web, escolha ) ✔️ ✔️ ✔️
Adicionar uma nova consulta: Escolher ✔️ ✔️ ✔️

Filtrar a lista de consultas

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

Screenshot showing all queries in the project filtered by WIT IQ keyword criteria.

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

Itens de consulta de email ou compartilhar uma URL de consulta

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

Web portal, Query Editor/Results, Open Actions menu, Choose Email query or Copy query URL
Você só pode enviar o email para um endereço individual para um membro do projeto reconhecido pelo sistema. Não há suporte para a adição de um grupo de equipe ou grupo de segurança à linha. Se você adicionar uma conta de email que o sistema não reconhece, você receberá uma mensagem informando que um ou mais destinatários do email não têm permissões para ler os itens de trabalho enviados por email.

Observação

Para enviar por email uma lista formatada 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 Azure DevOps locais, 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.

Escolha Copiar URL de Consulta. Para enviar itens de consulta por email, consulte Copiar uma lista de itens de trabalho.

Web portal, Query Editor/Results, Copy query URL

Observação

Com a consulta email, o sistema enviará por email a lista formatada para os colegas de equipe selecionados. Para enviar por email uma lista formatada para pessoas que não fazem parte do projeto, você precisará usar a opção Copiar como HTML descrita em Copiar uma lista de itens de trabalho. 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.

Tentar o próximo