Zo maak je een custom connector in Google Application Integration

Google Cloud Application Integration is een krachtig platform om applicaties te bouwen die verbinding maken met allerlei databronnen en API's. Voor wie Google Cloud al gebruikt, is Application Integration een logische uitbreiding die op dezelfde infrastructuur draait.

Je ontwikkelt er snel mee in een low-code/no-code-omgeving, met schaalbaarheid, beveiliging en sterke authenticatie. Daardoor kun je koppelingen invoeren zonder je bedrijfsprocessen veel te verstoren.

Google heeft kant-en-klare connectors voor veel populaire applicaties, maar soms zijn je behoeften uniek. Dan heb je een custom connector nodig.

In dit artikel laten we zien hoe je zo'n connector maakt in Google Cloud Application Integration. Als voorbeeld gebruiken we de connector voor Exact Online HR, die we hebben gebouwd om het wervingsproces bij Crystalloids te stroomlijnen.

Wat is een custom connector in Google Cloud Application Integration?

Google Cloud Application Integration heeft meer dan 180 kant-en-klare connectors voor diensten van Google en andere applicaties. Met custom connectors kun je daarnaast met elke willekeurige applicatie koppelen. Connectors werken als bruggen: ze verbinden je applicaties met externe databronnen, diensten en API's.

Met de functie voor custom connectors in het iPaaS van Google kun je connectors gebruiken die niet in het standaardaanbod zitten.

Heeft je eigen HR-systeem of projectmanagementtool bijvoorbeeld een eigen protocol, dan kun je het via een connector in Application Integration opnemen. Deze functie is handig als er geen ingebouwde connector is of als die niet aan je eisen voldoet.

Integration Connectors ondersteunen custom connectors via OpenAPI versie 3.0, zodat je verbinding maakt met je backend. Die specificatie legt het contract vast tussen Integration Connectors en het endpoint, en daarmee verloopt de koppeling efficiënt.

Use case voor een custom connector: Crystalloids en Exact Online HR

Bij Crystalloids hebben we een custom connector gemaakt voor Exact Online HR, populaire cloudsoftware voor boekhouding en ERP. Met deze connector koppelen we onze applicaties aan Exact Online HR, zodat data efficiënt wordt uitgewisseld en gesynchroniseerd.

Customer connector voor Exact Online HR in Google Cloud Application Integration

Om ons wervingsproces te stroomlijnen, hebben we met Application Integration meerdere systemen realtime gekoppeld, zodat ze data op dezelfde manier uitwisselen. De systemen die we koppelden waren HubSpot, Jira, BigQuery, Cloud Storage en Document AI, en daarvoor was een custom connector voor Exact Online HR nodig.

Zo hebben we het aangepakt:

• HubSpot: We hebben HubSpot gekoppeld om sollicitanten via onze website binnen te halen.
• Jira: We hebben Jira gekoppeld om voor elke sollicitant taken op ons bord aan te maken en bij te werken.
• BigQuery: We gebruikten BigQuery om HR-data bij te werken en analyses te doen.
• Cloud Storage: We uploadden cv's en motivatiebrieven als pdf naar Cloud Storage.
• Document AI: We gebruikten Document AI om de belangrijkste informatie uit de ingediende documenten te halen.

De custom connector voor Exact Online HR zorgde ervoor dat een aangenomen kandidaat in het systeem werd gezet: hij vulde de persoonsgegevens in, wijzigde de profielfoto, vulde team en functie in en uploadde de sollicitatiebestanden (cv en motivatiebrief) naar het systeem. De custom connector kan nog veel meer, maar dit zijn de functies die wij in ons geval gebruikten.

Deze koppeling stroomlijnde ons wervingsproces: datastromen zijn geautomatiseerd, er hoeft minder data met de hand te worden ingevoerd en systemen worden realtime bijgewerkt. Deze aanpak maakte ons werk efficiënter en gaf ons nauwkeuriger en sneller inzicht in ons bedrijf.

Werkt je bedrijf met veel applicaties en komen er nog meer bij? Bekijk ons on-demand webinar over Google Application Integration, een tool waarmee je applicaties visueel koppelt zonder ingewikkelde code. Het vereenvoudigt koppelingen tussen diensten van Google Cloud en SaaS van derden, met kant-en-klare en custom connectors, serverless functionaliteit en automatisch schalen.

Stappenplan: een custom connector maken voor Exact Online HR

Is de OpenAPI-specificatie van de Officient API goed gedocumenteerd, dan kun je die direct gebruiken om custom connectors te maken.

In ons geval moesten we een facade maken, omdat de OpenAPI-specificatie van de OfficientAPI (ExactHR) niet goed gedocumenteerd was. De verplichte velden, het schema voor een geslaagde respons en het schema voor een foutrespons waren niet duidelijk vastgelegd, waardoor het lastig werken was met de foutafhandeling.

Een facade maken heeft voordelen, omdat je er meer logica aan de applicatie mee kunt toevoegen. Onze facade is een API die we bovenop de OfficientAPI hebben gebouwd. Hij legt alle velden vast die nodig zijn om een volledig werkende custom connector voor Application Integration te maken.

Deze facade is uitgerold in een Cloud Run-component met een eigen OpenAPI-specificatie, zodat we de custom connector konden maken.

Stap 1: Maak de custom connector

De eerste stap is de custom connector maken door de URL van de OpenAPI-specificatie van onze API op te geven (de facade die we hebben gemaakt en in Cloud Run hebben uitgerold).

Stap 2: Maak een verbinding

Is de custom connector gemaakt, dan moeten we een verbinding maken met de inloggegevens die toegang geven tot de custom connector.

Stap 3: Gebruik de verbinding in Google Application Integration

Staat de verbinding, dan kunnen we hem in Application Integration gebruiken. Alle endpoints uit de OpenAPI-specificatie zijn bereikbaar met de taak "connector".

Stap 4: Laat de benodigde variabelen aanmaken

Als je een actie kiest, worden de benodigde variabelen automatisch aangemaakt.

Stap 5: Vul de velden van het endpoint in

Vul, afhankelijk van het endpoint dat je wilt gebruiken, de verplichte velden (header, body en queryparameters) in met de taak voor datamapping.

Met deze stappen en best practices kun je zelf vanaf nul een krachtige custom connector maken in Google Cloud Application Integration, zodat je applicaties meer kunnen en beter te koppelen zijn.

Weet je niet waar je moet beginnen? Crystalloids kan je helpen om je applicaties te koppelen aan allerlei systemen, met kennis en oplossingen die op je eisen zijn afgestemd. Onze diensten gaan verder dan de bestaande opties, zodat we aan je specifieke behoeften voor applicatie-integratie voldoen.