Relatório de exemplo de diagrama de fluxo cumulativo (CFD)

2025-04-07

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

Este artigo mostra como exibir o CFD de Histórias para uma equipe especificada. Esses dados também estão disponíveis através do widget de gráfico e painel integrado. Para obter mais informações sobre essas opções, consulte Exibir e configurar um diagrama de fluxo cumulativo.

Um exemplo é mostrado na imagem a seguir que mostra uma contagem de histórias de usuários ao longo do tempo nos estados Pesquisando, Comprometido, Em andamento e Em revisão . Passar o cursor sobre uma data fornece informações sobre os dados dessa data.

Captura de ecrã do relatório do gráfico de área empilhada do Fluxo Cumulativo do Power BI, colunas ordenadas por ordem de colunas do quadro.

Para obter mais informações sobre fluxo cumulativo, consulte Fluxo cumulativo, prazo de entrega e orientação de tempo de ciclo e Orientação de fluxo cumulativo, tempo de entrega e tempo de ciclo.

Nota

Este artigo pressupõe que tenha lido Visão geral dos Relatórios de Exemplo usando Consultas OData, e que tenha uma compreensão básica do Power BI.

Categoria	Requerimentos
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 Google Analytics e criar modos de exibição. 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.

Exemplos de consultas

As consultas nesta seção oferecem suporte ao retorno de dados de fluxo cumulativo para Histórias de Usuários. Essas consultas especificam o conjunto de WorkItemBoardSnapshot entidades à medida que retornam dados calculados para o conselho ao longo do tempo.

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 as suas consultas ou retornar propriedades usando qualquer um dos valores de Property em um EntityType ou valores de NavigationPropertyBinding Path disponíveis com um EntitySet. Cada EntitySet corresponde a EntityType. Para obter mais informações sobre o tipo de dados de cada valor, revise os metadados fornecidos para o correspondente EntityType.

Consulta do Power BI
Consulta OData

Copie e cole a seguinte consulta do Power BI diretamente na janela Obter Dados>Consulta em Branco. 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/WorkItemBoardSnapshot?"
        &"$apply=filter( "
            &"Team/TeamName eq '{teamname}' "
            &"and BoardName eq 'Stories'  "
            &"and DateValue ge {startdate} "
        &") "
        &"/groupby( "
            &"(DateValue,ColumnName,LaneName,State,WorkItemType,AssignedTo/UserName,Area/AreaPath),  "
            &"aggregate($count as Count) "
        &") "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Você pode usar o seguinte código de consulta OData 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/WorkItemBoardSnapshot?
        $apply=filter(
            Team/TeamName eq '{teamname}'
            and BoardName eq 'Stories' 
            and DateValue ge {startdate}
        )
        /groupby(
            (DateValue,ColumnName,LaneName,State,WorkItemType,AssignedTo/UserName,Area/AreaPath), 
            aggregate($count as Count)
        )

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

{teamname} - O nome da equipe para exibir dados CFD

{startdate} - Inicie seu relatório para itens concluídos em ou após uma determinada data com o formato: YYYY-MM-DDZ. Por exemplo: 2022-04-01Z representa 2022-abril-01. Não coloque entre aspas.

Detalhamento da consulta

A tabela a seguir descreve cada parte da consulta.

Parte da consulta

Descrição

$apply=filter(

Cláusula inicial filter() .

Team/TeamName eq '{teamname}'

Devolver itens para uma equipa específica.

and BoardName eq 'Stories'

Retorne itens na lista de pendências do Stories . Você pode especificar outros nomes de lista de pendências, como Épicos ou Recursos. Especifique o nível de lista de pendências que corresponde ao processo selecionado para o seu projeto.

and DateValue ge {startdate}

Retornar dados na ou após a data especificada, por exemplo, 2022-04-01Z representa 2022-Abril-01 2019-Julho-01.

)

Fechar filter() cláusula.

