Report di esempio di diagramma di flusso cumulativo (CFD)

  • Articolo

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

Questo articolo illustra come visualizzare il CFD Stories per un team specificato. Questi dati sono disponibili anche tramite il widget predefinito del grafico e del dashboard. Per altre informazioni su queste opzioni, vedere Visualizzare e configurare un diagramma di flusso cumulativo.

Un esempio è illustrato nell'immagine seguente che mostra un conteggio delle storie utente nel tempo negli stati Researching, Committed, In Progress e In Review . Il passaggio del mouse su una data fornisce informazioni sui dati per tale data.

Screenshot del report grafico ad aree in pila del flusso cumulativo di Power BI, le colonne ordinate in ordine di colonna della scheda Kanban.

Per altre informazioni sul flusso cumulativo, vedere Flusso cumulativo, lead time e linee guida per il tempo di ciclo e linee guida per il flusso cumulativo, il lead time e il tempo di ciclo.

Nota

Questo articolo presuppone di avere letto Panoramica dei report di esempio usando query OData e avere una conoscenza di base di Power BI.

Prerequisiti

  • Per visualizzare i dati di Analisi ed eseguire query sul servizio, è necessario essere membri di un progetto con accesso basic o superiore. Per impostazione predefinita, a tutti i membri del progetto vengono concesse le autorizzazioni per eseguire query su Analisi e definire le visualizzazioni di Analisi.
  • Per altre informazioni sugli altri prerequisiti relativi all'abilitazione di servizi e funzionalità e alle attività generali di rilevamento dei dati, vedere Autorizzazioni e prerequisiti per l'accesso ad Analytics.

Query di esempio

Le query in questa sezione supportano la restituzione di dati di flusso cumulativi per storie utente. Queste query specificano il WorkItemBoardSnapshot set di entità quando restituiscono dati calcolati per la scheda Kanban nel tempo.

Nota

Per determinare le proprietà disponibili a scopo di filtro o report, vedere Informazioni di riferimento sui metadati per Azure Boards. È possibile filtrare le query o restituire proprietà usando uno qualsiasi dei Property valori in un EntityType oggetto o NavigationPropertyBinding Path i valori disponibili con un oggetto EntitySet. Ognuno EntitySet corrisponde a un oggetto EntityType. Per altre informazioni sul tipo di dati di ogni valore, esaminare i metadati forniti per l'oggetto corrispondente EntityType.

È possibile incollare la query di Power BI elencata di seguito direttamente nella finestra Recupera query vuota dati>. Per altre informazioni, vedere Panoramica dei report di esempio che usano query 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

Stringhe di sostituzione e scomposizione delle query

Sostituire le stringhe seguenti con i valori. Non includere parentesi quadre {} con la sostituzione. Ad esempio, se il nome dell'organizzazione è "Fabrikam", sostituire {organization} con Fabrikam, non {Fabrikam}.

  • {organization} - Nome dell'organizzazione
  • {project} - Nome del progetto team o omettere completamente "/{project}" per una query tra progetti
  • {teamname} - Nome del team per visualizzare i dati CFD
  • {startdate} - Avviare il report per gli elementi completati in o dopo una data specifica con il formato : YYYY-MM-DDZ. Ad esempio: 2022-04-01Z rappresenta il 2022-aprile-01. Non racchiudere tra virgolette.

Suddivisione delle query

La tabella seguente descrive ogni parte della query.

Parte della query

Descrizione

$apply=filter(

Clausola Start filter() .

Team/TeamName eq '{teamname}'

Restituisce gli elementi per un team specifico.

and BoardName eq 'Stories'

Restituisce elementi nel backlog Stories . È possibile specificare altri nomi di backlog, ad esempio Epics o Features. Specificare il livello di backlog che corrisponde al processo selezionato per il progetto.

and DateValue ge {startdate}

Restituisce dati in base o dopo la data specificata, ad esempio 2022-04-01Z rappresenta il 2022-aprile-01 2019-luglio-01.

)

Clausola Close filter() .

/groupby(

Clausola Start groupby() .

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

Raggruppa per DateValue (usato per la tendenza), ColumnNamee tutte le altre proprietà su cui si desidera creare report. Qui si include LaneName per abilitare il filtraggio in base alle corsie.

aggregate($count as Count)

Aggregazione come conteggio degli elementi di lavoro.

)

