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:
- Sie müssen Mitglied eines Projekts sein. Wenn Sie noch kein Projekt haben, erstellen Sie ein Projekt. Weitere Informationen finden Sie unter "Registrieren" kostenlos.
- Wenn Sie noch nicht als Projektmitglied hinzugefügt wurden, 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 Zugriff auf Analytics.
- Boards müssen aktiviert sein. Informationen zum erneuten Aktivieren finden Sie unter Aktivieren oder Deaktivieren eines Azure DevOps-Diensts.
- Power BI Desktop Vom Oktober 2018 Update oder höher installiert. Sie können diese Clientanwendung von der offiziellen Power BI Desktop Downloadseite herunterladen.
- Sie haben Arbeitselemente für einen bestimmten Zeitraum nachverfolgt, für den ein Trendbericht generiert werden soll.
- Sie müssen Mitglied eines Projekts sein. Wenn Sie noch kein Projekt haben, erstellen Sie ein Projekt.
- Wenn Sie noch nicht als Projektmitglied hinzugefügt wurden, werden Sie jetzt hinzugefügt. Jeder, der Zugriff auf das Projekt hat, mit Ausnahme der Projektbeteiligten, kann Analyseansichten anzeigen.
- Haben Analytics aktiviert oder installiert. Sie müssen Kontobesitzer oder Mitglied der Gruppe "Projektsammlungsadministratoren" sein, um Erweiterungen hinzuzufügen oder den Dienst zu aktivieren.
- Boards müssen aktiviert sein. Informationen zum erneuten Aktivieren 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 Zugriff auf Analytics.
- Power BI Desktop Vom Oktober 2018 Update oder höher installiert. Sie können diese Clientanwendung von der offiziellen Power BI Desktop Downloadseite herunterladen.
- Sie haben Arbeitselemente für einen bestimmten Zeitraum nachverfolgt, 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 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.
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
, , 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ätsfeld(n).
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.
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.
Der Beispielbericht:
Nächste Schritte
Verwandte Artikel
- Übersicht über Beispielberichte mit OData-Abfragen
- Erstellen von OData-Abfragen für Analytics
- Herstellen einer Verbindung mithilfe von Power BI- und OData-Abfragen
- Metadatenreferenz für Azure Boards Analytics
- Beispielberichte und Kurzübersichtsindex
- Hinzufügen eines Teamdatenschnitts zu einem vorhandenen Bericht