Overslaan en naar hoofdcontent gaan

Power BI verbinden met de REST API

Opmerking: Dit artikel is technisch van aard, dus we raden aan iemand met de juiste technische expertise erbij te betrekken. Als u vragen heeft, kunt u ons te contacteren via support@azumuta.com.

Power BI kan Azumuta-gegevens laden via de REST API. U kunt zelf een query samenstellen of beginnen met een sample template die al verschillende queries bevat.

Als uw Workspace de Reporting-database gebruikt, kan Power BI er ook rechtstreeks verbinding mee maken via de PostgreSQL-connector. Zie Verbinding maken met de Reporting-database.

Voor u begint

  1. Creëer een API-apparaat en kopieer de API Key. Zie Creëren en beheer API Keys.
  2. Zoek de Endpoint die u wilt lezen in de in-app API documentatie. Klik in de Azumuta-app op het vraagteken rechtsboven op uw Scherm en klik vervolgens op API documentatie.

API Keys zijn omgevingsgericht, dus gebruik de URL van dezelfde Azumuta-omgeving waartoe de Key behoort.

Een Query samenstellen in Power BI

  1. Open een nieuw project in Power BI.
  2. Klik op Data ophalen → Lege Query.
  3. Open de geavanceerde 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 aanduidingen:
    • YOUR_AZUMUTA_URL: de URL van uw Azumuta-omgeving.
    • YOUR_ENDPOINT: het Endpoint-pad, bijvoorbeeld v2/products.
    • YOUR_API_KEY: de API Key die u hebt gekopieerd.
  2. Wanneer Power BI om referenties vraagt, kiest u Anoniem en stelt u het privacyniveau in op Organisatie. Power BI heeft hier geen eigen referenties nodig, omdat Azumuta de API Key uit de Request Header leest.
  3. Zet het resultaat om in een Tabel. Klik op de Lijst waarde en klik vervolgens op Naar Tabel.
  4. Klik op het uitbreidingspictogram (⤢) en selecteer de Kolommen die u nodig hebt.
  5. Als u Data van meerdere Endpoints nodig hebt, herhaalt u deze stappen om voor elk één Query te creëren.
  6. Bouw Tabellen en Visuele elementen met de Data.

Belangrijk: De API Key wordt opgeslagen in de Query. Iedereen die het Power BI-bestand kan openen of het gepubliceerde rapport kan aanpassen, kan deze lezen. Behandel het bestand als een referentie en deel het niet buiten uw bedrijf.

Begin met de sample template

Azumuta biedt een sample Power BI template die Data via de REST API laadt en gepagineerde resultaten verwerkt. Neem contact op met support@azumuta.com om deze te verkrijgen.

  1. Creëer een API-apparaat en kopieer de API Key. Zie Creëren en beheer API Keys.
  2. Open de template in Power BI.
  3. Open de Power Query Editor en selecteer elk van de twee Parameters. Werk de Huidige waarde van de API Key parameter bij en stel UrlEnvironment in op de URL van uw eigen omgeving.
  4. Verwijder de Queries die u niet nodig hebt. Elke Query draagt bij aan de laadtijd, dus het behouden van enkel wat u gebruikt maakt het Vernieuwen sneller.
  5. Klik op Sluiten en Toepassen om uw Data te laden.
  6. Creëer relaties tussen de Tabellen en bouw uw Dashboard met de Power BI Visuele elementen.

Gerelateerde artikels