Koppelen aan OData feed

Wanneer de OData (Open Data Protocol) feed vanuit uw BlueDolphin site is geactiveerd is het mogelijk om data op te halen in elke applicatie die OData ondersteund met de mogelijkheid om basic authentication te gebruiken.

In deze instructie laten we dit zien met behulp van Microsoft Power BI Desktop.

1	Open Power BI en kies voor Get Data. Kies voor OData Feed en klik op Connect.
2	Kies voor Basic / Basis en vul deze URL in https://<sitename>.odata.bluedolphin.app. Klik op OK.
3	Klik op OK, het volgende scherm verschijnt:
4	Vul bij Username de naam van de waarde die kan worden gevonden in BlueDolphin, bij Beheer\Algemeen onder Database. Vul bij Wachtwoord de API sleutel die je aangemaakt hebt in of maak een nieuwe API sleutel aan met als scope OData feed. Klik vervolgens op Connect.
5	Het volgende scherm verschijnt. Vink Objects, Relations en Information aan en klik op Load / Laden:
6	De data is nu beschikbaar.
7	Standaard worden in de Objects tabel, alleen de standaard velden van een object getoond, dit vanwege performance van het ophalen van data:
8	Om de volledig set aan data (vragenlijstvelden) op te halen moet de query aangepast worden. Klik in PowerBI op Query's bewerken
9	Selecteer aan de linkerkant in de PowerQuery Editor de tabel Objects:
10	Klik vervolgens in het menu Query op Geavanceerde editor:
11	Pas in het scherm de tekstregel die begint met Source aan naar: Source = OData.Feed("https://<sitename>.odata.bluedolphin.app", null, [MoreColumns=true]), Verwijder overige argumenten in deze regel.
12	Er is nu een kolom MoreColumns bijgekomen. Klik op het icoontje rechts in de kolom:
13	Er kunnen nu kolommen worden geselecteerd die moeten worden getoond. De kolommen hebben een naam conform de syntax: <Vragenlijst>_<Vraag>, waarbij alle spaties verwijderd zijn uit zowel de vragenlijstnaam als de naam van de vraag. Selecteer de kolommen en klik op OK.
14	De geselecteerde kolommen zijn nu beschikbaar:

Informatie over verschillen tussen oudere versies van OData en de huidige versie

1. De URL voor de OData feed is nu: https://<klantnaam>.odata.bluedolphin.app (was voorheen https://odata.bluedolphin.valueblue.nl en https://odata.bluedolphin.valueblue.nl/odata/<klantnaam>). Hierdoor zal in oudere rapporten de connectie opnieuw moeten worden gelegd.
2. De naamgeving van de vragenlijstvelden is aangepast om compliant te zijn met de OData specificatie. Voorheen hadden de veldnamen het formaat <Vragenlijstnaam> - <Vraag naam>. Het formaat wordt straks: <Vragenlijstnaam>_<Vraagnaam>, waarbij tevens ook alle spaties zijn verwijderd. Dit heeft als gevolg dat bestaande queries en rapporten moeten worden aangepast.

Indien ondersteuning nodig is voor de conversie van gebruik van de oude OData feed naar de nieuwe, neem dan contact op via ZenDesk of via de Contact mogelijkheid (via chat) in BlueDolphin.