Freigeben über


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, laden Sie es kostenlos herunter , und installieren Sie es kostenlos.

Voraussetzungen

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

  • Ein Projektmitglied sein. Wenn sie nicht vorhanden sind, werden Sie jetzt hinzugefügt. Jeder, der Zugriff auf das Projekt hat, mit Ausnahme der Projektbeteiligten, kann Analyseansichten anzeigen.
  • Lassen Sie die Berechtigung "Analyse anzeigen" auf " Zulassen" festlegen. Siehe Erteilen von Berechtigungen für den Analysezugriff.
  • Aktivieren sie Boards. Informationen zum erneuten Aktivieren von Boards finden Sie unter Aktivieren oder Deaktivieren eines Azure DevOps-Diensts.
  • Lassen Sie power BI Desktop Vom Oktober 2018 Update oder höher aktualisiert werden.
  • Nachverfolgen von Arbeitsaufgaben für einen bestimmten Zeitraum, für den ein Trendbericht generiert werden soll.

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.

    Screenshot: Power BI – Leere Abfrage.

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

    Screenshot zeigt Power BI – auswählen Erweiterter Editor.

  3. Das fenster Erweiterter Editor wird geöffnet.

    Screenshot zeigt Power BI – Erweiterter Editor.

  4. Ersetzen Sie den Inhalt durch die folgende Abfrage:

    let
       The query you provided has a syntax issue due to the placement of double quotes. Specifically, the `$apply` and `$orderby` parameters should be part of the URL string, but they are not correctly concatenated. Here is the corrected version:
    
    
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 von Power BI, Erweiterter Editor, eingefügte Abfrage.

  1. 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 von Power BI, Erweiterter Editor, Ersetzte Zeichenfolgen in Abfrage.

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

    Power BI erfordert möglicherweise die Authentifizierung. 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 und im Power Query-Editor verbleiben, 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 der Power BI-Transformationsdaten, Spalte

    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ätsfelder.

    Screenshot der erweiterten Bereichsspalten.

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

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 der Power BI-Transformationsdaten, Spalten umbenennen.

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

    Screenshot der Power BI-Transformationsdaten, Abfrage umbenennen.

  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 von Power BI Power Query-Editor, Schließen und Anwenden.

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 der Auswahl von Power BI-Visualisierungen und -Feldern für den Bericht

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.

Beispielbericht:

Screenshot des Diagrammberichts

Nächste Schritte