Report di esempio di rollup dello stato delle funzionalità

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

** Questo articolo illustra come creare un report con grafico a barre impilate per visualizzare lo stato di avanzamento delle funzionalità in base alle storie utente figlio completate. Il report visualizza la percentuale di completamento tramite rollup di Story Points per un determinato set di funzionalità attive. Nell'immagine seguente è illustrato un esempio.

È possibile visualizzare grafici a barre di stato simili dal backlog aggiungendo una colonna di rollup. Per informazioni su come, vedere Visualizzare lo stato di avanzamento del rollup o i totali.

Query di esempio

"L'avanzamento della funzionalità richiede l'entità WorkItems per ottenere lo stato corrente."

Esaminare lo stato delle funzionalità in base a un percorso di area

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
        &"$filter=WorkItemType eq 'Feature' "
            &"and State ne 'Removed' "
            &"and startswith(Area/AreaPath,'{areapath}') "
            &"and Descendants/any()"
            &"&$select=WorkItemId,Title,Area,Iteration,AssignedTo,WorkItemType,State,AreaSK"
            &"&$expand=Descendants( "
            &"$apply=filter(WorkItemType eq 'User Story') " 
                &"/groupby((StateCategory), "
                &"aggregate(StoryPoints with sum as TotalStoryPoints)) "
            &")  "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
        $filter=WorkItemType eq 'Feature'
            and State ne 'Removed'
            and startswith(Area/AreaPath,'{areapath}')
            and Descendants/any()
        &$select=WorkItemId,Title,Area,Iteration,AssignedTo,WorkItemType,State,AreaSK
        &$expand=Descendants(
            $apply=filter(WorkItemType eq 'User Story')
                /groupby((StateCategory),
                aggregate(StoryPoints with sum as TotalStoryPoints))
            ) 

Stringhe di sostituzione e scomposizione delle query

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

• {organization} - Nome dell'organizzazione
• {project} - Il nome del progetto del team o omettere /{project} completamente per una query interprogetti
• {areapath} - Il percorso dell'area. Formato di esempio: Project/Level1/Level2.

Suddivisione delle query

La tabella seguente descrive ogni parte della query.

$filter=endswith(Area/AreaPath,'suffix')
&$select=WorkItemId,Title,WorkItemType,State,Area, Descendants
&$expand=Descendants($select=WorkItemId)

$filter=endswith(Area/AreaPath, 'suffix')and Descendants/any()
&$select=WorkItemId,Title,WorkItemType,State,Area, Descendants
&$expand=Descendants($select=WorkItemId)

Esaminare lo stato di avanzamento delle funzionalità per un team

La query seguente è identica a quella usata in precedenza, tranne che filtra per Nome del Team anziché per Percorso Area.

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
        &"$filter=WorkItemType eq 'Feature' "
            &"and State ne 'Cut' "
            &"and (Teams/any(x:x/TeamName eq '{teamname}) or Teams/any(x:x/TeamName eq '{teamname}) or Teams/any(x:x/TeamName eq '{teamname}) "
            &"and Descendants/any() "
        &"&$select=WorkItemId,Title,WorkItemType,State,AreaSK "
        &"&$expand=Descendants( "
            &"$apply=filter(WorkItemType eq 'User Story') "
                &"/groupby((StateCategory), "
                &"aggregate(StoryPoints with sum as TotalStoryPoints)) "
            &")  "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
        $filter=WorkItemType eq 'Feature'
            and State ne 'Cut'
            and (Teams/any(x:x/TeamName eq '{teamname}) or Teams/any(x:x/TeamName eq '{teamname}) or Teams/any(x:x/TeamName eq '{teamname})
            and Descendants/any()
        &$select=WorkItemId,Title,WorkItemType,State,AreaSK
        &$expand=Descendants(
            $apply=filter(WorkItemType eq 'User Story')
                /groupby((StateCategory),
                aggregate(StoryPoints with sum as TotalStoryPoints))
            ) 

Trasformare i dati nell'Editor di Power Query

La query restituisce diverse colonne che è necessario espandere prima di poterle usare per creare un report. Qualsiasi entità estratta usando un'istruzione $expand OData restituisce un record con potenzialmente diversi campi. Espandere il record per rendere flat l'entità nei relativi campi.

Per il report sull'Avanzamento delle Funzionalità, sarà necessario eseguire le seguenti trasformazioni:

• Espandi la Descendants colonna in due colonne: Descendants.StateCategory e Descendants.TotalStoryPoints
• Applicare la trasformazione Colonna pivot alla colonna Descendants.StateCategory per separare le singole categorie di Stato
• Sostituire i valori Null in tutte le colonne con pivot.
• Aggiungere una colonna personalizzata per rappresentare la percentuale di completamento. La colonna personalizzata visualizzerà errori se ci sono colonne nulle nelle colonne con pivot di Stato.

Per informazioni su come, vedere le sezioni seguenti in Trasformare i dati di Analisi per generare report di Power BI:

• Espandi la colonna Discendenti.
• Colonna Pivot dei discendenti di StateCategory.
• Sostituire i valori null.
• Creare una colonna calcolata percentuale completata

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.

Creare il report del grafico a barre sovrapposte

1. In Power BI, scegliere Grafico a barre impilate sotto Visualizzazioni.

   

2. Aggiungi Title all'asse Y.

3. Aggiungi PercentComplete all'asse X, fai clic con il pulsante destro del mouse e scegli Somma.

Viene visualizzato il report di esempio.

Articoli correlati

• Esplorare i report di esempio usando query OData
• Formulare query OData per Analytics
• Connettersi a Power BI usando query OData
• Fare riferimento ai metadati di Azure Boards Analytics
• Accedere ai report di esempio e all'indice di riferimento rapido
• Aggiungere un filtro team a un report esistente