Simplicate-data naar Power BI en je Azure datawarehouse
Projecten & uren uit Simplicate
Yres haalt data uit Simplicate op via de Simplicate REST API. Je geeft alleen de naam van je Simplicate-omgeving op; Yres bouwt daarmee het API-adres. Aanmelden gebeurt met een Authentication-Key en een Authentication-Secret uit Simplicate, die bij elke aanroep als twee headers worden meegestuurd. De resultaten worden in blokken opgehaald met offset en limit. Alles landt in een Azure SQL-database in je eigen Azure-tenant, waar je Simplicate combineert met je andere bronnen voor Power BI.
In het kort
- Verbinding
- Simplicate REST API (versie 2) op https://<omgeving>.simplicate.app/api/v2/. Het adres wordt opgebouwd uit de naam van je omgeving
- Aanmelding
- Twee headers: Authentication-Key en Authentication-Secret, samen één API-key uit Simplicate
- Rechten
- Een API-key is in Simplicate gekoppeld aan een gebruiker en erft diens rechten
- Paginering
- Offset en limit. Dit staat vast; je hoeft er niets voor in te stellen
- Techniek
- Simplicate heeft een eigen invulformulier in Yres; daaronder draait de generieke REST-koppeling met vaste instellingen
- Waar draait het
- Op de cloud-integration runtime van Azure Data Factory. Simplicate is via HTTPS bereikbaar, dus een self-hosted runtime is niet nodig
- Opslag van key en secret
- In de Key Vault van je eigen Azure-omgeving; de koppeling verwijst daarnaar
Wat je zelf regelt
- 1Zorg voor een Simplicate-account dat API-keys mag aanmaken en dat de gegevens mag zien die je wilt ontsluiten.
- 2Ga in Simplicate naar Instellingen → API en klik rechtsboven op Nieuw. Je krijgt een Authentication-Key en een bijbehorend Authentication-Secret.
- 3Lees de naam van je omgeving af uit de adresbalk: in https://mijnorganisatie.simplicate.nl is dat mijnorganisatie.
- 4Voeg in Yres de bron Simplicate toe met die naam, de key en het secret.
Wanneer heb je dit nodig — en wanneer niet
Een losse connector is genoeg als…
Stuur je als bureau alleen op uren, projecten en bezetting binnen Simplicate, dan geven de rapportages in Simplicate zelf dat inzicht al.
Yres voegt iets toe als…
Yres wordt zinvol zodra uren en projecten uit Simplicate naast je boekhouding, salarisadministratie of begrotingen in Excel moeten staan, of wanneer je wilt zien hoe projectgegevens in de loop van de tijd zijn bijgesteld. Simplicate laat de huidige waarde zien; het datawarehouse houdt de eerdere versies vast.
Veelgestelde vragen: Simplicate
Wat vul ik in bij de domeinnaam van Simplicate?
Alleen de naam van je omgeving, zonder https:// en zonder .simplicate.nl. Log je in op https://mijnorganisatie.simplicate.nl, dan vul je mijnorganisatie in. Yres maakt daar zelf het API-adres van, op het domein simplicate.app.
Welke Simplicate-gegevens kan de koppeling zien?
Wat de gebruiker achter de API-key mag zien. Een API-key hangt in Simplicate aan een gebruiker en neemt diens rechten over. Maak de key daarom aan onder een gebruiker met toegang tot de gegevens die je in je rapportage wilt gebruiken.
Heeft Yres een eigen Simplicate-connector?
Deels. Simplicate heeft in Yres een eigen formulier met drie velden, zodat je geen adressen of pagineringsinstellingen hoeft uit te zoeken. Onder dat formulier draait de generieke REST-koppeling, met het Simplicate-adres, de twee aanmeldheaders en de paginering al ingevuld.
Hoe haalt Yres grote hoeveelheden uren- of projectregels op?
In blokken. Yres vraagt de Simplicate-API steeds om een volgend blok met een offset en een limit, totdat er geen regels meer terugkomen. Deze manier van pagineren ligt vast voor Simplicate; je stelt alleen in wat je wilt laden en hoe vaak.
Volledige technische beschrijving in de kennisbank →·Laatst gecontroleerd:
Datawarehouse-automatisering die in je eigen Azure draait
Gebouwd voor organisaties op Azure en Power BI. Yres koppelt je bronnen, bewaart de historie en rolt wijzigingen gecontroleerd uit, zonder handwerk.
