Verbinden Sie Power BI mit der REST-API

Aktualisiert

Hinweis: Dieser Artikel ist technisch, daher empfehlen wir, jemanden mit entsprechender technischer Fachkompetenz hinzuzuziehen. Bei Fragen kontaktieren Sie uns unter support@azumuta.com.

Power BI kann Azumuta-Daten über die REST API laden. Sie können eine Abfrage selbst erstellen oder mit einer Beispielvorlage beginnen, die bereits mehrere Abfragen enthält.

Wenn Ihr Arbeitsbereich die Reporting-Datenbank verwendet, kann Power BI auch direkt mit dem PostgreSQL-Connector darauf zugreifen. Siehe Mit der Reporting-Datenbank verbinden.

Bevor Sie beginnen

  1. Erstellen Sie ein API-Gerät und kopieren Sie dessen API-Schlüssel. Siehe Erstellen und Verwalten von API-Schlüsseln.
  2. Suchen Sie den Endpoint, den Sie auslesen möchten, in den In-App-API-Dokumentationen. Klicken Sie in der Azumuta-App oben rechts auf das Fragezeichen und dann auf API docs.

API-Schlüssel sind umgebungsgebunden; verwenden Sie daher die URL derselben Azumuta-Umgebung, zu der der Schlüssel gehört.

Abfrage in Power BI erstellen

  1. Öffnen Sie ein neues Projekt in Power BI.
  2. Klicken Sie Get data → Blank query.
  3. Öffnen Sie den Advanced editor und fügen Sie den folgenden Code ein:
let
  Source =
    Json.Document(
      Web.Contents(
        "https://YOUR_AZUMUTA_URL",
        [
          RelativePath = "api/YOUR_ENDPOINT",
          Headers = [
            #"x-api-key" = "YOUR_API_KEY",
            #"Accept" = "application/json"
          ]
        ]
      )
    )
in
  Source
  1. Ersetzen Sie die Platzhalter:
    • YOUR_AZUMUTA_URL: die URL Ihrer Azumuta-Umgebung.
    • YOUR_ENDPOINT: der Endpoint-Pfad, zum Beispiel v2/products.
    • YOUR_API_KEY: der API-Schlüssel, den Sie kopiert haben.
  2. Wenn Power BI nach Anmeldeinformationen fragt, wählen Sie Anonymous und setzen Sie das Datenschutzniveau auf Organizational. Power BI benötigt hier keine eigenen Zugangsdaten, weil Azumuta den API-Schlüssel aus dem Anforderungs-Header liest.
  3. Konvertieren Sie das Ergebnis in eine Tabelle. Klicken Sie den Wert List an und dann To Table.
  4. Klicken Sie auf das Erweitern-Symbol (⤢) und wählen Sie die benötigten Spalten aus.
  5. Wenn Sie Daten von mehreren Endpoints benötigen, wiederholen Sie diese Schritte, um für jeden eine Abfrage zu erstellen.
  6. Erstellen Sie Tabellen und Visualisierungen mit den Daten.

Wichtig: Der API-Schlüssel wird in der Abfrage gespeichert. Jede Person, die die Power BI-Datei öffnen oder den veröffentlichten Bericht bearbeiten kann, kann ihn lesen. Behandeln Sie die Datei wie Anmeldeinformationen und geben Sie sie nicht außerhalb Ihres Unternehmens weiter.

Starten mit der Beispielvorlage

Azumuta bietet eine Beispiel-Power-BI-Vorlage an, die Daten über die REST API lädt und paginierte Ergebnisse verarbeitet. Um sie zu erhalten, kontaktieren Sie support@azumuta.com.

  1. Erstellen Sie ein API-Gerät und kopieren Sie dessen API-Schlüssel. Siehe Erstellen und Verwalten von API-Schlüsseln.
  2. Öffnen Sie die Vorlage in Power BI.
  3. Öffnen Sie den Power Query Editor und wählen Sie nacheinander beide Parameter aus. Aktualisieren Sie den aktuellen Wert des API-Schlüssel-Parameters und setzen Sie UrlEnvironment auf die URL Ihrer eigenen Umgebung.
  4. Löschen Sie die Abfragen, die Sie nicht benötigen. Jede Abfrage erhöht die Ladezeit; behalten Sie nur, was Sie tatsächlich verwenden, um die Aktualisierung zu beschleunigen.
  5. Klicken Sie auf Close & Apply, um Ihre Daten zu laden.
  6. Erstellen Sie Beziehungen zwischen den Tabellen und bauen Sie Ihr Dashboard mit den Power BI-Visualisierungen.

Verwandte Artikel