Criar um relatório do Power BI com uma consulta OData

Serviços de DevOps do Azure | Azure DevOps Server | Azure DevOps Server 2022

Com o Power BI Desktop, você pode facilmente começar a criar relatórios para seu projeto no Azure DevOps.

Se não tiver o Power BI Desktop, faça o download e instale-o gratuitamente.

Pré-requisitos

Criar uma consulta do Power BI

Crie uma consulta do Power BI para extrair os dados para o Power BI da seguinte maneira:

1. Escolha Obter Dados e, em seguida, Consulta em Branco.

   

2. No editor de Consultas do Power BI, escolha Editor Avançado.

   

3. A janela Editor Avançado é aberta.

   

4. Substitua o conteúdo pela seguinte consulta:

   let
      The query you provided has a syntax issue due to the placement of double quotes. Specifically, the `$apply` and `$orderby` parameters should be part of the URL string, but they are not correctly concatenated. Here is the corrected version:
   
   

let
   Source = OData.Feed (
      "https://analytics.dev.azure.com/{organization}/{project}/_odata/v4.0-preview/WorkItemSnapshot?"
      &"$apply=filter("
      &"WorkItemType eq 'Bug' "
      &"AND StateCategory ne 'Completed' "
      &"AND startswith(Area/AreaPath,'{areapath}') "
      &"AND DateValue ge {startdate} )/"
      &"groupby((DateValue,State,WorkItemType,Area/AreaPath), aggregate($count as Count))"
      &"&$orderby=DateValue",
      null, [Implementation="2.0", OmitValues = ODataOmitValues.Nulls, ODataVersion = 4]
   )
in
    Source

1. Substitua seus valores na consulta de exemplo.

   A consulta de exemplo tem cadeias de caracteres que você deve substituir por seus valores:

   • {organization} - Nome da sua organização
   • {project} - O nome do seu projeto de equipa. Ou omitir /{project} completamente, para uma consulta entre projetos
   • {areapath} - O Caminho da Sua Área. Formato: Project\Level1\Level2
   • {startdate} - A data para iniciar o seu relatório de tendências. Formato: AAAA-MM-DDZ. Exemplo: 2022-09-01Z representa 2022-setembro-01. Não coloque entre aspas.

   

2. Escolha Concluído para executar a consulta.

   O Power BI pode exigir que você se autentique. Para obter mais informações, consulte Opções de autenticação de cliente.

Expandir as colunas Área, Iteração, AssignedTo

A consulta retorna várias colunas que você precisa expandir antes de poder usá-las no Power BI. Qualquer entidade extraída usando uma $expand declaração retorna um registo que pode conter vários campos. Você precisa expandir o registro para nivelar a entidade em seus campos. Exemplos de tais entidades são: AssignedTo, Iteration, e Area.

Depois de fechar o Editor Avançado e enquanto permanecer no Editor Power Query, selecione o botão de expansão nas entidades que precisa de achatar.

1. Por exemplo, escolha o botão de expansão para Área, selecione as propriedades que deseja expandir e escolha OK. Aqui, escolhemos AreaName e AreaPath para achatar. A AreaName propriedade é semelhante ao Nome de Nó.

   

   Nota

   As propriedades disponíveis a serem selecionadas dependem das propriedades solicitadas para retornar na consulta. Se você não especificar nenhuma propriedade, todas as propriedades estarão disponíveis. Para obter mais informações sobre essas propriedades, consulte as seguintes referências de metadados: Áreas, Iterações e Usuários.

2. A tabela agora contém campos de entidade.

   

3. Repita as etapas 1 a 3 para todos os campos que representam entidades que precisam ser expandidas. Esses campos aparecem com Registro listado na coluna da tabela quando não expandido.

Renomeie os campos e a consulta, e depois clique em Fechar & Aplicar

Quando terminar, você pode optar por renomear colunas.

1. Clique com o botão direito do mouse em um cabeçalho de coluna e selecione Renomear...

   

2. Você também pode querer renomear a consulta do padrão Query1 para algo mais significativo.

   

3. Uma vez feito, escolha Fechar & Aplicar para salvar a consulta e retornar ao Power BI.

   

Criar o relatório

O Power BI mostra os campos sobre os quais você pode gerar relatórios.

Para um relatório simples, execute as seguintes etapas:

1. Selecione Gráfico de Linhas do Power BI.
2. Adicionar o campo "DateValue" ao Eixo
   • Clique com o botão direito do mouse em "DateValue" e selecione "DateValue" em vez de Date Hierarchy
3. Adicionar o campo "Estado" à legenda
4. Adicionar o campo "Contagem" aos Valores
   • Clique com o botão direito no campo WorkItemId e certifique-se de que Soma está selecionada

Exemplo de relatório:

Próximos passos

Artigos relacionados

• Explore relatórios de exemplo usando consultas OData
• Construir consultas OData para o Analytics
• Conectar-se ao Power BI usando consultas OData
• Consulte os metadados do Azure Boards Analytics
• Aceda a relatórios de exemplo e índice de referência rápida
• Adicionar uma segmentação de equipe a um relatório existente