Toggle sidebar

Power BI-koppeling instellen

Zo verbind je Power BI Desktop met de Mach3Forms-API. Na deze stappen kun je tabellen op basis van je vragenlijsten en deelnemers gebruiken in een rapport.

Wat je nodig hebt

  • Power BI Desktop (gratis te downloaden)
  • Een API-token uit Mijn profiel → API (zie het hoofdstuk over API-tokens)
  • De basis-URL van je omgeving (https://app.mach3forms.com/api/v1/ of je private label-domein)

Stap voor stap (via de API)

1. Open Power BI Desktop en start een nieuwe rapport

Klik op Bestand → Nieuw.

2. Voeg een gegevensbron toe

  1. Klik op Gegevens ophalen.
  2. Zoek naar Web en kies Verbinden.
  3. Kies Geavanceerd zodat je headers kunt meegeven.

3. Vul URL en headers in

  • URL-onderdeel: https://app.mach3forms.com/api/v1/surveys?include=groups.questions.options
  • HTTP-aanvraagheaderparameters:
    • Header: Authorization - Waarde: Bearer <jouw-token>
    • Header: Accept - Waarde: application/json

Vervang <jouw-token> door het token uit Mach3Forms.

4. Bevestig en haal data op

  1. Klik op OK.
  2. Power BI haalt de JSON op en opent de Power Query Editor.
  3. Werk de geneste structuur (data → records → kolommen) uit met Uitbreiden totdat je de gewenste tabel hebt.
  4. Geef de query een herkenbare naam, bijvoorbeeld "Surveys".
  5. Klik op Sluiten en toepassen.

5. Voeg meer queries toe voor andere endpoints

Herhaal voor de endpoints die je nodig hebt:

  • /api/v1/surveys/{id}/participants?include=answers.question,tags.tag - deelnemers van één vragenlijst met antwoorden
  • /api/v1/blacklist - afmeldingen
  • /api/v1/surveys/{id}/export - CSV-export per vragenlijst

Stap voor stap (via de export-endpoint, eenvoudiger)

Voor een snelle koppeling zonder JSON-transformatie:

  1. Gegevens ophalen → Web in Power BI.
  2. URL: https://app.mach3forms.com/api/v1/surveys/123/export
  3. Geavanceerd, met Authorization: Bearer <token> als header.
  4. Power BI herkent de CSV en stelt automatisch kolommen voor.

Per vragenlijst maak je zo één query aan met directe kolomtoegang.

Token in een parameter

Plaats je token niet hard-coded in elke query. Maak in Power BI een Parameter (MFToken) en verwijs daar overal naar - dan kun je het token op één plek vervangen als het wijzigt.

Veelgestelde vragen

Kies Anoniem. De Bearer-token zit al in de header die je in de geavanceerde optie hebt ingesteld - Power BI's eigen auth-stappen kun je leeg laten.

Gebruik in de Power Query Editor de knop Uitbreiden (de pijltjes-icoon naast een kolom) om geneste lijsten of records uit te klappen. Dat doe je laag voor laag totdat je platte kolommen hebt.

De API gebruikt cursor-paginatie via lazyById, dus grote datasets werken in principe. Power BI laadt ze allemaal in via de query. Voor zeer grote datasets kun je beter de export-endpoint per vragenlijst gebruiken.
Data vernieuwen