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, 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

• Você deve ter acesso ao Stakeholder para exibir e executar consultas compartilhadas. Todos os membros do projeto têm acesso ao Stakeholder por padrão. Para obter mais informações, confira Alterar as permissões para uma consulta ou pasta compartilhada.
• Você deve ter acesso Básico ou superior para adicionar e salvar uma consulta compartilhada.
• Você deve ter sua permissão de Contribuição definida como Permitir para a pasta à qual deseja adicionar uma consulta. Por padrão, o grupo Colaboradoresnão tem essa permissão.

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 navegador da Web, (1) verifique se você selecionou o projeto certo, (2) escolha Boards > Consultas e, em seguida, (3) escolha Tudo.

Se for sua primeira vez abrindo Consultas, a página será aberta em Favoritos. Esta página lista as consultas que você indicou como favoritas. Caso contrário, você pode escolher Todas para exibir todas as consultas que você definiu e consultas compartilhadas definidas 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. Escolha 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ê escolheu 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.

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

   

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 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 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 acessar uma subpasta, uma pasta ou uma página.

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

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

Você só poderá enviar o email para o endereço individual de 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 de destinatário. Se você adicionar uma conta de email que o sistema não reconhece, 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