Wanneer je dashboards wilt bouwen op basis van gegevens uit Remindo, kun je dat doen met business intelligence-tools zoals Power BI. Deze tools bieden de mogelijkheid om verbinding te maken met een API, zodat je gegevens uit Remindo in Power BI kunt importeren om goede dashboards en inzichten te creëren. Door Power BI aan een API toe te voegen, open je een wereld aan mogelijkheden voor real-time data-analyse, waarmee je dashboards kunt bouwen die automatisch worden bijgewerkt met de nieuwste informatie.
Deze handleiding leidt je stap voor stap door het proces van het verbinden van de Remindo API met Power BI, het transformeren van de gegevens en het bouwen van een dynamisch datamodel.
Tip!
Als je de Remindo API aan Power BI wilt toevoegen, moet je de API eerst in Remindo instellen. Zie het artikel 'API' voor meer informatie over het instellen van de API.
Waarom Power BI koppelen aan de API?
Het rechtstreeks verbinden met de Remindo API in plaats van te vertrouwen op handmatige CSV- of Excel-exports biedt diverse voordelen. Het belangrijkste voordeel is toegang tot live data zonder handmatige handelingen. Rapporten en dashboards kunnen direct weergeven wat er op dit moment gebeurt, waardoor belanghebbenden de meest actuele inzichten krijgen zonder dat iemand constant bestanden hoeft te downloaden en te vernieuwen.
Deze methode automatiseert ook dataworkflows. Zodra de verbinding is ingesteld, kan Power BI geplande vernieuwingen afhandelen, waardoor dit talloze uren bespaart.
Bovendien zijn moderne BI-tools ontworpen om API-data te verwerken, waardoor naast Remindo ook informatie uit diverse andere bronnen kunt halen – zoals andere Paragin-producten zoals Skillsly of OnStage, maar ook CRM-systemen, financiële platforms of studentinformatiesystemen – rechtstreeks in één centrale rapportagehub.
Wat heb je nodig?
De volgende items zijn nodig voordat je begint.
- Power BI Desktop: Deze handleiding is gebaseerd op de (gratis) desktopversie van Power BI. Deze moet op je computer geïnstalleerd zijn.
- API-URL (eindpunt): Dit is het webadres waarnaar je een verzoek stuurt. Het is de locatie van de gegevens die je wilt ophalen. Deze URL vind je wanneer je een API instelt in Remindo.
- Authenticatiegegevens: Veel API's, waaronder de API van Remindo, vereisen authenticatie om gegevens te beschermen. De meest gebruikelijke methode is een API-sleutel of een OAuth-token. Deze vind je ook in de accountinstellingen van Remindo.
- API-documentatie: Dit is het belangrijkste hulpmiddel. Goede documentatie legt uit welke URL je moet gebruiken (het eindpunt), welke authenticatie vereist is, hoe de gegevens zijn gestructureerd, welke API-aanroepen beschikbaar zijn, enzovoort. Lees altijd eerst de documentatie!
Stap-voor-stap instructie
We doorlopen het hele proces, van het leggen van de eerste verbinding tot het omzetten van de gegevens in een bruikbare tabel.
-
Open Power BI en selecteer 'Get data' van 'Web'
Start eerst Power BI Desktop. Ga in het hoofdmenu bovenaan naar het tabblad 'Home'. Klik op 'Get data' en selecteer 'Web' in het drop-down menu.
Hiermee open je het venster 'From Web', waarin je Power BI kunt laten weten waar de gegevens zich bevinden.
-
Voer de API-URL in en configureer de verbinding
Je ziet een venster met de opties 'Basic' en 'Advanced'. Voor de Remindo API is de optie "Advanced" voldoende.
- Selecteer de radiobutton 'Advanced'.
- Plak in het gedeelte 'URL parts' de URL van de hoofd API.
- Onder 'HTTP request header parameters' moeten de authenticatiegegevens toegevoegd worden. Veelgebruikte headers voor API-sleutels zijn Authorization of X-API-Key.
Klik op 'OK' nadat de gegevens zijn toegevoegd. Power BI verzendt het verzoek vervolgens veilig en opent, indien succesvol, de Power Query-editor.
-
Navigeer en transformeer de respons in de Power Query
Zodra de verbinding tot stand is gebracht, kom je terecht in de Power Query-editor. API responses worden meestal weergegeven in een JSON-formaat (JavaScript Object Notation), dat is weliswaar machine-leesbaar, maar vormt geen overzichtelijke tabel. De gewenste actie is om in de Power Query deze geneste gegevens om te zetten in nette rijen en kolommen.
Op uw scherm zie je waarschijnlijk één kolom met een lijst van 'Records'.
Converteren naar tabel
De eerste stap is meestal om deze lijst om te zetten in een tabel. In het bovenste menubalk is het tabblad 'Transform' zichtbaar. Selecteer de kolom in de lijst en klik op 'To table'. Er verschijnt een klein venster; klik op 'OK' en de standaardinstellingen worden gebruikt.
De kolom met 'records' uitbreiden
Er is nu een tabel met één kolom, waarschijnlijk genaamd 'Column 1', en elke cel toont 'Record'. Dit betekent dat elk 'record' meerdere velden bevat (zoals gebruikers-ID, ID, titel, enz.). Om deze te bekijken, moeten we de kolom uitbreiden.
- Klik op het uitbreidingspictogram (twee pijlen die in tegengestelde richting wijzen) in de koptekst van die kolom.
- Er verschijnt een keuzelijst met alle beschikbare velden in de records. Standaard zijn alle velden geselecteerd.
- Schakel de optie 'Use original column name as prefix' uit. Dit zorgt voor nettere kolomnamen.
-
Klik op 'OK'.
De enkele kolom wordt uitgebreid naar meerdere kolommen, waarbij elk veld uit de API-response nu in een eigen kolom staat. Je hebt nu een volwaardige tabel waarmee je kunt werken.
Opschonen en gegevenstypen instellen
Voordat je de gegevens laadt, voer eerst een paar opschoonstappen uit. Klik met de rechtermuisknop op de kolomkoppen om ze, indien gewenst, een gebruiksvriendelijkere naam te geven.
Controleer vervolgens de gegevenstypen. Power BI doet een goede inschatting, maar er moet gecontroleerd worden of getallen als getallen, datums als datums en tekst als tekst worden weergegeven. Je kunt het gegevenstype van een kolom wijzigen door op het pictogram (bijvoorbeeld "ABC", "123") in de kolomkop te klikken.
-
Laad gegevens in het model
Zodra je tevreden bent met de tabel in de Power Query, is het tijd om deze in je Power BI-gegevensmodel te laden, zodat er visualisaties gemaakt kunnen worden.
Ga naar het tabblad 'Home' in het Power Query menu en klik op 'Close & Apply'. Hiermee sluit de editor en laad je de zojuist opgeschoonde tabel in Power BI. Je ziet je gegevensvelden nu in het deelvenster 'Data' aan de rechterkant, klaar om te worden versleept naar grafieken en rapporten.
Aanvullende tips voor het werken met API's
Verbinding maken met een API is slechts het begin. Hier volgen enkele tips voor het omgaan met veelvoorkomende API-uitdagingen in de praktijk.
Paginering afhandelen
De Remindo API koppelt niet al uw gegevens in één verzoek terug. In plaats daarvan worden de gegevens opgedeeld in 'pagina's', waarbij vaak een beperkt aantal resultaten tegelijk wordt weergegeven, samen met een link naar de 'volgende pagina'. Om dit in Power BI te verwerken, moet een aangepaste functie in Power Query gemaakt worden die de API herhaaldelijk aanroept totdat er geen pagina's meer over zijn. Dit is een geavanceerde techniek, maar essentieel voor het ophalen van complete datasets uit grote bronnen.
Parameters gebruiken voor dynamische URL's
Wat als je een deel van de API-URL dynamisch wilt wijzigen, zoals een datumbereik of een product-ID? In plaats van de query handmatig te bewerken, kun je de Power Query-parameters gebruiken. Ga in de Power Query-editor naar 'Home' > 'Manage Parameters'.
Je kunt een parameter maken (bijvoorbeeld met de naam `StartDate`) en deze vervolgens in de bron-URL opnemen. Hierdoor kunnen gebruikers de parameter in Power BI wijzigen zonder de querycode te hoeven aanpassen.
Denk eraan om binnen de limieten te blijven
De meeste API's beperken het aantal verzoeken dat in een bepaalde tijd gedaan kunnen worden (bijvoorbeeld 10 verzoeken per seconde). Houd hier rekening mee bij het instellen van automatische vernieuwingen. Als je een complex rapport met veel API-aanroepen te vaak vernieuwt, kun je tijdelijk geblokkeerd raken.
Tot slot
Het koppelen van Power BI aan de API is een interessante optie die rapportages transformeert van momentopnamen en handmatige exporten naar dynamische, geautomatiseerde inzichten en dashboards.
Door de webconnector en de Power Query-editor te beheersen, kun je gegevens uit Remindo ophalen en combineren met andere toepassingen of gegevensbronnen, zodat beslissingen altijd gebaseerd zijn op de meest actuele informatie.