Compartilhar via


Relatório de exemplo do CFD (Diagrama de Fluxo Cumulativo)

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Este artigo mostra como exibir o CFD de histórias para uma equipe especificada. Você também pode acessar esses dados por meio do gráfico interno e do widget do painel. Para obter mais informações sobre essas opções, consulte Exibir e configurar um diagrama de fluxo cumulativo.

A imagem a seguir mostra um exemplo que exibe uma contagem de histórias de usuários ao longo do tempo nos estados Pesquisando, Confirmados, Em Andamento e Em Revisão . Ao passar o mouse sobre uma data, você verá informações sobre os dados dessa data.

Captura de tela de um relatório de gráfico de áreas empilhadas de Fluxo Cumulativo do Power BI, com colunas classificadas na ordem dos quadros.

Para obter mais informações sobre o fluxo cumulativo, consulte o fluxo cumulativo, o tempo de entrega e as diretrizes de tempo de ciclo.

Observação

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

Categoria Requirements
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 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 nesta seção dão suporte ao retorno de dados de fluxo cumulativo para Histórias de Usuário. Essas consultas especificam o conjunto de entidades WorkItemBoardSnapshot à medida que retornam dados calculados para o painel ao longo do tempo.

Observação

Para localizar as propriedades disponíveis para filtragem ou relatório, consulte a referência Metadata para Azure Boards. Você pode filtrar consultas ou retornar propriedades usando qualquer valor Property definido em um EntityType ou qualquer valor NavigationPropertyBinding Path listado para um EntitySet. Cada EntitySet mapeia para um EntityType, que documenta o tipo de dados de cada propriedade.

Copie e cole a consulta Power BI a seguir diretamente na janela Get Data>Blank Query. 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 cadeias de caracteres a seguir por seus valores. Não inclua as chaves {} na 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 omita totalmente "/{project}" para uma consulta entre projetos
  • {teamname} - O nome da equipe para exibir os dados do 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 01 de abril de 2022. Não coloque entre aspas.

Detalhamento da consulta

A tabela a seguir descreve cada parte da consulta.

Parte da consulta

Descrição


$apply=filter(

Iniciar cláusula filter().

Team/TeamName eq '{teamname}'

Devolva itens para uma equipe específica.

and BoardName eq 'Stories'

Retorne itens da lista de pendências de Histórias. Você pode especificar outros nomes de lista de pendências, como Épicos ou Funcionalidades. Especifique o nível de lista de pendências que corresponde ao processo selecionado para seu projeto.

and DateValue ge {startdate}

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

)

Fechar cláusula filter().

/groupby(

Iniciar cláusula groupby().

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

Agrupar por DateValue (usado para tendências), ColumnName, e quaisquer outras propriedades que você queira relatar. Aqui, incluímos LaneName a possibilidade de habilitar a filtragem por meio de 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. Insira um novo nome no painel Configurações de Consulta .

Screenshot das opções de menu de consulta do Power BI, opção para renomear a consulta.

Expandir colunas no Editor do Power Query

No Editor do Power Query, selecione a consulta com os dados que você deseja transformar. Para um gráfico CFD, você precisa expandir as colunas Area e AssignedTo. Para saber como, consulte as seguintes seções em Transformar dados do Analytics para gerar relatórios do Power BI, Expandir colunas.

(Opcional) Renomear campos de coluna

Você pode renomear campos de coluna para serem mais amigáveis. Para saber como, consulte Renomear campos de coluna.

Feche a consulta e aplique suas alterações

Ao concluir todas as transformações de dados, selecione Fechar &Aplicar no menu Página Inicial . Essa ação salva a consulta e retorna você para a guia Report no Power BI.

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

Criar o gráfico de área empilhada

No exemplo a seguir, a consulta é renomeada para CFD, mas você não renomeia nenhuma coluna.

  1. Em Power BI, em Visualizations, selecione o gráfico de Área Empilhada.

    Captura de tela de Visualizações e seleções de Campos do Power BI para relatório de gráfico CFD.

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

  3. Adicionar Count aos valores.

  4. Adicionar ColumnName à Legenda.

  5. No painel Filtros, expanda ColumnNamee selecione apenas os valores que você deseja que apareçam no gráfico. Por exemplo, talvez você queira desmarcar New, Proposed, Done ou Closed.

    Captura de tela dos filtros do Power BI para o ColumnName.

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

Screenshot do relatório de exemplo do gráfico de áreas empilhadas de Fluxo Cumulativo do Power BI, com colunas classificadas em ordem alfabética.

Classificar colunas em ordem crescente

Para classificar as colunas do gráfico na ordem especificada no quadro, siga estas etapas:

  1. Crie uma nova consulta no Power BI usando uma das consultas a seguir. Quando terminar, renomeie a consulta para ColumnOrder.

Copie e cole a consulta Power BI a seguir diretamente na janela Get Data>Blank Query. 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

Classifique o relatório na ordem correta

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

  2. Selecione Ferramentas de Coluna e selecione Classificar por Coluna. Escolha ColumnOrder. Captura de tela das Ferramentas de Coluna do Power BI, seleção Ordenar por Coluna.

  3. Selecione o menu Modeling e selecione Gerenciar Relações. Verifique se há uma relação entre CFD.ColumnName e ColumnOrder.ColumnName. Power BI provavelmente autodetecta a relação.

    Diálogo para Gerenciar Relacionamentos mostrando uma relação entre CFD.ColumnName e ColumnOrder.ColumnName.

  4. No relatório que você criou, na Legenda, substitua CFD.ColumnName por ColumnOrder.ColumnName.

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

    Captura de tela do relatório de exemplo do Power BI com gráfico de área empilhado de Fluxo Cumulativo, colunas organizadas na ordem das colunas do quadro.

Observação

Se algum item de trabalho estiver em uma coluna que você excluiu, eles aparecerão como "Em branco" no relatório anterior.