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

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

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

Se você não tiver Power BI Desktop, poderá baixá-la e instalá-la gratuitamente.

Siga as etapas para criar um relatório no Power BI Desktop que mostre uma tendência diária de bugs.

Pré-requisitos

Para criar um relatório do Power BI, você deve atender aos seguintes critérios:

Criar uma consulta do Power BI

Crie uma consulta do Power BI para extrair os dados do 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 consulta a seguir.

   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
   

   

5. 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} - Nome do seu projeto de equipe. Ou omita /{project} totalmente, para uma consulta entre projetos
   • {areapath} - Seu caminho de área. Formato: Projeto\Nível1\Nível2
   • {startdate} - A data para iniciar seu relatório de tendências. Formato: AAAA-MM-DDZ. Exemplo: 2022-09-01Z representa 01 de setembro de 2022. Não coloque entre aspas.

   

6. Escolha Done (Concluído ) para executar a consulta.

   Se você nunca se conectou à sua conta, o Power BI pode exigir que você se autentique. Para obter mais informações, consulte Opções de autenticação do cliente.

Expandir 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 instrução retorna um registro com potencialmente 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 permanecer no Editor do Power Query, selecione o botão expandir nas entidades que você precisa nivelar.

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

   

   Observação

   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 de 1 a 3 para todos os campos que representam entidades que precisam ser expandidas. Eles aparecem com Registro listado na coluna da tabela quando não expandidos.

Renomeie campos e consulte e, em seguida, Fechar e Aplicar

Quando terminar, você pode optar por renomear as 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. Depois de concluído, escolha Fechar e 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 de Visualização do Power BI.
2. Adicione o campo "DateValue" ao Eixo
   • Clique com o botão direito do mouse em "DateValue" e selecione "DateValue", em vez de Hierarquia de datas
3. Adicione o campo "Estado" à legenda
4. Adicione o campo "Contagem" aos Valores
   • Clique com o botão direito do mouse no campo WorkItemId e verifique se Soma está selecionado

O relatório de exemplo:

Próximas etapas

Artigos relacionados

• Visão geral de relatórios de exemplo usando consultas OData
• Construir consultas OData para Análise
• Conectar-se usando consultas do Power BI e OData
• Referência de metadados para o Azure Boards Analytics
• Relatórios de exemplo e índice de referência rápida
• Adicionar uma segmentação de equipe a um relatório existente