Acumular valores de item de trabalho filho para relatório de exemplo pai

Artigo
10/16/2024

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

O Rollup fornece suporte para mostrar uma contagem de itens de trabalho ou soma de Pontos de História, Trabalho Restante ou outro campo personalizado de itens filho. Este artigo fornece vários exemplos de como gerar um relatório de rollup tabular para Epics, Recursos ou Histórias de Usuário que contêm itens de trabalho filho. A imagem a seguir mostra um exemplo de Pontos de História acumulados para seus Recursos pai.

Captura de tela do relatório de matriz de acúmulo de recursos.

Para obter mais informações sobre o acúmulo cumulativo e as opções para mostrar o valor cumulativo, consulte Exibir o progresso ou os totais do acúmulo no Azure Boards.

Observação

Este artigo pressupõe que você leia Visão geral dos relatórios de exemplo usando consultas OData e tenha uma compreensão básica do Power BI.

Pré-requisitos

Acesso: ser membro de um projeto com 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 relacionados à ativação de serviços e recursos e atividades gerais de rastreamento de dados, consulte Permissões e pré-requisitos para acessar o Analytics.

Consultas de exemplo

As consultas a seguir retornam dados do WorkItems conjunto de entidades para dar suporte à geração de relatórios de matriz de acúmulo.

Observação

Para determinar as propriedades disponíveis para fins de filtro ou relatório, consulte Referência de metadados para Azure Boards. Você pode filtrar suas consultas ou retornar propriedades usando qualquer um dos Property valores em um EntityType ou NavigationPropertyBinding Path valores disponíveis com um EntitySet. Cada EntitySet corresponde a um EntityType. Para obter mais informações sobre o tipo de dados de cada valor, examine os metadados fornecidos para o EntityType.

História de Rollup Aponta para Recursos de Histórias de Usuário filho com base no Caminho da Área

Consulta do Power BI
Consulta OData

Copie e cole a seguinte consulta do Power BI diretamente na janela Obter Consulta em Branco de Dados>. Para obter mais informações, consulte Visão geral de relatórios de exemplo usando consultas OData.

let
    Source = OData.Feed("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
            &"$filter=WorkItemType eq 'Feature'"
            &" and State ne 'Cut'"
            &" and startswith(Area/AreaPath,'{areapath}')"
            &" and Descendants/any()"    
        &"& $select=WorkItemId,Title,WorkItemType,State,AreaSK"
        &"& $expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath),"        
            &"Descendants("
                &"$apply=filter(WorkItemType eq 'User Story')"
                &"/aggregate($count as CountOfUserStories, StoryPoints with sum as TotalStoryPoints)"
            &")", 
        null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4])  
in
    Source

Você pode usar o código de consulta OData a seguir para modificar ou testar a consulta antes de usá-la no Power BI. Para obter mais informações, consulte Conectar-se usando consultas do Power BI e OData.

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
    $filter=WorkItemType eq 'Feature'
        and State ne 'Cut'
        and startswith(Area/AreaPath,'{areapath}')
        and Descendants/any()
    &$select=WorkItemId,Title,WorkItemType,State,AreaSK
    &$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath),
        Descendants(
        $apply=filter(WorkItemType eq 'User Story')
        /aggregate($count as CountOfUserStories, StoryPoints with sum as TotalStoryPoints)
        )

Cadeias de caracteres de substituição e detalhamento de consulta

Substitua as cadeias de caracteres a seguir pelos valores. Não inclua colchetes {} com sua substituição. Por exemplo, se o nome da sua organização for "Fabrikam", substitua por {organization}Fabrikam, não {Fabrikam}.

{organization} - Nome da sua organização
{project} - O nome do seu projeto de equipe ou omita totalmente "/{project}" para uma consulta entre projetos
{areapath} - Seu caminho de área. Formato de exemplo: Project\Level1\Level2.

Detalhamento da consulta

A tabela a seguir descreve cada parte da consulta.

Parte da consulta

Descrição

$filter=WorkItemType eq 'Feature'

Recursos de retorno.

and State ne 'Cut'

Omita bugs fechados.

and startswith(Area/AreaPath,'{areapath}')