Clausola Close groupby() .

(Facoltativo) Rinominare la query

È possibile rinominare l'etichetta di query predefinita Query1 in qualcosa di più significativo. È sufficiente immettere un nuovo nome dal riquadro Query Impostazioni.

Screenshot delle opzioni del menu query di Power BI, rinominare la query.

Espandere le colonne in editor di Power Query

Nella editor di Power Query scegliere la query con i dati da trasformare. Per un grafico CFD, è necessario espandere le Areacolonne , Iteratione AssignedTo . Per informazioni su come, vedere le sezioni seguenti in Trasformare i dati di Analisi per generare report di Power BI, Espandere le colonne.

(Facoltativo) Rinominare i campi

Dopo aver espanso le colonne, è possibile rinominare uno o più campi. Ad esempio, è possibile rinominare la colonna AreaPath in Area Path. Per informazioni su come, vedere Rinominare i campi delle colonne.

Chiudere la query e applicare le modifiche

Dopo aver completato tutte le trasformazioni dei dati, scegliere Chiudi e applica dal menu Home per salvare la query e tornare alla scheda Report in Power BI.

Screenshot dell'opzione Chiudi e applica editor di Power Query.

Creare il grafico ad area in pila

Nell'esempio seguente la query è stata rinominata in CFD, ma non sono state rinominate colonne.

  1. In Power BI scegliere il grafico ad area in pila in Visualizzazioni.

    Screenshot delle visualizzazioni e dei campi di Power BI per il report grafico CFD.

  2. Aggiungi DateValue all'asse, quindi fai clic con il pulsante destro del mouse DateValue e scegli DateValue, anziché Date Hierarchy.

  3. Aggiungi Count a Valori.

  4. Aggiungi ColumnName alla legenda.

  5. Nel riquadro Filtri espandere ColumnNamee selezionare solo i valori che si desidera visualizzare nel grafico. Ad esempio, è possibile deselezionare Nuovo, Proposto, Fatto o Chiuso.

    Screenshot dei filtri di Power BI per ColumnName.

Nel report di esempio vengono visualizzate le colonne in ordine alfabetico. Tuttavia, l'ordine preferito consiste nell'ordinare i dati in base all'ordine delle colonne Kanban o all'ordine progressivo.

Screenshot del report del grafico ad aree in pila del flusso cumulativo di Power BI di esempio, le colonne ordinate in ordine alfabetico.

Ordinare le colonne in ordine progressivo

Per ordinare le colonne del grafico nell'ordine specifico nella scheda Kanban, seguire questa procedura:

  1. Creare una nuova query in Power BI in base alle query seguenti. Al termine, rinominare la query in ColumnOrder.

È possibile incollare la query di Power BI elencata di seguito direttamente nella finestra Recupera query vuota dati>. Per altre informazioni, vedere Panoramica dei report di esempio che usano query 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

Ordinare il report nell'ordine corretto

  1. In Power BI espandere la query ColumnOrder e selezionare ColumnName.

  2. Selezionare Strumenti colonna e quindi Ordinare per colonna e scegliere ColumnOrder. Screenshot di Strumenti colonna di Power BI, Ordinamento in base alla selezione colonna.

  3. Selezionare il menu Modellazione e quindi Gestisci relazioni. Verificare che sia presente una relazione tra CFD.ColumnName e ColumnOrder.ColumnName. È probabile che la relazione sia stata rilevata automaticamente.

    Finestra di dialogo relativa alla gestione delle relazioni che mostra una relazione tra CFD. ColumnName e ColumnOrder.ColumnName.

  4. Nel report creato in precedenza, nella legenda sostituire CFD.ColumnName con ColumnOrder.ColumnName in Legenda.

    Il report viene aggiornato con colonne ordinate nello stesso ordine usato dalla scheda Kanban.

    Screenshot del report del grafico ad aree in pila flusso cumulativo di Power BI di esempio, le colonne ordinate in ordine di colonna della scheda Kanban.

Nota

Se gli elementi di lavoro si trovano in una colonna che è stata eliminata, verranno visualizzati come "Blank" nel report precedente.