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

  • Artigo

Serviços de DevOps do Azure | 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 saber mais 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 na ordem das colunas do quadro Kanban.

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

Nota

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

Pré-requisitos

  • Para visualizar dados do Google Analytics e consultar o serviço, você precisa ser membro de um projeto com acesso Básico ou superior. Por padrão, todos os membros do projeto recebem permissões para consultar o Google Analytics e definir exibições do Google Analytics.
  • Para saber mais sobre outros pré-requisitos relacionados à ativação de serviços e recursos e atividades gerais de controle de dados, consulte Permissões e pré-requisitos para acessar o Google Analytics.

Consultas de amostra

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 quadro Kanban 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 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 saber mais sobre o tipo de dados de cada valor, revise os metadados fornecidos para o .EntityType

Você pode colar a consulta do Power BI listada abaixo 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/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

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.

)

Cláusula de fechamento filter() .

/groupby(

Cláusula inicial groupby() .

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

Agrupar por DateValue (usado para tendências) ColumnNamee quaisquer outras propriedades que você queira relatar. Aqui incluímos LaneName a habilitação da filtragem por raias.

aggregate($count as Count)

Agregar como contagem de itens de trabalho.

)

Cláusula de fechamento 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 Power Query Editor

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.

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

Criar o gráfico de área empilhada

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

  1. No Power BI, escolha o gráfico Área empilhada em Visualizações.

    Captura de ecrã do relatório de gráficos de Visualizações e Campos do Power BI para CFD.

  2. Adicionar DateValue ao Eixo e, em seguida, clique DateValue com o botão direito do rato e selecione DateValue, em vez de Date Hierarchy.

  3. Adicionar Count a Valores.

  4. Adicionar ColumnName à legenda.

  5. 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.

    Captura de ecrã dos Filtros do Power BI para ColumnName.

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 de colunas Kanban, 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 Kanban, execute as seguintes etapas:

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

Você pode colar a consulta do Power BI listada abaixo 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/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

Classificar o relatório na ordem correta

  1. No Power BI, expanda a consulta ColumnOrder e selecione ColumnName.

  2. Selecione Ferramentas de Coluna e, em seguida, Ordenar por Coluna e escolha ColumnOrder. Captura de ecrã das Ferramentas de Coluna do Power BI, seleção Ordenar por Coluna.

  3. 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.

    Caixa de diálogo para Gerir Relações mostrando uma relação entre CFD. ColumnName e ColumnOrder.ColumnName.

  4. No relatório criado acima, na Legenda, substitua CFD.ColumnName por ColumnOrder.ColumnName Legenda.

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

    Captura de tela do relatório de gráfico de área empilhada de Fluxo Cumulativo do Power BI de exemplo, colunas classificadas na ordem de colunas do quadro Kanban.

Nota

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