Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Serviços de DevOps do Azure | Azure DevOps Server | Azure DevOps Server 2022
Visual Studio 2022
Este artigo descreve como acessar e interagir com itens de trabalho dos Painéis do Azure executando e compartilhando consultas. Você pode exibir e executar consultas internas ou compartilhadas para identificar itens de trabalho atribuídos a você ou que atendam a outros critérios.
Pré-requisitos
- Um projeto de DevOps do Azure que tem itens de trabalho atribuídos ou seguidos por você, ou consultas definidas ou compartilhadas com você. Para definir uma consulta, consulte Definir uma consulta de item de trabalho.
| Categoria | Requerimentos |
|---|---|
| Níveis de acesso | - Para visualizar e executar consultas compartilhadas: Membro do Projeto. - Para adicionar e salvar uma consulta compartilhada: Pelo menos acesso básico. |
| Permissões | permissão Contribute 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.
| Categoria | Requerimentos |
|---|---|
| Níveis de acesso | - Para visualizar e executar consultas compartilhadas: Membro do Projeto. - Para adicionar e salvar uma consulta compartilhada: Pelo menos Basic acesso. |
| Permissões | permissão Contribute 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. |
Abrir a página Consultas
Para abrir a página Consultas do seu projeto, selecione Painéis>Consultas. A página Consultas é aberta na guia Favoritos , mostrando as consultas que você ou sua equipe escolheram como favoritas. Para obter mais informações, consulte Definir favoritos pessoais ou de equipe.
A guia Favoritos também mostra as últimas consultas abertas em Continuar de onde parou.
Para ver todas as consultas pessoais e compartilhadas em seu projeto, selecione a guia Todos na página Consultas . A guia Todos mostra consultas internas, consultas que você definiu e consultas que são compartilhadas em seu projeto. Expanda Minhas Consultas, Consultas Compartilhadas e outras pastas para acessar suas consultas.
Na guia Todos da página Consultas , a pasta Minhas Consultas contém as seguintes consultas internas, além das que você define:
-
Atribuído a mim usa a
@Memacro para listar todos os itens de trabalho atribuídos a você no projeto atual. -
Itens de trabalho seguidos usa a macro @Follows ,
IDem@Follows, para listar todos os itens de trabalho que você está seguindo. Para obter mais informações, consulte Seguir um item de trabalho ou solicitação pull.
Todas as tarefas suportadas pelo separador Todos e Favoritos
Você pode executar a maioria das tarefas para exibir e executar consultas na guia Todos ou Favoritos da página Consultas , conforme indicado na tabela a seguir.
Task |
Favoritos | Todos |
|---|---|---|
| Liste todas as consultas favoritas, suas ou de uma equipe à qual você pertence | ✔️ | |
| Listar todas as suas consultas ou consultas compartilhadas para o projeto atual | ✔️ | |
| Favoritar uma consulta | ✔️ | |
| Desmarcar uma consulta de pesquisa | ✔️ | ✔️ |
| Filtrar a lista de consultas | ✔️ | ✔️ |
| Expandir ou recolher pastas | ✔️ | ✔️ |
| Executar uma consulta ou abrir o menu de contexto de uma consulta | ✔️ | ✔️ |
Somente as consultas internas e as consultas salvas em Minhas consultas aparecem em Minhas consultas. Apenas as consultas favoritas aparecem em Meus favoritos. Apenas as consultas guardadas em Consultas Partilhadas podem ser favoritas por uma equipa.
Filtrar a lista de consultas
Insira uma palavra-chave na caixa de filtro nas guias Favoritos ou Todos da página Consultas para filtrar as consultas exibidas. Para obter mais informações, consulte Filtrar interativamente listas de pendências, painéis, consultas e planos.
Navegue até consultas e pastas
Na guia Favoritos ou Todos da página Consultas , você pode navegar para localizar e abrir consultas específicas.
Na guia Tudo , as páginas de consulta podem aparecer diretamente ou estar em pastas ou subpastas. Você pode navegar até uma pasta, subpasta ou página de consulta.
À medida que se efetua seleções e abre pastas, os breadcrumbs são exibidos na parte superior da página.
Você pode selecionar uma pasta dentro do trilho de navegação e abrir a pasta.
Você também pode abrir uma consulta favorita ou retornar à página Todas as consultas no menu suspenso de uma consulta aberta.
Executar uma consulta
Para executar uma consulta a partir das guias Favoritos ou Todos da página Consultas , expanda sua pasta, se necessário, e selecione a consulta. A página Resultados da consulta é aberta.
Você também pode selecionar o ícone Mais ações ao lado da consulta na página Consultas e selecionar Executar consulta ou outras opções no menu de contexto.
Executar uma consulta a partir da CLI do Azure DevOps
Você pode executar uma consulta do Azure Boards usando o comando az boards query na interface de linha de comando do Azure DevOps. 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. Obrigatório, a menos que--pathou--wiqlseja especificado. -
wiql: A consulta no formato WIQL (Work Item Query Language). Ignorado se--idou--pathfor especificado. -
path: O caminho de uma consulta existente. Ignorado se--idfor especificado. -
org: URL da organização do Azure DevOps, como--org https://dev.azure.com/MyOrganizationName/. Obrigatório, a menos que configurado como padrão ou obtido usandogit config. Configure a organização padrão usandoaz devops configure -d organization=ORG_URL. -
project: Nome ou ID do projeto. Obrigatório se não estiver configurado como padrão ou coletado usandogit configo . Configure o projeto padrão usandoaz devops configure -d project=NAME_OR_ID.
Examples
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
O comando a seguir executa uma consulta WIQL 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] 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
Enviar por e-mail ou partilhar uma consulta
A partir do Editor de consultas ou da vista Resultados , pode enviar por correio eletrónico uma lista formatada de itens de consulta aos membros do projeto ou copiar o URL de consulta para partilhar.
Selecione o ícone Mais ações no canto superior direito e, em seguida, selecione Consulta de e-mail ou Copiar URL da consulta no menu de contexto.
Você pode enviar e-mails apenas para membros individuais do projeto que o sistema reconhece. Não há suporte para o envio para um grupo de equipe ou grupo de segurança. Os destinatários devem ter permissões para ler os itens de trabalho enviados por correio.
O email é enviado pelo cliente de email padrão e inclui um link para a consulta que retorna apenas os itens de trabalho listados. Para obter mais informações, consulte Copiar ou clonar itens de trabalho.
Nota
Para enviar uma lista formatada por e-mail para pessoas que não são membros do projeto, consulte Copiar ou enviar por e-mail uma lista de itens de trabalho.
Nota
Para o Azure DevOps local, todas as ações de email exigem que um servidor SMTP (Simple Mail Transfer Protocol) seja configurado. Se você não tiver um servidor SMTP configurado, poderá contornar esse requisito usando Copiar como HTML , conforme descrito em Copiar ou enviar por e-mail uma lista de itens de trabalho.
Exibir itens de trabalho no Visual Studio
Na página Itens de Trabalho do Visual Studio Team Explorer, você pode listar itens de trabalho para projetos conectados. A criação e o gerenciamento de consultas devem ser feitos na interface da Web dos Painéis do Azure.
No painel Pesquisa de Itens de Trabalho , você pode aplicar filtros para exibir os itens de trabalho listados por Atribuído a, Criado por, Estado ou Tipo de Item de Trabalho.
Você pode expandir a lista Itens de Trabalho e selecionar o menu suspenso ao lado da visão atual para selecionar as visões internas Atribuído a Mim, Seguindo, Mencionado ou Minha Atividade.
Para itens de trabalho individuais listados, você pode:
- Passe o cursor sobre o item de trabalho para exibir informações.
- Selecione um título de item de trabalho para renomeá-lo.
- Clique com o botão direito do mouse no item de trabalho para atribuí-lo a si mesmo ou para concluí-lo.
- Clique duas vezes no item ou clique com o botão direito do mouse e selecione Abrir para abrir o item de trabalho na interface do usuário do Azure Boards.
Você também pode criar itens de trabalho selecionando Novo Item de Trabalho e inserindo um título de item de trabalho. As alterações feitas por meio do Visual Studio são refletidas nos Painéis do Azure.