/groupby(

Cláusula inicial groupby() .

(DateValue, ColumnName, LaneName, State, WorkItemType,AssignedTo/UserName,Area/AreaPath),

Agrupar por DateValue (usado para tendências), ColumnName e quaisquer outras propriedades que gostaria de incluir no relatório. Aqui incluímos LaneName para permitir a filtragem por raias.

aggregate($count as Count)

Agregar como contagem de itens de trabalho.

)

Fechar cláusula groupby().

(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 ecrã das opções do menu de consulta do Power BI, consulta de mudança de nome.

Expandir colunas no Editor do Power Query

No Editor do Power Query, escolha a consulta com os dados que pretende transformar. Para um gráfico de CFD, você precisará expandir as Areacolunas , Iteratione AssignedTo . Para saber como, consulte as seções a seguir em Transformar dados do Analytics para gerar relatórios do Power BI, Expandir colunas.

(Opcional) Renomear campos

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

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.

Criar o gráfico de área empilhada

No exemplo a seguir, a consulta foi renomeada para CFD, mas nenhuma coluna foi renomeada.

No Power BI, escolha o gráfico Área empilhada em Visualizações.
Adicionar DateValue ao Eixo e, em seguida, clique com o botão direito do rato em DateValue e selecione DateValue, em vez de Date Hierarchy.
Adicionar Count a Valores.
Adicionar ColumnName a Legenda.
No painel Filtros, expanda ColumnNamee selecione apenas os valores que deseja que apareçam no gráfico. Por exemplo, talvez você queira desmarcar Novo, Proposto, Concluído ou Fechado.

O relatório de exemplo exibe as colunas em ordem alfabética. No entanto, a ordem preferida é classificar os dados de acordo com a ordem das colunas, ou ordem progressiva.

Captura de ecrã do relatório de gráfico de área empilhada de Fluxo Cumulativo do Power BI, colunas ordenadas por ordem alfabética.

Ordenar colunas por ordem progressiva

Para classificar as colunas do gráfico na ordem específica no quadro, execute as seguintes etapas:

Crie uma nova consulta no Power BI de acordo com as seguintes consultas. Quando terminar, renomeie a consulta para ColumnOrder.

Consulta do Power BI
Consulta OData

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/V3.0-preview/BoardLocations?"
        &"$apply=filter( "
            &"Team/TeamName eq '{teamname}'  "
            &"and BoardName eq 'Stories'  "
            &"and IsCurrent eq true "
        &") "
        &"/groupby ((ColumnName,ColumnOrder)) "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/V3.0-preview/BoardLocations?
        $apply=filter(
            Team/TeamName eq '{teamname}' 
            and BoardName eq 'Stories' 
            and IsCurrent eq true
        )
        /groupby ((ColumnName,ColumnOrder))

Classificar o relatório na ordem correta

No Power BI, expanda a consulta ColumnOrder e selecione ColumnName.
Selecione Ferramentas de Coluna e depois Ordenar por Coluna e escolha ColumnOrder.
Selecione o menu Modelagem e, em seguida , Gerenciar relacionamentos. Certifique-se de que existe uma relação entre CFD.ColumnName e ColumnOrder.ColumnName. É provável que a relação tenha sido detetada automaticamente.
No relatório criado acima, na Legenda, substitua por CFD.ColumnName LegendaColumnOrder.ColumnName.

O relatório é atualizado com colunas classificadas na mesma ordem usada pelo quadro.

Nota

Se algum item de trabalho estiver em uma coluna que já foi excluída, ele aparecerá como "Em branco" no relatório acima.

Partilhar via

Relatório de exemplo de diagrama de fluxo cumulativo (CFD)

Exemplos de consultas

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

Detalhamento da consulta

(Opcional) Renomear consulta

Expandir colunas no Editor do Power Query

(Opcional) Renomear campos

Feche a consulta e aplique as alterações

Criar o gráfico de área empilhada

Ordenar colunas por ordem progressiva

Classificar o relatório na ordem correta

Artigos relacionados

Comentários

Recursos adicionais