Compartilhar via


Transformar dados do Analytics para gerar relatórios Power BI

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Depois de importar dados do Analytics para o Power BI por meio de uma consulta OData ou visão do Analytics, os dados brutos geralmente precisam ser transformados antes que estejam prontos para relatórios. Os campos de entidade chegam como registros compactados, as datas podem aparecer como inteiros e os valores nulos podem comprometer os cálculos.

Este artigo aborda as transformações de Power Query mais comuns:

  • Expandir colunas de entidade (Área, AssignedTo, Iteração) e descendentes de item de trabalho vinculado
  • Transpor categorias de estado em colunas de contagem
  • Converter campos decimais ou inteiros no tipo de dados correto
  • Substituir valores nulos por zeros
  • Adicionar colunas computadas (por exemplo, porcentagem concluída)
  • Renomear colunas para legibilidade

Dica

Você pode usar a IA para ajudar nessa tarefa mais adiante neste artigo ou ver Habilitar assistência de IA com Azure DevOps MCP Server para dar início.

Pré-requisitos

Categoria Requirements
Níveis de acesso - Membro do projeto.
- Pelo menos acesso básico .
Permissões Por padrão, os membros do projeto têm permissão para consultar o Analytics e criar exibições. Para obter mais informações sobre outros pré-requisitos sobre a habilitação de serviços e recursos e atividades gerais de acompanhamento de dados, consulte Permissões e pré-requisitos para acessar o Analytics.

Expandir colunas

Quando a consulta OData usa $expand para incluir entidades relacionadas, como Area, AssignedTo ou Iteration, essas entidades chegam ao Power BI como valores Record compactados. Você deve expandir cada registro para expor seus campos individuais.

Em Editor do Power Query:

  1. Selecione o botão expandir (ícone expandir) em uma coluna que mostra Registro — por exemplo, Área. Selecione as propriedades desejadas (como AreaName e AreaPath), e selecione OK.

    Captura de tela dos dados transformados do Power BI, expanda a coluna AreaPath.

    Observação

    As propriedades disponíveis para seleção dependem de quais propriedades sua consulta solicitou. Se você não especificou as propriedades na consulta, todas as propriedades estarão disponíveis. Para obter detalhes de metadados, consulte Áreas, Iterações e Usuários.

  2. Os campos expandidos agora aparecem como colunas separadas na tabela.

    Captura de tela das colunas de área expandidas.

  3. Repita para cada coluna que exibe Record, por exemplo, AssignedTo e Iteration.

Expandir a coluna Descendentes

Se a consulta retornar itens de trabalho vinculados com dados cumulativos, a coluna Descendentes conterá uma tabela aninhada. Expanda-o para acessar campos como State e TotalStoryPoints.

  1. Selecione o botão Expandir na coluna Descendentes e selecione os campos a serem incluídos.

    Captura de tela da coluna Descendants do Power BI.

  2. Selecione todas as colunas e escolha OK.

    Screenshot da coluna Power BI Descendentes, expanda opções.

  3. A tabela aninhada é convertida em colunas individuais.

    Captura de tela da coluna Descendentes expandida no Power BI.

Pivotar a coluna Descendants.StateCategory

Depois de expandir descendentes, você pode dinamizar StateCategory para criar uma coluna por estado , útil para cálculos de porcentagem completa.

  1. Selecione o cabeçalho da coluna Descendants.StateCategory .

  2. Selecione Transformar>Coluna Dinâmica.

    Menu Transformar, opção Pivotar coluna.

  3. Na caixa de diálogo Coluna Dinâmica, defina Valores para Descendants.TotalStoryPoints e selecione OK. Power BI cria uma coluna separada para cada categoria de estado (por exemplo, Proposed, InProgress, Completed).

    Caixa de diálogo da coluna Pivot para Descendants.TotalStoryPoints.

Quando sua consulta inclui links de item de trabalho, a coluna Links contém uma tabela aninhada que você deve expandir em dois estágios.

  1. Selecione o botão expandir na coluna Links e selecione todos os campos.

    Screenshot da coluna Power BI Links, clique para expandir as opções.

  2. Selecione o botão expandir na coluna Links.TargetWorkItem e selecione as propriedades de destino desejadas (por exemplo, Título, Estado, WorkItemType).

    Captura de tela da coluna Power BI Links.TargetWorkItem, expanda as opções.

Observação

Para relações um para muitos ou muitos para muitos, ao expandir os links, cria-se várias linhas por item de trabalho de origem – uma linha para cada link. Por exemplo, se o Item de Trabalho nº 1 for vinculado aos Itens de Trabalho nº 2 e nº 3, você obterá duas linhas para o Item de Trabalho nº 1.

Transformar tipos de dados de coluna

Converter LeadTimeDays e CycleTimeDays em números inteiros

