TOPdesk koppelen aan Power BI en je Azure datawarehouse
Service management data uit Topdesk
Yres leest TOPdesk uit via de OData-reporting-API van je TOPdesk-omgeving, niet via de gewone REST-API. Je vult het volledige domein van je omgeving in; Yres maakt daar het adres van de reporting-service van. Aanmelden gaat met de loginnaam van een operatoraccount en een applicatiewachtwoord dat je in TOPdesk aanmaakt. Grote resultaten worden pagina voor pagina opgehaald via de OData-nextLink. De data komt in een Azure SQL-database in je eigen Azure-tenant en is daar bruikbaar voor Power BI.
In het kort
- Verbinding
- De OData-reporting-API van TOPdesk (https://<domein>/services/reporting/v2/odata), niet de REST-API onder /tas/api
- Aanmelding
- Basic: de loginnaam van een operatoraccount met een applicatiewachtwoord, niet het gewone wachtwoord
- Rechten in TOPdesk
- Een permissiegroep met de rechten "REST API" en "Use application passwords", plus leesrechten op de gegevens die je wilt ontsluiten
- Domein
- Je vult het volledige domein in, bijvoorbeeld mijnorganisatie.topdesk.net. Yres voegt alleen https:// en het pad van de reporting-service toe
- Paginering
- Automatisch via de @odata.nextLink van de feed
- Waar draait het
- Op de cloud-integration runtime van Azure Data Factory; TOPdesk is een publiek bereikbare clouddienst, dus een self-hosted runtime is niet nodig
- Opslag van aanmeldgegevens
- Je vult ze één keer in; daarna staan ze in de Key Vault van je eigen Azure-omgeving
Wat je zelf regelt
- 1Maak in TOPdesk bij voorkeur een apart operatoraccount aan voor de koppeling.
- 2Geef dat account een permissiegroep met de rechten "REST API" en "Use application passwords" en leesrechten op de gewenste gegevens.
- 3Log in met dat account, open het gebruikersmenu rechtsboven, ga naar Application passwords en kies Add. Sla het wachtwoord meteen op: het wordt maar één keer getoond.
- 4Voeg in Yres de bron Topdesk toe met het volledige domein, de loginnaam van de operator en het applicatiewachtwoord.
Wanneer heb je dit nodig — en wanneer niet
Een losse connector is genoeg als…
Heb je genoeg aan de standaardrapporten en overzichten in TOPdesk zelf, of aan één Power BI-rapport op alleen servicedeskdata, dan is een datawarehouse meer dan je nodig hebt.
Yres voegt iets toe als…
Yres wordt zinvol wanneer servicedeskcijfers naast andere bronnen moeten staan, bijvoorbeeld personeels-, vastgoed- of financiële gegevens bij een gemeente, woningcorporatie of zorginstelling, of wanneer je over langere tijd wilt volgen hoe gegevens in TOPdesk zijn veranderd. Het datawarehouse bewaart daarvoor elke gewijzigde versie.
Veelgestelde vragen: Topdesk
Gebruikt Yres de REST-API of de OData-API van TOPdesk?
De OData-reporting-API. Die levert een feed die Yres pagina voor pagina uitleest. De REST-API onder /tas/api gebruikt Yres niet. Het recht "REST API" is in TOPdesk wel nodig voor het account waarmee de koppeling zich aanmeldt.
Waarom werkt mijn TOPdesk-koppeling niet na het invullen van het domein?
Controleer of je het volledige domein hebt ingevuld, dus mijnorganisatie.topdesk.net en niet alleen mijnorganisatie. Het formulier plakt .topdesk.net er niet achter, waardoor het opgebouwde adres anders niet klopt. Alleen letters, cijfers, punten en koppeltekens zijn toegestaan.
Welk TOPdesk-account heeft Yres nodig?
Een operatoraccount, bij voorkeur één dat alleen voor deze koppeling bestaat. Het account meldt zich aan met een applicatiewachtwoord dat je onder Application passwords aanmaakt. Dat wachtwoord is na het aanmaken niet meer op te vragen; ben je het kwijt, dan maak je een nieuw aan.
Kan ik met Yres trends in servicedeskprestaties over meerdere jaren volgen?
Ja, vanaf het moment dat je begint met laden. Yres bewaart van elke rij die tussen twee laadrondes is gewijzigd de oude en de nieuwe versie. Zo kun je in Power BI terugkijken naar een eerdere stand, ook als TOPdesk zelf alleen de huidige waarde teruggeeft.
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.
