Compartilhar via

Relatório de exemplo de rollup de progresso de recursos

  • Artigo

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

Este artigo mostra como criar um relatório de barras empilhadas para exibir o progresso dos recursos com base em histórias de usuário filho concluídas. O relatório exibe a porcentagem concluída por rollup de Story Points para um determinado conjunto de recursos ativos. Um exemplo é mostrado na imagem a seguir.

Captura de tela do relatório de gráfico de barras empilhadas do Progresso do recurso.

Você pode exibir gráficos de barras de progresso semelhantes em sua lista de pendências adicionando uma coluna de acúmulo. Para saber como, consulte Exibir o progresso ou os totais acumulados.

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

Consultas de exemplo

O progresso do recurso consulta a WorkItems entidade para obter o estado atual do progresso.

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.

Revisar o progresso do recurso com base em um caminho de área

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 'Removed' "
            &"and startswith(Area/AreaPath,'{areapath}') "
            &"and Descendants/any()"
            &"&$select=WorkItemId,Title,Area,Iteration,AssignedTo,WorkItemType,State,AreaSK"
            &"&$expand=Descendants( "
            &"$apply=filter(WorkItemType eq 'User Story') " 
                &"/groupby((StateCategory), "
                &"aggregate(StoryPoints with sum as TotalStoryPoints)) "
            &")  "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

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 /{project} totalmente, 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 recursos marcados como Corte.

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

Retorne itens de trabalho em um Caminho de Área específico. Substituir por Area/AreaPath eq '{areapath}' retorna itens 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()

Filtre todos os itens de trabalho que tenham pelo menos um ou "qualquer" descendente. Inclui todos os recursos com pelo menos um item de trabalho filho. Para obter todos os itens de trabalho com seus descendentes, mesmo que eles não tenham nenhum, execute uma consulta sem o Descendants/any() filtro. Para omitir Recursos que não têm Histórias de Usuário filhas, substitua por any(d:d/WorkItemType eq 'User Story').

Para todos os itens de trabalho com e sem descendentes:

$filter=endswith(Area/AreaPath,'suffix')
&$select=WorkItemId,Title,WorkItemType,State,Area, Descendants
&$expand=Descendants($select=WorkItemId)

Para todos os itens de trabalho com pelo menos um descendente:

$filter=endswith(Area/AreaPath, 'suffix')and Descendants/any()
&$select=WorkItemId,Title,WorkItemType,State,Area, Descendants
&$expand=Descendants($select=WorkItemId)

&$select=WorkItemId, Title, WorkItemType, State

Selecione as propriedades a serem retornadas.

&$expand=Descendants(

Início da cláusula expand Descendants

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

Filtre os descendentes. Inclua apenas histórias de usuário (omita tarefas e bugs).

/groupby((StateCategory),

Agrupe o pacote cumulativo por StateCategory. Para obter mais informações sobre Categorias de Estado, consulte Como estados de fluxo de trabalho e categorias de estado são usados em Listas de pendências e quadros.

aggregate(StoryPoints with sum as TotalStoryPoints))

Soma agregada de Pontos de História.

)

Cláusula de fechamento Descendants() .

Examinar o progresso do recurso para uma equipe

A consulta a seguir é a mesma usada acima, exceto que filtra por Nome da Equipe em vez de Caminho da Área.

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 (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=Descendants( "
            &"$apply=filter(WorkItemType eq 'User Story') "
                &"/groupby((StateCategory), "
                &"aggregate(StoryPoints with sum as TotalStoryPoints)) "
            &")  "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Transformar os dados no Editor do Power Query

A consulta retorna várias colunas que você precisa expandir antes de usá-las para criar um relatório. Qualquer entidade extraída usando uma instrução OData $expand retorna um registro com potencialmente vários campos. Expanda o registro para nivelar a entidade em seus campos.

Para o relatório de Progresso do Recurso, você precisará realizar as seguintes transformações:

  • Expanda a Descendants coluna em duas colunas: Descendants.StateCategory e Descendants.TotalStoryPoints
  • Aplicar a transformação Coluna Dinâmica na Descendants.StateCategory coluna para separar categorias de Estado individuais
  • Substitua valores nulos em todas as colunas dinâmicas.
  • Adicione uma coluna personalizada para representar a porcentagem concluída. A coluna personalizada exibirá erros se houver colunas nulas nas colunas de estado dinamizado.

Para saber como, confira as seguintes seções em Transformar dados do Analytics para gerar relatórios do Power BI:

Observação

Neste exemplo, os valores de Estado para História do Usuário incluem Proposto, Em Andamento e Concluído.

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.

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

Criar o relatório de gráfico de barras empilhadas

  1. No Power BI, escolha Relatório de gráfico de barras empilhadas em Visualizações.

    Captura de tela das seleções de Visualizações e Campos do Power BI para o relatório de gráfico de barras empilhadas Progresso do Recurso.

  2. Adicione Title ao Eixo Y.

  3. Adicionar PercentComplete ao eixo X, clique com o botão direito do mouse e selecione Soma.

O relatório de exemplo é exibido.

Captura de tela do relatório de gráfico de barras empilhadas de progresso do recurso de amostra.