A análise retorna LeadTimeDays e CycleTimeDays como decimais (por exemplo, 10,5 por 101/2 dias). A maioria dos relatórios de tempo de lead/ciclo arredonda para o dia mais próximo; portanto, converta essas colunas em números inteiros. Valores menores que 1 se tornam 0.

  1. Em Editor do Power Query, selecione a guia Transform.

  2. Selecione o cabeçalho da coluna LeadTimeDays, depois selecione o Tipo de Dados>Número Inteiro.

    Screenshot do menu Power BI Transform, Seleção de tipo de dados.

  3. Repita para CycleTimeDays.

Converter CompletedDateSK em um campo Date

A análise armazena CompletedDateSK como um inteiro em YYYYMMDD formato (por exemplo, 20220701 para 1º de julho de 2022). Converta-o em um tipo de Data adequado em duas etapas — inteiro para texto, depois texto para data.

  1. Selecione o cabeçalho da CompletedDateSK coluna.

  2. Selecione Tipo de Dados>Texto. Quando a caixa de diálogo Alterar Tipo de Coluna for exibida, selecione Adicionar nova etapa.

    Screenshot do menu Power BI Transform, caixa de diálogo Alterar Tipo de Coluna.

  3. Com a mesma coluna ainda selecionada, selecione Data Type>Data. Na caixa de diálogo Alterar Tipo de Coluna , selecione Adicionar nova etapa novamente.

Substituir valores nulos

Campos como Pontos de História ou Trabalho Restante podem conter valores nulos quando nenhum valor foi inserido. Os nulos causam erros nos cálculos (por exemplo, uma fórmula com porcentagem completa falha se qualquer termo de denominador for nulo). Substitua-as por zero antes de criar colunas computadas.

Captura de tela da tabela do Power BI contendo valores nulos.

  1. Selecione o cabeçalho da coluna.
  2. Selecione Transformar>Substituir Valores.
  3. Na caixa de diálogo Substituir Valores, insira null em Valor para Localizar e 0 em Substituir Por.
  4. Selecione OK.
  5. Repita para cada coluna que pode conter nulos.

Criar uma coluna computada

Adicionar uma coluna de porcentagem completa

Importante

Antes de adicionar essa coluna, substitua todos os valores nulos nas colunas de estado dinâmico (consulte a seção anterior). Qualquer termo nulo faz com que a fórmula retorne um erro.

  1. Selecione Adicionar Coluna>Coluna Personalizada.

  2. Insira PercentComplete o nome da nova coluna e insira a seguinte fórmula:

    = [Completed]/([Proposed]+[InProgress]+[Resolved]+[Completed])
    

    Caixa de diálogo de coluna personalizada, sintaxe PercentComplete.

    Observação

    Se os itens de trabalho não tiverem estados mapeados para a categoria Resolvido , omita [Resolved] da fórmula.

  3. Selecione OK.

  4. Com a nova coluna selecionada, selecione Transformar>Porcentagem> de Dados.

Renomear colunas

Depois de expandir e transformar colunas, renomeie-as para que elas sejam legíveis em seus visuais de relatório.

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

    Power BI Renomear Colunas

  2. Insira um novo rótulo e pressione Enter.

Feche a consulta e aplique suas alterações

Ao concluir todas as transformações de dados, selecione Fechar &Aplicar no menu Página Inicial . Essa ação salva a consulta e retorna você para a guia Report no Power BI.

Captura de tela da opção Fechar e Aplicar no Editor do Power Query.

Usar a IA para transformar dados do Analytics no Power BI

Se você configurar o Azure DevOps servidor MCP, poderá usar assistentes de IA para escrever e otimizar consultas de tendência e instantâneo do OData para seus relatórios do Power BI Analytics usando linguagem natural.

Prompts de exemplo

Tarefa Prompt de exemplo
Tendência de erros por intervalo de datas Write an OData trend query that shows the daily bug count by state over the last 30 days in <ProjectName>.
Instantâneo de sprint Create an OData query against WorkItemSnapshot that shows work item counts grouped by date for the current sprint in <ProjectName>.
Filtrar por iteração Generate an OData trend query that uses the iteration start and end dates from <IterationName> to show story point burndown in <ProjectName>.
Tendência de coluna de painel Write an OData query against WorkItemBoardSnapshot to track work items by board column over the past two weeks in <ProjectName> in the <OrganizationName> organization.
Otimizar o desempenho My WorkItemSnapshot trend query for <ProjectName> is timing out. Suggest specific date filters and aggregation to reduce the row count without losing the key metrics.
Comparar sprints Create an OData trend query that compares bug counts between <SprintName> and the previous sprint in <ProjectName> in the <OrganizationName> organization.
Tendência de trabalho restante Write an OData trend query that shows the daily sum of remaining work grouped by Area Path for the current iteration in <ProjectName>.
Detectar alterações de estado Create an OData snapshot query that tracks how many work items moved from Active to Resolved each day over the past <NumberOfDays> days in <ProjectName>.
Análise de alteração de escopo Generate an OData trend query that shows the daily count of user stories added or removed from <SprintName> by comparing WorkItemSnapshot data in <ProjectName>.

Dica

Se você estiver usando o Visual Studio Code, agent mode é especialmente útil para criar e fazer alterações em consultas de tendência OData para relatórios do Power BI baseados em análise.