Naast de Standaard Power BI dashboards van Blue10 is het ook mogelijk om zelf rapportages te maken met de gegevens uit je Blue10 omgeving. Via de Blue10 Odata API kan je de data uit Blue10 gebruiken voor het maken van eigen rapportages in Excel of voor het koppelen van een Business Intelligence/rapportage oplossing die reeds in de organisatie gebruikt wordt. Daarmee is het vanzelfsprekend ook mogelijk om data uit Blue10 te combineren met data uit andere software applicaties, zoals een ERP-/ of boekhoudsysteem.
Blue10 biedt geen ondersteuning aan bij het zelf ontwikkelen van rapporten of dashboards in Power BI of een andere BI- of rapportageoplossing. We laten je wel zien wat je nodig hebt en welke eerste stap je neemt om Power BI of Excel te verbinden met de OData API.
Technische documentatie
Wil je zelf data overhalen naar een datawarehouse, om hier een eigen rapport vaan te maken? In de technische documentatie vind je meer informatie over onder andere de tabellen die in de rapporten te vinden zijn. Bekijk de technische documentatie hier.
Stappenplan
Hieronder vind je een stappenplan om verbinding te maken met de OData API van Blue10. Ongeacht het programma waar je de rapportage mee wil maken, heb je twee dingen nodig:
1. Een URL, waarmee je aangeeft met welke database je wil verbinden: https://odata.blue10.com/api/v1.0
2. Een API Key. Deze gebruik je om de verbinding te leggen tussen de database van Blue10 en het programma waarmee je de rapportage maakt. De API key genereer je zelf in je Blue10 omgeving. Voor deze functionaliteit moet het Blue10 Enterprise abonnement geactiveerd zijn en dien je in Blue10 de rol Beheerder te hebben. Maak je nog geen gebruik van het Blue10 – Enterprise abonnement? Vraag dit dan eerst aan via onderstaand formulier.
Om de API key aan te maken, volg je de volgende stappen:
- Open Blue10 en ga naar Beheer > API Key Management.
- Klik op Nieuwe API key en vul de volgende gegevens in:
– Naam: kies zelf een logische naam voor de API key
– Omschrijving (optioneel): waar gebruik je de key?
– Verloopdatum: de verloopdatum mag maximaal een jaar in de toekomst liggen - Klik op volgende
- De API key verschijnt in beeld. Kopieer deze en zorg dat deze op een veilige plek wordt bewaard. De API key verschijnt maar éénmalig in beeld!
- Klik op bevestigen. De API key verschijnt nu in het overzicht en is nu te gebruiken.
Inlezen Blue10 databasegegevens
Afhankelijk van het programma waarmee je werkt volg je een aantal stappen om de databasegegevens in te lezen via de API key. We geven een voorbeeld voor Power BI en Excel. Gebruik je een andere rapportage-oplossing, dan kun je verbinding maken via de OData API zoals je hier gewend bent. Gebruik hiervoor de URL en OData API key die op te halen is in jullie Blue10 omgeving, zoals hierboven omschreven is.
Excel
1. Open een nieuw document (lege werkmap) in Excel
2. Ga naar Gegevens > Gegevens ophalen > Uit andere bronnen > Uit OData feed
3. Een pop-up verschijnt. Selecteer Basis en voer de volgende URL in: https://odata.blue10.com/api/v1.0 Klik op ok.
4. Er verschijnt een volgende pop-up. Aan de linkerkant staan verschillende opties. Kies voor Basis. Bij Gebruikersnaam vul je een zelfgekozen naam in, bijvoorbeeld “ADMIN”.
Bij wachtwoord vul je de API Key in. Klik op verbinden.
4. Er verschijnt nu een lijst met beschikbare tabellen. Je kunt alles selecteren of een deel waar je mee aan de slag wil.
5. Ga nu verder met het samenstellen van jouw rapport.
Power BI
1. Maak een nieuw Power BI rapport in Power BI Desktop.
2. Ga naar Get data > Blank query
3. Ga naar Advanced Editor (bovenin het menu)
4. Vul het volgende in:
let
url = "https://odata.blue10.com/api/v1.0",
token=Text.Combine({"Bearer ", "vul hier jouw api key in"}),
Source=OData.Feed(url,null,[Headers=[Authorization=token]])
in Source
5. Vraagt het rapport om een privacy methode, klik dan op anoniem.
