Koppel Power BI aan de REST API

Bijgewerkt

Opmerking: Dit artikel is technisch van aard, dus we raden aan iemand met de juiste technische expertise te betrekken. Als u vragen heeft, neem dan contact op met support@azumuta.com.

Power BI kan Azumuta-gegevens laden via de REST API. U kunt zelf een query bouwen, of beginnen met een voorbeeldsjabloon dat al meerdere queries bevat.

Als uw workspace de reporting database gebruikt, kan Power BI ook direct verbinding maken met deze database via de PostgreSQL-connector. Zie Verbinden met de rapportagedatabase.

Voordat u begint

  1. Maak een API-apparaat aan en kopieer de API-sleutel. Zie Create and manage API keys.
  2. Zoek het endpoint dat u wilt uitlezen in de in-app API-documentatie. In de Azumuta-app klikt u op het vraagteken rechtsboven in uw scherm en vervolgens op API docs.

API-sleutels zijn gebonden aan een omgeving, gebruik dus de URL van dezelfde Azumuta-omgeving waartoe de sleutel behoort.

Bouw een query in Power BI

  1. Open een nieuw project in Power BI.
  2. Klik Get data → Blank query.
  3. Open de Advanced editor en plak de volgende code:
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. Vervang de plaatsaanduiders:
    • YOUR_AZUMUTA_URL: de URL van uw Azumuta-omgeving.
    • YOUR_ENDPOINT: het endpoint-pad, bijvoorbeeld v2/products.
    • YOUR_API_KEY: de API-sleutel die u gekopieerd heeft.
  2. Wanneer Power BI om inloggegevens vraagt, kiest u Anonymous en stelt u het privacyniveau in op Organizational. Power BI heeft hier geen eigen inloggegevens nodig, omdat Azumuta de API-sleutel uit de request-header leest.
  3. Zet het resultaat om naar een tabel. Klik op de waarde List, klik vervolgens op To Table.
  4. Klik op het uitvouwpictogram (⤢) en selecteer de kolommen die u nodig heeft.
  5. Als u gegevens van meerdere endpoints nodig heeft, herhaal dan deze stappen om voor elk endpoint een query te maken.
  6. Bouw tabellen en visuals met de gegevens.

Belangrijk: De API-sleutel wordt in de query opgeslagen. Iedereen die het Power BI-bestand kan openen, of het gepubliceerde rapport kan bewerken, kan deze sleutel lezen. Behandel het bestand als inloggegevens en deel het niet buiten uw bedrijf.

Begin met het voorbeeldsjabloon

Azumuta biedt een voorbeeld Power BI-sjabloon dat gegevens laadt via de REST API en gepagineerde resultaten afhandelt. Om het te verkrijgen, neemt u contact op met support@azumuta.com.

  1. Maak een API-apparaat aan en kopieer de API-sleutel. Zie Create and manage API keys.
  2. Open het sjabloon in Power BI.
  3. Open de Power Query Editor en selecteer elk van de twee parameters. Werk de huidige waarde van de parameter voor de API-sleutel bij en stel UrlEnvironment in op de URL van uw omgeving.
  4. Verwijder de queries die u niet nodig heeft. Elke query verhoogt de laadtijd; houd daarom alleen de queries die u gebruikt, zodat het verversen sneller gaat.
  5. Klik Close & Apply om uw gegevens te laden.
  6. Maak relaties tussen de tabellen en bouw uw dashboard met de Power BI-visuals.

Gerelateerde artikelen

Op deze pagina