Retornar itens de trabalho em um Caminho de Área específico, substituindo Area/AreaPath eq '{areapath}' itens retornados em um Caminho de Área específico. Para filtrar por Nome da equipe, use a instrução Teams/any(x:x/TeamName eq '{teamname})'filter .

and Descendants/any()

Inclua todos os recursos, mesmo aqueles sem histórias de usuário. Substitua por "any(d:d/WorkItemType eq 'User Story')" para omitir recursos que não têm histórias de usuário filhas.

&$select=WorkItemId, Title, WorkItemType, State

Selecione os campos a serem retornados.

&$expand=AssignedTo($select=UserName), Iteration($select=IterationPath), Area($select=AreaPath),

Selecione campos AssignedTode propriedade expansíveis , Iteration, Area.

Descendants(

Expanda a Descendants cláusula.

$apply=filter(WorkItemType eq 'User Story')

Filtre os descendentes para incluir apenas Histórias de Usuário (omite tarefas e bugs).

/aggregate($count as CountOfUserStories, StoryPoints with sum as TotalStoryPoints)

Para todos os descendentes que correspondem à cláusula de filtro, conte-os e some a StoryPoints propriedade.

)

Feche o Descendants().

A história de rollup aponta para recursos de histórias de usuário filho com base no Teams

As consultas a seguir mostram como gerar relatórios cumulativos filtrando por nome de equipe em vez de Caminho da Área.

Consulta do Power BI
Consulta OData

let
    Source = OData.Feed("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
            &"$filter=WorkItemType eq 'Feature'"
            &" and State ne 'Cut'"
            &" and (Teams/any(x:x/TeamName eq '{teamname}) or Teams/any(x:x/TeamName eq '{teamname}) or Teams/any(x:x/TeamName eq '{teamname})"
            &" and Descendants/any()"    
        &"& $select=WorkItemId,Title,WorkItemType,State,AreaSK"
        &"& $expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath),"        
            &"Descendants("
                &"$apply=filter(WorkItemType eq 'User Story')"
                &"/aggregate($count as CountOfUserStories, StoryPoints with sum as TotalStoryPoints)"
            &")", 
        null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4])  
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
    $filter=WorkItemType eq 'Feature'
        and State ne 'Cut'
        and (Teams/any(x:x/TeamName eq '{teamname}) or Teams/any(x:x/TeamName eq '{teamname}) or Teams/any(x:x/TeamName eq '{teamname})
        and Descendants/any()
    &$select=WorkItemId,Title,WorkItemType,State,AreaSK
    &$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath),
        Descendants(
        $apply=filter(WorkItemType eq 'User Story')
        /aggregate($count as CountOfUserStories, StoryPoints with sum as TotalStoryPoints)
        )

História acumulada aponta para épicos

Você pode acumular pontos de história para Epics usando as consultas a seguir.

Power BI
OData

let
    Source = OData.Feed("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
            &"$filter=WorkItemType eq 'Epic'"
            &" and State ne 'Cut'"
            &" and startswith(Area/AreaPath,'{areapath}')"
            &" and Descendants/any(d:d/WorkItemType eq 'User Story')"    
        &"& $select=WorkItemId,Title,WorkItemType,State,AreaSK"
        &"& $expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath),"        
            &"Descendants("
                &"$apply=filter(WorkItemType eq 'User Story')"
                &"/aggregate(StoryPoints with sum as TotalStoryPoints)"
            &")", 
        null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4])  
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
    $filter=WorkItemType eq 'Epic'
        and State ne 'Cut'
        and startswith(Area/AreaPath,'{areapath}')
        and Descendants/any()
    &$select=WorkItemId,Title,WorkItemType,State,AreaSK
    &$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath),
        Descendants(
        $apply=filter(WorkItemType eq 'User Story')
        /aggregate(StoryPoints with sum as TotalStoryPoints)
        )

Tarefas de acúmulo Trabalho restante e trabalho concluído para histórias de usuário

A consulta a seguir mostra como acumular Trabalho Restante e Trabalho Concluído atribuído a Tarefas filho para Histórias de Usuário na hierarquia. Essas consultas pressupõem que as Tarefas são atribuídas como filhas de uma História de Usuário no Caminho de Área especificado.

Power BI
OData

let
    Source = OData.Feed("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
            &"$filter=WorkItemType eq 'User Story'"
            &" and State ne 'Removed'"
            &" and startswith(Area/AreaPath,'{areapath}')"
            &" and Descendants/any()"    
        &"& $select=WorkItemId,Title,WorkItemType,State,AreaSK"
        &"& $expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath),"        
            &"Descendants("
                &"$apply=filter(WorkItemType eq 'Task')"
                &"/aggregate(RemainingWork with sum as TotalRemainingWork, CompletedWork with sum as TotalCompletedWork)"
            &")", 
        null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4])  
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
    $filter=WorkItemType eq 'User Story'
        and State ne 'Removed'
        and startswith(Area/AreaPath,'{areapath}')
        and Descendants/any()
    &$select=WorkItemId,Title,WorkItemType,State,AreaSK
    &$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath),
        Descendants(
        $apply=filter(WorkItemType eq 'Task')
        /aggregate(RemainingWork with sum as TotalRemainingWork, CompletedWork with sum as TotalCompletedWork)
        )

Contagem de bugs de acúmulo para recursos

As consultas a seguir mostram como acumular a contagem de Bugs atribuídos a Recursos. Essas consultas pressupõem que os bugs são definidos como filhos de um recurso no caminho de área especificado.

