Erstellen eines Power BI-Berichts mit einer OData-Abfrage

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

Mit Power BI Desktop können Sie ganz einfach mit dem Erstellen von Berichten für Ihr Projekt in Azure DevOps beginnen.

Wenn Sie nicht über Power BI Desktop verfügen, können Sie es kostenlos herunterladen und installieren.

Führen Sie die Schritte aus, um einen Bericht in Power BI-Desktop zu erstellen, der einen täglichen Trend von Fehlern anzeigt.

  • Erstellen einer Power BI-Abfrage
  • Erstellen von Power BI-Transformationen
  • Erstellen eines Trendberichts zu Open Bugs

Voraussetzungen

Zum Erstellen eines Power BI-Berichts müssen Sie die folgenden Kriterien erfüllen:

Erstellen einer Power BI-Abfrage

Erstellen Sie eine Power BI-Abfrage, um die Daten wie folgt in Power BI abzurufen:

  1. Wählen Sie "Daten abrufen" und dann "Leere Abfrage" aus.

    Power BI - Blank Query

  2. Wählen Sie im Power BI Query-Editor Erweiterter Editor aus.

    Power BI - Select Advanced Editor

  3. Das fenster Erweiterter Editor wird geöffnet.

    Power BI - Advanced Editor

  4. Ersetzen Sie den Inhalt durch die folgende Abfrage.

    let
       Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v4.0-preview/WorkItemSnapshot? "
          $apply=filter(
              WorkItemType eq 'Bug'  
          AND StateCategory ne 'Completed'  
          AND startswith(Area/AreaPath,'{areapath}')  
          AND DateValue ge {startdate} )/
          groupby((DateValue,State,WorkItemType,Area/AreaPath), aggregate($count as Count))  
          &$orderby=DateValue"
         ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
    in
        Source
    

    Screenshot of Power BI, Advanced Editor, Pasted Query.

  5. Ersetzen Sie Ihre Werte innerhalb der Beispielabfrage.

    Die Beispielabfrage enthält Zeichenfolgen, die Sie durch Ihre Werte ersetzen müssen:

    • {organization} - Name Ihrer Organisation
    • {project} - Ihr Teamprojektname. Oder ganz weglassen /{project} , für eine projektübergreifende Abfrage
    • {areapath} - Ihr Bereichspfad. Format: Project\Level1\Level2
    • {startdate} - Das Datum, an dem Ihr Trendbericht beginnen soll. Format: JJJJ-MM-DDZ. Beispiel: 2022-09-01Z represents 2022-September-01. Schließen Sie keine Anführungszeichen ein.

    Screenshot of Power BI, Advanced Editor, Replaced Strings in Query.

  6. Wählen Sie "Fertig" aus, um die Abfrage auszuführen.

    Wenn Sie noch nie mit Ihrem Konto verbunden sind, müssen Sie sich möglicherweise von Power BI authentifizieren. Weitere Informationen finden Sie unter Clientauthentifizierungsoptionen.

Bereich, Iteration, AssignedTo-Spalten erweitern

Die Abfrage gibt mehrere Spalten zurück, die Sie erweitern müssen, bevor Sie sie in Power BI verwenden können. Jede Entität, die mithilfe einer $expand Anweisung abgerufen wird, gibt einen Datensatz mit potenziell mehreren Feldern zurück. Sie müssen den Datensatz erweitern, um die Entität in seine Felder zu reduzieren. Beispiele für solche Entitäten sind: AssignedTo, , Iterationund Area.

Nachdem Sie die Erweiterter Editor geschlossen haben und sich erneut in der Power Query-Editor Standard befinden, wählen Sie die Schaltfläche "Erweitern" für die Entitäten aus, die Sie reduzieren müssen.

  1. Wählen Sie beispielsweise die Schaltfläche "Erweitern" für "Bereich" aus, wählen Sie die Eigenschaften aus, die Sie erweitern möchten, und wählen Sie "OK" aus. Hier entscheiden wir uns für AreaName eine AreaPath Abschmächung. Die AreaName Eigenschaft ähnelt dem Knotennamenfeld .

    Screenshot of Power BI transform data, Expand AreaPath column.

    Hinweis

    Die verfügbaren Eigenschaften, die ausgewählt werden sollen, sind von den Eigenschaften abhängig, die in der Abfrage zurückgegeben werden sollen. Wenn Sie keine Eigenschaften angeben, sind alle Eigenschaften verfügbar. Weitere Informationen zu diesen Eigenschaften finden Sie in den folgenden Metadatenverweise: Bereiche, Iterationen und Benutzer.

  2. Die Tabelle enthält jetzt Entitätsfeld(n).

    Screenshot of expanded Area columns.

  3. Wiederholen Sie die Schritte 1 bis 3 für alle Felder, die Entitäten darstellen, die erweitert werden müssen. Diese werden in der Tabellenspalte aufgelistet, wenn sie nicht erweitert werden.

Umbenennen von Feldern und Abfragen, dann Schließen und Anwenden

Wenn Sie fertig sind, können Sie Spalten umbenennen.

  1. Klicken Sie mit der rechten Maustaste auf eine Spaltenüberschrift, und wählen Sie "Umbenennen" aus ...

    Screenshot of Power BI transform data, Rename Columns.

  2. Möglicherweise möchten Sie die Abfrage auch aus der Standardabfrage1 in einen aussagekräftigeren Namen umbenennen.

    Screenshot of Power BI transform data, Rename Query.

  3. Nachdem Sie fertig sind, wählen Sie "Schließen" und "Übernehmen" aus, um die Abfrage zu speichern und zu Power BI zurückzukehren.

    Screenshot of Power BI Power Query Editor, Close & Apply.

Erstellen des Berichts

Power BI zeigt Ihnen die Felder an, an denen Sie berichten können.

Hinweis

Im folgenden Beispiel wird davon ausgegangen, dass niemand Spalten umbenannt hat.

Screenshot of Power BI Visualizations and Fields selections for Bug trends report.

Führen Sie für einen einfachen Bericht die folgenden Schritte aus:

  1. Wählen Sie das Power BI-Visualisierungsliniendiagramm aus.
  2. Hinzufügen des Felds "DateValue" zur Achse
    • Klicken Sie mit der rechten Maustaste auf "DateValue", und wählen Sie "DateValue" anstelle der Datumshierarchie aus.
  3. Hinzufügen des Felds "Status" zur Legende
  4. Hinzufügen des Felds "Count" zu Werten
    • Klicken Sie mit der rechten Maustaste auf das Feld "WorkItemId", und stellen Sie sicher, dass "Summe " ausgewählt ist.

Der Beispielbericht:

Screenshot of Sample Bug trends line chart report.

Nächste Schritte