Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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:
Selecione o botão expandir (
) em uma coluna que mostra Registro — por exemplo, Área. Selecione as propriedades desejadas (como AreaNameeAreaPath), e selecione OK.
Os campos expandidos agora aparecem como colunas separadas na tabela.
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.
Selecione o botão Expandir na coluna Descendentes e selecione os campos a serem incluídos.
Selecione todas as colunas e escolha OK.
A tabela aninhada é convertida em colunas individuais.
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.
Selecione o cabeçalho da coluna Descendants.StateCategory .
Selecione Transformar>Coluna Dinâmica.
Na caixa de diálogo Coluna Dinâmica, defina Valores para
Descendants.TotalStoryPointse selecione OK. Power BI cria uma coluna separada para cada categoria de estado (por exemplo, Proposed, InProgress, Completed).
Expanda a coluna Links
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.
Selecione o botão expandir na coluna Links e selecione todos os campos.
Selecione o botão expandir na coluna Links.TargetWorkItem e selecione as propriedades de destino desejadas (por exemplo, Título, Estado, WorkItemType).
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.
Em Editor do Power Query, selecione a guia Transform.
Selecione o cabeçalho da coluna
LeadTimeDays, depois selecione o Tipo de Dados>Número Inteiro.
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.
Selecione o cabeçalho da
CompletedDateSKcoluna.Selecione Tipo de Dados>Texto. Quando a caixa de diálogo Alterar Tipo de Coluna for exibida, selecione Adicionar nova etapa.
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.
- Selecione o cabeçalho da coluna.
- Selecione Transformar>Substituir Valores.
- Na caixa de diálogo Substituir Valores, insira
nullem Valor para Localizar e0em Substituir Por. - Selecione OK.
- 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.
Selecione Adicionar Coluna>Coluna Personalizada.
Insira
PercentCompleteo nome da nova coluna e insira a seguinte fórmula:= [Completed]/([Proposed]+[InProgress]+[Resolved]+[Completed])
Observação
Se os itens de trabalho não tiverem estados mapeados para a categoria Resolvido , omita
[Resolved]da fórmula.Selecione OK.
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.
Clique com o botão direito do mouse em um cabeçalho de coluna e selecione Renomear.
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.
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.