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

• Níveis de acesso:
  • Tenha 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.
  • Tenha acesso Básico ou superior para adicionar e salvar uma consulta compartilhada.
• Permissões: Tenha sua permissão Contribuir definida como Permitir para a pasta à qual você deseja adicionar uma consulta. Por padrão, o grupo Colaboradores não tem essa permissão definida.

• Níveis de acesso: 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 mais informações, confira 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 a permissão Contribuir definida como Permitir para a pasta à qual deseja adicionar a consulta. Por padrão, o grupo Colaboradores não tem essa permissão definida.

Você também pode executar uma consulta usando a interface de linha de comando do Azure DevOps.

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 WIQL (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