Power BI
OData

let
    Source = OData.Feed("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
            &"$filter=WorkItemType eq 'Feature'"
            &" and State ne 'Removed'"
            &" and startswith(Area/AreaPath,'{areapath}')"
            &" and Descendants/any()"    
        &"& $select=WorkItemId,Title,WorkItemType,State,AreaSK"
        &"& $expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath),"        
            &"Descendants("
                &"$apply=filter(WorkItemType eq 'Bug')"
                &"/aggregate($count as CountOfBugs)"
            &")", 
        null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4])  
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
    $filter=WorkItemType eq 'Feature'
        and State ne 'Removed'
        and startswith(Area/AreaPath,'{areapath}')
        and Descendants/any()
    &$select=WorkItemId,Title,WorkItemType,State,AreaSK
    &$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath),
        Descendants(
        $apply=filter(WorkItemType eq 'Bug')
        /aggregate($count as CountOfBugs)
        )

(Opcional) Renomear consulta

Você pode renomear o rótulo de consulta padrão, Query1, para algo mais significativo. Basta inserir um novo nome no painel Configurações de Consulta .

Captura de tela das opções de menu de consulta do Power BI, renomear consulta.

Expandir colunas no Power BI

A &$expand=AssignedTo($select=UserName), Iteration($select=IterationPath), Area($select=AreaPath) cláusula retorna registros que contêm vários campos. Antes de criar o relatório, você precisa expandir o registro para nivelá-lo em campos específicos. Nesse caso, você desejará expandir os seguintes registros:

AssignedTo
AreaPath
IterationPath

Para saber como, confira Transformar dados do Analytics para gerar relatórios do Power BI.

(Opcional) Renomear campos

Depois de expandir as colunas, você pode querer renomear um ou mais campos. Por exemplo, você pode renomear a coluna AreaPath para Area Path. Para saber como, consulte Renomear campos de coluna.

Substituir valores nulos em campos cumulativos

Se um item de trabalho não tiver filhos, o valor acumulado poderá ser nulo. Por exemplo, Descendants.CountOfUserStories será "nulo" se um recurso não tiver histórias de usuário filhas.

Para facilitar a geração de relatórios, substitua todos os nulos por zero seguindo estas etapas.

Selecione a coluna clicando no cabeçalho da coluna.
Selecione o menu Transformar .
Selecione Substituir valores. A caixa de diálogo Substituir valores é exibida.
Insira "null" em Valor a ser localizado.
Digite "0" em Substituir por.
Escolha OK.

Repita o procedimento para todas as colunas de rollup.

Feche a consulta e aplique suas alterações

Depois de concluir todas as transformações de dados, escolha Fechar e Aplicar no menu Página Inicial para salvar a consulta e retornar à guia Relatório no Power BI.

Criar o relatório Tabela

No Power BI, escolha o relatório Tabela em Visualizações.
Adicione os seguintes campos a Colunas na ordem indicada:
- WorkItemI, escolha Não resumir para mostrar o ID, se necessário
- WorkItemType
- Title
- State
- Count of User Stories
- Total Story Points.

O relatório de exemplo é exibido.

Captura de tela do relatório de matriz de rollup de recursos de exemplo.

Compartilhar via

Acumular valores de item de trabalho filho para relatório de exemplo pai

Pré-requisitos

Consultas de exemplo

História de Rollup Aponta para Recursos de Histórias de Usuário filho com base no Caminho da Área

Cadeias de caracteres de substituição e detalhamento de consulta

Detalhamento da consulta

A história de rollup aponta para recursos de histórias de usuário filho com base no Teams

História acumulada aponta para épicos

Tarefas de acúmulo Trabalho restante e trabalho concluído para histórias de usuário

Contagem de bugs de acúmulo para recursos

(Opcional) Renomear consulta

Expandir colunas no Power BI

(Opcional) Renomear campos

Substituir valores nulos em campos cumulativos

Feche a consulta e aplique suas alterações

Criar o relatório Tabela

Comentários

Recursos adicionais

Compartilhar via

Acumular valores de item de trabalho filho para relatório de exemplo pai

Pré-requisitos

Consultas de exemplo

História de Rollup Aponta para Recursos de Histórias de Usuário filho com base no Caminho da Área

Cadeias de caracteres de substituição e detalhamento de consulta

Detalhamento da consulta

A história de rollup aponta para recursos de histórias de usuário filho com base no Teams

História acumulada aponta para épicos

Tarefas de acúmulo Trabalho restante e trabalho concluído para histórias de usuário

Contagem de bugs de acúmulo para recursos

(Opcional) Renomear consulta

Expandir colunas no Power BI

(Opcional) Renomear campos

Substituir valores nulos em campos cumulativos

Feche a consulta e aplique suas alterações

Criar o relatório Tabela

Artigos relacionados

Comentários

Recursos adicionais