Handleiding Power BI-koppeling

Koppel Power BI in een paar minuten aan je KPI-data in Normly.

Voordat je begint

✅ Wat je nodig hebt:
  • Power BI Desktop, geïnstalleerd
  • Een geldig Normly-gebruikersaccount
  • API-toegang voor je bedrijf (per bedrijf aangezet, op verzoek: neem contact op met Matso) en je API-token
  • Het ID van de tabel die je wilt koppelen
💡 Aanbevolen endpoint:
/api/tables/{id}/data/
Dit endpoint levert platgeslagen data die precies past bij Power BI-visualisaties.

Stap voor stap koppelen

1 Open Power BI en haal gegevens op

  1. Open Power BI Desktop
  2. Klik in het lint op Gegevens ophalen (Get Data)
  3. Kies Web in de lijst
  4. Klik op Verbinding maken (Connect)
Tip: je kunt ook de REST API-connector gebruiken onder "Onlineservices".

2 Vul de API-URL in

Vul in het dialoogvenster de URL van je Normly-API in:

https://matso.nl/api/tables/YOUR_TABLE_ID/data/

Vervang "YOUR_TABLE_ID" door het ID van de tabel die je wilt koppelen.

Tabel-ID's vinden: bekijk de API-documentatie of vraag je beheerder.

3 Stel de authenticatie in

Klik op Geavanceerd (Advanced) en voeg de authenticatie toe:

Parameters voor HTTP-aanvraagheader
Authorization
Token YOUR_API_TOKEN_HERE
Belangrijk: zet het woord "Token" voor de waarde van je token.

4 Verbinden en transformeren

  1. Klik op OK om verbinding te maken
  2. Power BI laadt een voorbeeld van je data
  3. Klik op Gegevens transformeren (Transform Data) als je iets wilt aanpassen
  4. Of klik op Laden (Load) om direct te importeren
Veelgebruikte transformaties
  • Tekst omzetten naar getallen
  • Datumvelden omzetten
  • Filteren op status = "approved"
  • Overbodige kolommen verwijderen

De structuur van je data

Het endpoint /data/ geeft platgeslagen data terug met deze standaardvelden:

Systeemvelden
  • id - unieke identificatie van de rij
  • table_name - naam van de KPI-tabel
  • status - goedkeuringsstatus (approved, pending, enz.)
  • created_at - wanneer de data is ingediend
  • created_by_email - wie de data heeft ingediend
  • approved_at - wanneer de data is goedgekeurd
  • approved_by_email - wie de data heeft goedgekeurd
Eigen velden:

De eigen kolommen van je tabel verschijnen als extra velden:

  • Employee Name
  • Monthly Sales
  • Region
  • Target Met
  • ...en alle andere kolommen die je hebt gedefinieerd

Tips voor Power Query

Datumvelden:
= Table.TransformColumnTypes(Source,{
    {"created_at", type datetimezone},
    {"approved_at", type datetimezone}
})
Alleen goedgekeurde rijen:
= Table.SelectRows(Source,
    each [status] = "approved")
Getallen omzetten:
= Table.TransformColumnTypes(Source,{
    {"Monthly Sales", type number},
    {"Target", type number}
})
Berekende kolom toevoegen:
= Table.AddColumn(Source,
    "Days Ago",
    each Duration.Days(
        DateTime.LocalNow() - [created_at]
    ))

Meerdere tabellen koppelen

Zo koppel je meerdere KPI-tabellen:

  1. Maak voor elke tabel een aparte query
  2. Gebruik in de URL's verschillende tabel-ID's
  3. Geef elke query een duidelijke naam (bijv. "Verkoopdata", "Marketing-KPI's")
  4. Leg in de modelweergave relaties via gemeenschappelijke velden
Pro-tip: tabellen met dezelfde structuur kun je in Power Query ook samenvoegen met Table.Combine().

Gegevensvernieuwing instellen

In Power BI Desktop:
  1. Ga naar Bestand → Opties en instellingen → Instellingen voor gegevensbron
  2. Kies je Normly-API-bron
  3. Klik op Machtigingen bewerken
  4. Werk zo nodig de referenties bij
In de Power BI-service (na publiceren):
  1. Ga naar je werkruimte
  2. Zoek je semantisch model (dataset)
  3. Klik op Instellingen → Geplande vernieuwing
  4. Stel de vernieuwingsfrequentie in
  5. Voeg je API-token toe aan de referenties van de gegevensbron

Veelvoorkomende problemen en oplossingen

❌ "Kan geen verbinding maken"
  • Controleer je internetverbinding
  • Controleer of de URL klopt
  • Controleer of de server bereikbaar is
❌ "401 Unauthorized"
  • Controleer het tokenformaat: "Token abc123..."
  • Controleer of het token geldig is
  • Vraag een bedrijfsbeheerder om een nieuw token: die maakt het aan onder Bedrijf → API-tokens
❌ "403 Forbidden"
  • Je hebt geen toegang tot deze tabel
  • Vraag je beheerder om je als lezer of invoerder toe te voegen
  • Probeer een ander tabel-ID
❌ "Er wordt geen data getoond"
  • De tabel is misschien leeg
  • Misschien wacht alle data nog op goedkeuring
  • Controleer het statusfilter in Power Query

Hulp nodig?

Lukt het niet om Power BI aan je Normly-data te koppelen? We helpen je graag!

Neem contact op met support
API-documentatie