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.
- 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.
- Aktivieren oder installieren Sie Analytics. Sie müssen Kontobesitzer oder Mitglied der Gruppe "Projektsammlungsadministratoren" sein, um Erweiterungen hinzuzufügen oder den Dienst zu aktivieren.
- Aktivieren sie Boards. Informationen zum erneuten Aktivieren von Boards finden Sie unter Aktivieren oder Deaktivieren eines Azure DevOps-Diensts.
- Lassen Sie die Berechtigung "Analyse anzeigen" auf " Zulassen" festlegen. Siehe Erteilen von Berechtigungen für den Analysezugriff.
- 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:
Wählen Sie "Daten abrufen" und dann "Leere Abfrage" aus.
Wählen Sie im Power BI Query-Editor Erweiterter Editor aus.
Das fenster Erweiterter Editor wird geöffnet.
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
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.
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
, , Iteration
und 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.
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
eineAreaPath
Abschmächung. DieAreaName
Eigenschaft ähnelt dem Knotennamenfeld .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.
Die Tabelle enthält jetzt Entitätsfelder.
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.
Klicken Sie mit der rechten Maustaste auf eine Spaltenüberschrift, und wählen Sie "Umbenennen" aus ...
Möglicherweise möchten Sie die Abfrage auch aus der Standardabfrage1 in einen aussagekräftigeren Namen umbenennen.
Nachdem Sie fertig sind, wählen Sie "Schließen" und "Übernehmen" aus, um die Abfrage zu speichern und zu Power BI zurückzukehren.
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.
Führen Sie für einen einfachen Bericht die folgenden Schritte aus:
- Wählen Sie das Power BI-Visualisierungsliniendiagramm aus.
- Hinzufügen des Felds "DateValue" zur Achse
- Klicken Sie mit der rechten Maustaste auf "DateValue", und wählen Sie "DateValue" anstelle der Datumshierarchie aus.
- Hinzufügen des Felds "Status" zur Legende
- 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:
Nächste Schritte
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