Share via

Beispielbericht zum Featurestatusrollup

  • Artikel

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.

Screenshot des Diagrammberichts

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.

Hinweis

In diesem Artikel wird davon ausgegangen, dass Sie die Übersicht über Beispielberichte mit OData-Abfragen gelesen haben und über ein grundlegendes Verständnis von Power BI verfügen.

Voraussetzungen

  • Um Analytics-Daten anzuzeigen und den Dienst abzufragen, müssen Sie Mitglied eines Projekts mit oder höherer Basiszugriff sein. Standardmäßig erhalten alle Projektmitglieder Berechtigungen zum Abfragen von Analytics und zum Definieren von Analytics-Ansichten.
  • Weitere Informationen zu weiteren Voraussetzungen für die Dienst- und Featureaktivierung sowie allgemeine Datennachverfolgungsaktivitä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.

Hinweis

Informationen zum Ermitteln verfügbarer Eigenschaften für Filter- oder Berichtszwecke finden Sie unter Metadatenreferenz für Azure Boards. Sie können Ihre Abfragen filtern oder Eigenschaften zurückgeben, indem Sie einen der Werte unter oder NavigationPropertyBinding PathEntityType verwenden, die Property mit einem EntitySetverfügbar sind. Jede EntitySet entspricht einem EntityType. Weitere Informationen zum Datentyp der einzelnen Werte finden Sie in den Metadaten, die für den entsprechenden EntityTypebereitgestellt werden.

Überprüfen des Featurestatus basierend auf einem Bereichspfad

Sie können die unten aufgeführte Power BI-Abfrage direkt in das Fenster Get Data-Blank> Query einfügen. Weitere Informationen finden Sie unter Übersicht über Beispielberichte mit OData-Abfragen.

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

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.

Abfrageteil

Beschreibung

$filter=WorkItemType eq 'Feature'

Gibt Features zurück.

and State ne 'Cut'

Lassen Sie Features weg, die als Ausschneiden markiert sind.

and startswith(Area/AreaPath,'{areapath}')

Zurückgeben von Arbeitsaufgaben unter einem bestimmten Bereichspfad. Durch ersetzen Area/AreaPath eq '{areapath}' gibt Elemente an einem bestimmten Bereichspfad zurück.
Verwenden Sie die Filteranweisung Teams/any(x:x/TeamName eq '{teamname})', um nach Teamname zu filtern.

and Descendants/any()

Filtert alle Arbeitsaufgaben mit mindestens einem oder einem untergeordneten Element aus. Enthält alle Features mit mindestens einer untergeordneten Arbeitsaufgabe. Führen Sie eine Abfrage ohne den Descendants/any() Filter aus, um alle Arbeitsaufgaben mit ihren Nachfolgern abzurufen, auch wenn sie keines haben. Wenn Sie Features weglassen möchten, die keine untergeordneten Benutzergeschichten enthalten, ersetzen Sie diese durch any(d:d/WorkItemType eq 'User Story').

Für alle Arbeitsaufgaben mit und ohne Nachfolger:

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

Für alle Arbeitsaufgaben mit mindestens einem untergeordneten Element:

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

&$select=WorkItemId, Title, WorkItemType, State

Wählen Sie die zurückzugebenden Eigenschaften aus.

&$expand=Descendants(

Beginn der Erweiterungsklausel Descendants

$apply=filter(WorkItemType eq 'User Story')

Filtern Sie die Nachfolger. Nur Benutzergeschichten enthalten (Aufgaben und Fehler weglassen).

/groupby((StateCategory),

Gruppieren Sie das Rollup nach StateCategory. Weitere Informationen zu Statuskategorien finden Sie unter Verwenden von Workflowzuständen und Zustandskategorien in Backlogs und Boards.

aggregate(StoryPoints with sum as TotalStoryPoints))

Aggregierte Summe von Story Points.

)

Close-Klausel Descendants() .

Ü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.

Sie können die unten aufgeführte Power BI-Abfrage direkt in das Fenster Get Data-Blank> Query einfügen. Weitere Informationen finden Sie unter Übersicht über Beispielberichte mit OData-Abfragen.

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

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:

Hinweis

In diesem Beispiel enthalten die Statuswerte für den Benutzerabschnitt "Vorgeschlagen", "In Bearbeitung" und "Abgeschlossen".

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.

Screenshot der Option

Erstellen des Diagrammberichts für gestapelte Balken

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

    Screenshot der Auswahl von Power BI-Visualisierungen und -Feldern für Gestapelte Balkendiagramme für Featurestatus.

  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.

Screenshot des Diagrammberichts