Odata (Open Data Protocol) is een door ISO/IEC goedgekeurde standaard die een set best practices definieert voor het bouwen en gebruiken van REST API’s. OData maakt het mogelijk om REST-gebaseerde services te creëren waarmee bronnen, geïdentificeerd met URL’s en gedefinieerd in een datamodel, kunnen worden gepubliceerd en bewerkt door webclients met behulp van eenvoudige HTTP-berichten.
Middels Odata kan de FCC dus ontsloten worden voor andere rapportagesystemen. Om gegevens uit te kunnen wisselen dient een Odata koppeling geconfigureerd te worden.
Configuratie van Odata
In de FCC kan de Odata koppeling geconfigureerd worden in het de dashboard tab onder de menuknop.
In het configuratiescherm zie je bovenaan de Odata link naar dit portfolio. Verder bestaat de mogelijkheid om verschillende sleutels aan te maken en te verwijderen. Het gebruik van meerdere sleutels is mogelijk als de FCC data wordt uitgewisseld naar verschillende afzonderlijke rapporten of systemen. De toegang van deze rapporten/systemen tot de data van FCC kan middels deze sleutels afzonderlijk beheerd worden. Zo kun je dus een sleutel verwijderen en de toegang van een bepaald rapport tot de FCC data opzeggen, zonder de andere rapporten ook te blokkeren van de FCC data.
Genereren van een sleutel
Klik je op de knop +Sleutel, dan verschijnt een dialoog om een sleutel te genereren. Om een nieuwe sleutel aan te maken voer je een omschrijving in het klik je op de ‘Sleutel toevoegen’.
Nadat je geklikt hebt op ‘Sleutel toevoegen’ krijg je de API-Sleutel te zien. Dit krijg je eenmalig te zien en alleen in dit dialoogvenster.
Configuratie van Odata link in Power BI desktop
Er zijn diverse rapportage-tools die gegevens kunnen ontvangen middels het Odata protocol. Als voorbeeld wordt hieronder beschreven hoe een Odata koppeling tussen de FCC en Microsoft Power BI desktop gemaakt kan worden. Naast Power BI kan de Odata koppeling ook gebruikt worden om een verbinding te maken met andere systemen, zoals data warehousing tools.
- Klik op Gegevens ophalen in een nieuw Power BI rapport en vervolgens op Odata-feed
Plak de Odata-link in het veld URL in de Odata-feed dialoogvenster.
- Klik in het nieuwe dialoogvenster op Basis en plak de API-Sleutel in het Wachtwoord veld. Het gebruikersnaam veld moet leeg blijven.
- Klik vervolgens op ‘Verbinden’. De data wordt vervolgens opgehaald en weergegeven in tabellen in een nieuw dialoogvenster. In dit venster kunt u voorbeelden van elke data tabel bekijken en vervolgens de tabellen selecteren die u wenst te importeren.
- Nadat je de gewenste tabellen met een vinkje links van de tabel hebt geselecteerd, druk je op Laden en wordt de data geladen in het rapport. De tabellen worden niet alleen met data maar ook met een definitie geladen die automatisch de relatie tussen de geïmporteerde tabellen vastgelegd.
‘Error’ velden tijdens het importeren van tabellen
Om de grootte van de data zo laag mogelijk te houden, stuurt de odata service geen lege/null waardes in de odata feed richting de Power BI desktop. Wanneer deze waardes niet meegestuurd worden, verschijnen deze als ‘Error’ in Power BI.
Het verschijnen van deze ‘Error’ is geen probleem omdat Power BI de waarde null toewijst aan velden waar ‘Error’ in staat. Echter, indien gewenst, kunnen deze ‘Error’ velden handmatig aangepast worden door middel van de knoppen ‘Transform Data’ en dan ‘Replace Errors’ om deze error velden te vervangen door een lege string of door de waarde null.
Je kunt nu aan de slag met het creëren van rapporten in Power BI desktop met de data afkomstig uit je portfolio. Als er aanpassingen worden aangebracht in het portfolio, kun je de data in het rapport verversen door te klikken op de knop ‘Vernieuwen’ in het lint op het tabblad Start.
