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, execute uma consulta. Muitas consultas de item de trabalho são predefinidas com o seu processo. Os membros da sua equipa podem ter criado consultas partilhadas que pode ver e executar. Muitas vezes, é 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 de partes interessadas para exibir 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.
- Você deve ter acesso Básico ou superior para adicionar e salvar uma consulta compartilhada.
- Você deve ter sua permissão Contribuir definida como Permitir para a pasta à qual 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.
- Por padrão, todos os membros e usuários do projeto 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.
- Para adicionar e guardar uma consulta em Consultas partilhadas, tem de lhe ser concedido 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.
Se for a primeira vez que abre Consultas, a página abre para Favoritos. Esta página lista as consultas que indicou serem favoritas. Caso contrário, você pode escolher Todos para exibir todas as consultas definidas e compartilhadas definidas 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.
Escolha Tudo para abrir a página onde pode ver todas as consultas que definiu ou que são partilhadas no seu projeto.
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.
Escolha Consultas compartilhadas para expandir a pasta e acessar consultas salvas como consultas compartilhadas.
Escolha uma pasta dentro de uma trilha para abrir uma pasta de consulta.
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 de linguagem de consulta de item de trabalho. 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_URL
o . Obrigatório se não estiver configurado como padrão ou coletado usandogit config
o . 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 usandogit config
o .
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 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 subpasta, pasta ou página.
Além disso, você pode escolher uma consulta que você favorito no menu seletor ou, você pode optar por procurar todas as consultas, o que retorna à página Todas as 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
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.
Você só pode enviar o e-mail para o endereço individual de um membro do projeto que seja reconhecido pelo sistema. 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.