Beispielbericht zum Featurefortschrittsrollup

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

In diesem Artikel wird gezeigt, wie Sie einen Bericht mit gestapelten Balkendiagrammen erstellen, um den Fortschritt von Features basierend auf abgeschlossenen untergeordneten User Storys anzuzeigen. Der Bericht zeigt den Abschlussprozentsatz nach Rollup von Story Points für eine bestimmte Reihe aktiver Features an. Sie können ähnliche Fortschrittsbalkendiagramme aus dem Backlog anzeigen, indem Sie eine Rollupspalte hinzufügen. Informationen zur Vorgehensweise finden Sie unter Anzeigen von Rollupstatus oder Summen.

Wenn Sie Rollupberichte mithilfe von Power BI erstellen, treten möglicherweise Probleme im Zusammenhang mit geschachtelten Daten in Ihren Datasets auf. Insbesondere der Versuch, eine Tabelle zu pivotieren, die Spalten mit geschachtelten Daten enthält, kann zu einer Fehlermeldung führen. Weitere Informationen finden Sie im Abschnitt zum Umgang mit geschachtelten Daten.

Voraussetzungen

Beispielabfragen

Der Featurefortschritt fragt die WorkItems-Entität ab, um den aktuellen Status abzurufen.

Überprüfen des Featurefortschritts basierend auf einem Bereichspfad

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))
            ) 

Ersetzungszeichenfolgen und Abfrageaufschlüsselung

Ersetzen Sie die folgenden Zeichenfolgen durch Ihre Werte. Klammern nicht einschließen {} in Ihrer Ersetzung Wenn Ihr Organisationsname z. B. "Fabrikam" lautet, ersetzen Sie {organization} durch Fabrikam, nicht durch {Fabrikam}.

• {organization} - Name Ihrer Organisation
• {project} - Der Name Ihres Teamprojekts oder ganz ausgelassen /{project} für eine projektübergreifende Abfrage
• {areapath}: Ihr Bereichspfad. Beispielformat: Project/Level1/Level2.

Abfrageaufschlüsselung

In der folgenden Tabelle werden die einzelnen Teile der Abfrage beschrieben.

$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)

Überprüfung des Feature-Fortschritts eines Teams

Die folgende Abfrage ist identisch mit der zuvor verwendeten Abfrage, filtert jedoch nach Teamname und nicht nach Bereichspfad.

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))
            ) 

Transformieren der Daten in Power Query-Editor

Die Abfrage gibt mehrere Spalten zurück, die Sie erweitern müssen, bevor Sie sie zum Erstellen eines Berichts verwenden können. Jede Entität, die Sie mithilfe einer OData -$expand-Anweisung abrufen, gibt einen Datensatz mit potenziell mehreren Feldern zurück. Erweitern Sie den Datensatz, um die Entität in den Feldern zu vereinfachen.

Führen Sie für den Bericht "Feature-Fortschritt" die folgenden Transformationen aus:

• Erweitern Sie die Descendants Spalte in zwei Spalten: Descendants.StateCategory und Descendants.TotalStoryPoints.
• Wenden Sie die Pivotspaltentransformation auf die Descendants.StateCategory Spalte an, um einzelne Statuskategorien zu trennen.
• Ersetzen Sie Nullwerte in allen pivotierten Spalten.
• Fügen Sie eine benutzerdefinierte Spalte hinzu, die den Fertigstellungsgrad darstellt. In der benutzerdefinierten Spalte werden Fehler angezeigt, wenn in den pivotierten Statusspalten NULL-Spalten vorhanden sind.

Informationen dazu finden Sie unter Transform Analytics-Daten zum Generieren von Power BI Berichten.

Umgang mit verschachtelten Daten

Stellen Sie vor dem Ausführen eines Pivotvorgangs sicher, dass ihr Dataset keine Spalten mit geschachtelten Daten enthält. Folgen Sie diesen Schritten:

1. Verschachtelte Spalten identifizieren: Überprüfen Sie Ihr Dataset auf Spalten, die Listen, Datensätze oder Tabellen in einer einzelnen Zelle enthalten könnten.
2. Blaten oder entfernen Sie geschachtelte Daten: Entfernen Sie die geschachtelten Spalten, oder flachen Sie sie, indem Sie mithilfe des Features Expand in Power Query in separate Spalten erweitern.
3. Führen Sie den Pivotvorgang aus: Nachdem Sie die geschachtelten Daten adressiert haben, können Sie mit dem Pivotvorgang fortfahren, ohne dass Fehler auftreten.

Schließen Sie die Abfrage, und wenden Sie Ihre Änderungen an.

Nach Abschluss aller Datentransformationen Schließen & Übernehmen im Start-Menü auswählen. Diese Aktion speichert die Abfrage und gibt Sie in Power BI zur Registerkarte Report zurück.

Erstellen Sie den gestapelten Balkendiagrammbericht

1. Wählen Sie in Power BI Stacked-Balkendiagramm unter Visualizations aus.

   

2. Fügen Sie Title zur Y-Achse hinzu.

3. Fügen Sie PercentComplete zu X-Achse hinzu, klicken Sie mit der rechten Maustaste, und wählen Sie Summe aus.

Der Beispielbericht wird angezeigt.

Verwandte Inhalte

• Erkunden von Beispielberichten mithilfe von OData-Abfragen
• Erstellen von OData-Abfragen für Analytics
• Mit Power BI über OData-Abfragen verbinden
• Verweisen auf Metadaten für Azure Boards Analytics
• Zugriff auf Beispielberichte und Schnellübersichtsindex
• Hinzufügen eines Team-Slicers zu einem vorhandenen Bericht