Partilhar via

Relatório de exemplo de pacote cumulativo 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 infantis concluídas. O relatório exibe a porcentagem concluída por acúmulo de Pontos de História 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 empilhado Progresso do recurso.

Você pode visualizar gráficos de barras de progresso semelhantes da sua lista de pendências adicionando uma coluna de rollup. Para saber como, consulte Exibir progresso ou totais do rollup.

Nota

Este artigo pressupõe que você leia Visão geral de 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 predefinição, os membros do projeto têm permissão para consultar o Analytics e criar vistas.
  • Para obter mais informações sobre outros pré-requisitos relacionados com a ativação de serviços e funcionalidades e atividades gerais de monitorização de dados, consulte Permissões e pré-requisitos para aceder ao Analytics.

Consultas de amostra

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

Nota

Para determinar as propriedades disponíveis para fins de filtro ou relatório, consulte Referência de metadados para painéis do Azure. 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 um corresponde a um EntityTypearquivo . Para obter mais informações sobre o tipo de dados de cada valor, revise 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 seguintes cadeias de caracteres por seus valores. Não inclua parênteses com a {} sua substituição. Por exemplo, se o nome da sua organização for "Fabrikam", substitua {organization} por Fabrikam, não {Fabrikam}.

  • {organization} - Nome da sua organização
  • {project} - O nome do seu projeto de equipe, ou omitir /{project} completamente, para uma consulta entre projetos
  • {areapath} - O Caminho da Sua Área. Exemplo de formato: Project/Level1/Level2.

Detalhamento da consulta

A tabela a seguir descreve cada parte da consulta.

Parte da consulta

Descrição

$filter=WorkItemType eq 'Feature'

Retornar recursos.

and State ne 'Cut'

Omitir recursos marcados como Recortar.

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

Retornar itens de trabalho em um Caminho de Área específico. A substituição 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 de expansão 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 os estados do fluxo de trabalho e as categorias de estado são usados em Listas de Pendências e Painéis.

aggregate(StoryPoints with sum as TotalStoryPoints))

Soma agregada de Pontos de História.

)

Cláusula de fechamento Descendants() .

Revisar 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 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 '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 Power Query Editor

A consulta retorna várias colunas que você precisa expandir antes de poder usá-las para criar um relatório. Qualquer entidade puxada 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 transformação de 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 pivotadas.

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

Nota

Neste exemplo, os valores de Estado para User Story incluem Proposed, In Progress e Completed.

Feche a consulta e aplique as alterações

Depois de concluir todas as suas transformações de dados, escolha Fechar & Aplicar no menu Início para salvar a consulta e retornar à guia Relatório no Power BI.

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

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

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

    Captura de ecrã do relatório de Visualizações e Campos do Power BI para o relatório de gráfico de barras empilhado Progresso de Funcionalidades.

  2. Adicionar Title ao eixo Y.

  3. Adicione 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 Progresso do recurso de exemplo.