Beispielbericht zum Featurestatusrollup

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

In diesem Artikel wird gezeigt, wie Sie einen gestapelten Balkenbericht erstellen, um den Fortschritt der Features basierend auf abgeschlossenen untergeordneten Benutzergeschichten anzuzeigen. Der Bericht zeigt den Prozentsatz vollständig an, indem ein Rollup von Story Points für einen bestimmten Satz aktiver Features ausgeführt wird. In der folgenden Abbildung ist ein Beispiel angegeben.

Sie können ähnliche Statusanzeigendiagramme aus Dem Backlog anzeigen, indem Sie eine Rollupspalte hinzufügen. Informationen dazu finden Sie unter Anzeigen des Rollupfortschritts oder der Summen.

Voraussetzungen

• Access: Mitglied eines Projekts mit mindestens standardem Zugriff sein.
• Berechtigungen: Standardmäßig verfügen Projektmitglieder über die Berechtigung zum Abfragen von Analysen und Erstellen von Ansichten.
• Weitere Informationen zu anderen Voraussetzungen für die Dienst- und Featureaktivierung sowie allgemeine Datenverfolgungsaktivitäten finden Sie unter Berechtigungen und Voraussetzungen für den Zugriff auf Analytics.

Beispielabfragen

Der Featurestatus fragt die WorkItems Entität ab, um den aktuellen Status des Fortschritts abzurufen.

Überprüfen des Featurestatus 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. Schließen Sie keine Klammern {} in Ihre Ersetzung ein. Wenn Ihr Organisationsname beispielsweise "Fabrikam" lautet, ersetzen Sie {organization} durch Fabrikam, nicht {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üfen des Funktionsfortschritts für ein Team

Die folgende Abfrage ist identisch mit der oben verwendeten Abfrage, mit der Ausnahme, dass sie nach Teamname und nicht nach Bereichspfad gefiltert wird.

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 mithilfe einer OData -$expand-Anweisung abgerufen wird, gibt einen Datensatz mit potenziell mehreren Feldern zurück. Erweitern Sie den Datensatz, um die Entität in die Felder zu reduzieren.

Für den Bericht "Featurestatus" müssen Sie die folgenden Transformationen ausführen:

• Erweitern Sie die Descendants Spalte in zwei Spalten: Descendants.StateCategory und Descendants.TotalStoryPoints
• Anwenden der Pivotspaltentransformation auf Descendants.StateCategory Spalte, um einzelne Statuskategorien zu trennen
• Ersetzen Sie Nullwerte in allen pivotierten Spalten.
• Fügen Sie eine benutzerdefinierte Spalte hinzu, um den Prozentsatz vollständig darzustellen. In der benutzerdefinierten Spalte werden Fehler angezeigt, wenn in den Pivoted State-Spalten Nullspalten vorhanden sind.

Informationen dazu finden Sie in den folgenden Abschnitten in Transform Analytics-Daten zum Generieren von Power BI-Berichten:

• Erweitern Sie die Spalte "Nachfolger".
• Pivot Descendants.StateCategory-Spalte.
• Ersetzen Sie Nullwerte.
• Erstellen einer berechneten Spalte für einen prozentsatz abgeschlossenen Prozentsatz

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

Nachdem Sie alle Datentransformationen abgeschlossen haben, wählen Sie "Schließen" und "Übernehmen " im Menü "Start " aus, um die Abfrage zu speichern und zur Registerkarte "Bericht " in Power BI zurückzukehren.

Erstellen des Diagrammberichts für gestapelte Balken

1. Wählen Sie in Power BI unter "Visualisierungen" den Bericht "Gestapelte Balkendiagramme" aus.

   

2. Zur Y-Achse hinzufügenTitle.

3. Zu X-Achse hinzufügenPercentComplete, klicken Sie mit der rechten Maustaste, und wählen Sie "Summe" aus.

Der Beispielbericht wird angezeigt.

Verwandte Artikel

• Erkunden von Beispielberichten mithilfe von OData-Abfragen
• Erstellen von OData-Abfragen für Analytics
• Herstellen einer Verbindung mit Power BI mithilfe von OData-Abfragen
• Informationen zu Metadaten für Azure Boards Analytics
• Access-Beispielberichte und Kurzübersichtsindex
• Hinzufügen eines Teamdatenschnitts zu einem vorhandenen Bericht