Template-interfaces

Een Template is de blauwdruk voor een integratie tussen twee systemen.

Een Template-interface is het eindproduct van die blauwdruk: een integratie die aan het werk is.

Bij BrynQ bepalen we vooraf hoe twee systemen met elkaar verbonden moeten worden. Het resultaat is een Template, die de structuur en regels vastlegt die ervoor zorgen dat data correct van een bronsysteem naar een doelsysteem stroomt.

Een Template-interface is de live versie van die Template: deze verbindt jouw specifieke systemen en doet het eigenlijke werk van data tussen die systemen verplaatsen. Omdat de interface is gebouwd op een geteste blauwdruk, volgt hij vanaf dag één een bewezen standaard. BrynQ biedt de mogelijkheid om deze interface af te stemmen op de wensen van een specifieke organisatie.

Voorbeeld van een Template:
De Template HiBob - Nmbrs | Employee Data legt vast hoe medewerkergegevens van HiBob naar Nmbrs moeten gaan.

De interface die daarop is gebouwd en aan jouw systemen is gekoppeld, weet vervolgens hoe die gegevens gesynchroniseerd worden (naam, geboortedatum, BSN en meer).

Maatwerk

Afhankelijk van je inrichting kun je een Template-interface afstemmen op je specifieke wensen. Je kunt bijvoorbeeld custom velden gebruiken of aanpassen hoe bepaalde velden gemapt worden.

Hoeveel je kunt aanpassen, hangt af van je abonnement: over het algemeen geldt: hoe hoger het abonnement, hoe meer vrijheid je hebt om je interface verder dan de standaardinstellingen aan te passen en te verfijnen.

Let op: hoe meer maatwerk, hoe kleiner de kans dat alles direct werkt en hoe intensiever er getest moet worden.

Aan de slag

1. Je interface aanmaken

Ga naar Interfaces en klik op New Interface.
Kies de optie template-based.
Zoek en kies een template die past bij je bron- en doelapp.

Na het aanmaken kom je in de interface setup. Nieuwe template-interfaces starten als draft.

Als de benodigde apps nog niet actief zijn, vraagt BrynQ je om ze eerst te activeren. Ook kun je tegen de limieten van je abonnement voor interfaces of apps aanlopen. Je BrynQ-contactpersoon helpt je daar graag bij!

2. De onderdelen van de setup doorlopen

Doorloop de onderdelen die voor je interface worden getoond.
Niet elke template bevat elk onderdeel: dat hangt af van de template en je abonnement.

Een gebruikelijke volgorde:

Configuration: beantwoord de setupvragen voor deze template (bedrijfsinstellingen, voorkeuren, enzovoort).
Scenarios: bekijk welke data wordt uitgewisseld en hoe velden tussen de twee systemen worden gemapt.
Data filters: beperk indien nodig welke records worden meegenomen.
Authorization: koppel de inloggegevens van je bron- en doelapp. De interface kan pas draaien als dit is afgerond.
Logging & monitoring: stel in hoe runs worden gelogd en gemonitord.

Los validatiewaarschuwingen op voordat je publiceert; onderdelen met problemen worden meestal gemarkeerd in de header van de interface. Wijzigingen in een draft worden automatisch opgeslagen.

3. Publiceren

Als de setup klaar is, publiceer je de draft om de interface live te zetten. Tot die tijd is de interface niet klaar voor productie. Afhankelijk van je template kan plannen pas beschikbaar zijn na het publiceren.

4. Draaien en monitoren

Vanuit het interface-overzicht kun je:

Handmatig draaien: handig voor een eerste test.
Een planning instellen: draai op een vast tijdstip of na een andere interface, zodra plannen beschikbaar is.
Runs bekijken: controleer na elke run de status, logs en fouten.
Variabelen opgeven: sommige interfaces vragen bij elke start om runspecifieke waarden, bijvoorbeeld op welke medewerkers gefilterd moet worden. Je wordt hierom gevraagd wanneer de run begint.

De manier waarop Template-interfaces in de BrynQ-app worden ingericht, wordt continu verbeterd. Sommige details kunnen dus in de loop van de tijd veranderen.