Freigeben über


Erstellen eines Power BI-Berichts mit einer OData-Abfrage

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

In dieser Schnellstartanleitung erstellen Sie einen Fehlertrendbericht in Power BI Desktop, indem Sie eine Verbindung mit Azure DevOps Analytics mit einer OData-Abfrage herstellen. Die Abfrage verwendet serverseitige Filterung und Aggregation ($apply), um nur die benötigten Daten zurückzugeben, wodurch die Aktualisierungszeiten auch bei großen Projekten kurz bleiben.

Wenn Sie nicht über Power BI Desktop verfügen, können Sie es kostenlos herunterladen. Informationen zu anderen Verbindungsmethoden finden Sie unter "Informationen zur Power BI-Integration".

Tipp

Sie können KI verwenden, um Ihnen bei dieser Aufgabe zu helfen später in diesem Artikel oder sehen Sie sich an, wie Sie die KI-Unterstützung bei Azure DevOps MCP Server aktivieren, um loszulegen.

Voraussetzungen

Kategorie Anforderungen
Zugriffsebenen - Projektmitglied.
– Mindestens einfacher Zugriff.
Erlaubnisse Berechtigungssatz "Analyse anzeigen " auf "Zulassen" festlegen. Weitere Informationen finden Sie unter Erteilen von Berechtigungen für den Analytics-Zugriff
Werkzeuge - Azure Boards aktiviert
- Power BI Desktop
Aufgaben Überwachen Sie Arbeitsaufgaben über einen bestimmten Zeitraum, um einen Trendbericht zu generieren.
Kategorie Anforderungen
Zugriffsebenen - Projektmitglied.
– Mindestens einfacher Zugriff.
Erlaubnisse Berechtigungssatz "Analyse anzeigen " auf "Zulassen" festlegen. Weitere Informationen finden Sie unter Erteilen von Berechtigungen für den Analytics-Zugriff
Werkzeuge - Analyseerweiterung. Project-Sammlungsadministratoren können den Dienst hinzufügen und aktivieren.
- Power BI Desktop.
- Azure Boards aktiviert
Aufgaben Überwachen Sie Arbeitsaufgaben über einen bestimmten Zeitraum, um einen Trendbericht zu generieren.

Erstellen einer Power BI-Abfrage

  1. In Power BI Desktop, wählen Sie die Option „Daten abrufen“>Leere Abfrage aus.

    Screenshot: Power BI – Leere Abfrage.

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

    Der Screenshot zeigt Power BI – wählen Sie den Erweiterten Editor aus.

  3. 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 von Power BI, Erweiterter Editor, eingefügte Abfrage.

  4. Ersetzen Sie die Platzhalterwerte in der Abfrage:

    Platzhalter Ersetzen durch
    {organization} Ihr Name der Organisation
    {project} Name des Teamprojekts eingeben oder /{project} vollständig weglassen für eine projektübergreifende Abfrage.
    {areapath} Ihr Bereichspfad (Format: Project\Level1\Level2)
    {startdate} Das Startdatum für Ihren Trendbericht (z. BYYYY-MM-DDZ. Format: 2022-09-01Z). Schließen Sie keine Anführungszeichen ein.

    Screenshot von Power BI, Erweiterter Editor, Ersetzte Zeichenfolgen in Abfrage.

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

    Power BI erfordert möglicherweise die Authentifizierung. Weitere Informationen finden Sie unter Clientauthentifizierungsoptionen.

Spalten erweitern

Die Abfrage gruppiert Ergebnisse nach Area/AreaPath, wodurch "Area" als geschachtelte Datenstruktur zurückgegeben wird. Sie müssen den Datensatz erweitern, um ihn in einzelne Spalten zu reduzieren.

Erweitern Sie im Power Query-Editor jede Spalte, in der "Datensatz" angezeigt wird:

  1. Wählen Sie die Schaltfläche "Erweitern" in der Spaltenüberschrift "Bereich " aus, wählen Sie die gewünschten Eigenschaften aus (z. B. "AreaName" und "AreaPath"), und wählen Sie dann "OK" aus.

    Screenshot der Power BI-Transformationsdaten, Spalte

    Hinweis

    Die verfügbaren Eigenschaften hängen von den in der Abfrage angeforderten Feldern ab. Wenn Sie keine Eigenschaften angeben, sind alle Eigenschaften verfügbar. Weitere Informationen finden Sie unter Bereiche, Iterationen und Benutzer.

  2. Die Tabelle enthält nun die erweiterten Felder.

    Screenshot der erweiterten Bereichsspalten.

  3. Wiederholen Sie diesen Vorgang für alle anderen Spalten, die "Record" anzeigen.

Umbenennen von Feldern und Schließen

Optional können die Spalten und die Abfrage umbenannt werden, bevor die Daten geladen werden.

  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. Benennen Sie die Abfrage aus der Standardabfrage1 in etwas aussagekräftiger um, z. B. BugTrends.

    Screenshot der Power BI-Transformationsdaten, Abfrage umbenennen.

  3. 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. In den folgenden Schritten wird davon ausgegangen, dass Sie keine Spalten umbenannt haben.

Screenshot der Auswahl von Power BI-Visualisierungen und -Feldern für den Bericht

  1. Wählen Sie die Liniendiagrammvisualisierung aus.
  2. Add DateValue to X-axis.
    • Klicken Sie mit der rechten Maustaste auf "DateValue" , und wählen Sie "DateValue " anstelle der Datumshierarchie aus. Mithilfe der Datumshierarchie werden Datumsangaben nach Ebene (Jahr, Quartal, Monat, Tag) gruppiert, anstatt jedes Kalenderdatum anzuzeigen.
  3. Status zurLegende hinzufügen.
  4. Hinzufügen Sie Count zu Values.
    • Klicken Sie mit der rechten Maustaste auf das Feld "Anzahl ", und stellen Sie sicher, dass "Summe " ausgewählt ist.

Die folgende Abbildung zeigt einen Beispielbericht über Fehlertrends:

Screenshot des Liniendiagrammberichts

Verwenden von KI zum Erstellen von Power BI OData-Abfragen

Wenn Sie den Azure DevOps MCP-Server konfigurieren, können Sie KI-Assistenten verwenden, um OData-Abfragen für Power BI-Trendberichte zu erstellen.

Beispiel-Prompts

Aufgabe Beispielaufforderung
Erstellen einer Fehlertrendabfrage Write an OData query for Power BI that shows a daily bug count trend grouped by state for <Contoso> project
Nach Bereichspfad filtern Create an OData query that trends work items under the "WebApp" area path in <Contoso> project for use in Power BI
Hinzufügen eines Iterationsfilters Modify my OData trend query to include only the current sprint in <Contoso> project
Nach Priorität gruppieren Write a Power BI OData query that counts bugs grouped by priority and date in <Contoso> project
Beheben von Aktualisierungsfehlern My Power BI OData query is timing out — help me add server-side aggregation to reduce the data returned from <Contoso> project

Nächster Schritt