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

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 por meio 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, Confirmado, Em andamento e Em revisão. Passar o mouse sobre uma data fornece informações sobre os dados dessa data.

Para saber mais sobre o fluxo cumulativo, consulte Orientação de fluxo cumulativo, lead time e tempo de ciclo e Orientação de fluxo cumulativo, lead time e 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 do Power BI.

Pré-requisitos

• Para exibir dados do 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 Análise e definir exibições do Analytics.
• Para saber mais sobre outros pré-requisitos relacionados à habilitação de serviço e recursos e atividades gerais de acompanhamento 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 WorkItemBoardSnapshot entidades à medida que retornam dados calculados para o quadro Kanban ao longo do tempo.

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

Consulta do Power BI

Você pode colar a consulta do Power BI listada abaixo diretamente na janela Obter Consulta em Branco de> Dados . Para obter mais informações, examine 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

Consulta OData

Você pode usar o código de consulta OData a seguir 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 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 projeto da sua 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 de início filter() .

Team/TeamName eq '{teamname}'

Devolver itens para uma equipe 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 Epics ou Features. Especifique o nível de lista de pendências que corresponde ao processo selecionado para seu projeto.

and DateValue ge {startdate}

Retornar dados em 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 de início groupby() .

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

Agrupe por DateValue (usado para tendências) ColumnNamee quaisquer outras propriedades sobre as quais você deseja 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 .

Expandir colunas em Editor do Power Query

No Editor do Power Query, escolha a consulta com os dados que pretende transformar. Para um gráfico 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 suas alterações

Depois de concluir todas as transformações de dados, escolha Fechar & Aplicar no menu Página Inicial 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.

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

   

2. Adicione DateValue ao Axis e clique com o botão direito do mouse DateValue 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 você 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 de colunas Kanban, ou ordem progressiva.

Classificar colunas em 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.

Consulta do Power BI

Você pode colar a consulta do Power BI listada abaixo diretamente na janela Obter Consulta em Branco de> Dados . Para obter mais informações, examine 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

Consulta OData

Você pode usar o código de consulta OData a seguir 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/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

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

2. Selecione Ferramentas de Coluna e, em seguida, Classificar por Coluna e escolha ColumnOrder.

3. Selecione o menu Modelagem e, em seguida , Gerenciar Relações. Certifique-se de que há uma relação entre CFD.ColumnName e ColumnOrder.ColumnName. É provável que a relação tenha sido autodetectada.

   

4. No relatório criado acima, na Legenda, substitua ColumnOrder.ColumnNameCFD.ColumnNamepor Legenda.

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

   

Observação

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

Artigos relacionados

• Visão geral de relatórios de exemplo usando consultas OData
• Construir consultas OData para Análise
• Conectar-se usando consultas do Power BI e OData
• Referência de metadados para o Azure Boards Analytics
• Relatórios de exemplo e índice de referência rápida
• Adicionar uma segmentação de equipe a um relatório existente