De route bouwen

Na het succesvol tot stand brengen van verbindingen tussen beide applicaties die we willen integreren (door een verbindingsmethode te selecteren), is het nu tijd om gegevensuitwisseling mogelijk te maken. In ons voorbeeld betekent dit het ophalen van gegevens uit onze Picqer-magazijnbeheersoftware en deze naar onze Shopify e-commerce webshop sturen. Laten we eens kijken hoe dit allemaal in actie werkt.

‍

Stap 2: De integratie configureren

Om een integratie tussen applicaties (Shopify en Picqer) via de Alumio iPaaS te creëren, te automatiseren, te transformeren en te orkestreren, beginnen we met het creëren van een nieuwe route:

1. Begin met een route: Selecteer de optie „Integraties” in de navigatiebalk en klik op het gedeelte „Routes” in de keuzelijst om te beginnen met het opbouwen van uw integratie.

2. Maak een nieuwe route: Klik in het route-overzicht op het plusje om te beginnen met het bouwen van een nieuwe route.

3. Geef je integratie een naam: In de interface voor het bouwen van routes die verschijnt, geeft u uw route een duidelijke naam en beschrijving, zodat u uw integratie gemakkelijk kunt identificeren, doorzoeken en definiëren. Best practices zijn onder meer het benoemen van de applicaties die u wilt integreren en het aangeven van de gegevensstroom.

4. Stel een inkomende configuratie samen: Om het eerste deel van je integratie te bouwen, moet je eerst gegevens ophalen uit je bronsysteem (Picqer, zoals in ons voorbeeld). Om dit te bereiken, moet u een inkomende configuratie op de route bouwen door de volgende acties uit te voeren:

a. Voer binnenkomende gegevens in: In de interface om de inkomende configuratie samen te stellen, moet u deze eerst een naam en een beschrijving geven die bepaalt welke gegevens uit de bronapp worden opgehaald.

b. Kies een abonnee: Naar definieer hoe Alumio gegevens ontvangt van een brontoepassing, u moet vervolgens een relevante abonnee- en HTTP-aanvraagmethode kiezen. Zoals je kunt zien, hebben we in de onderstaande schermafbeelding de Picqer-abonnee geselecteerd in het keuzemenu en de aanvraagmethode die we hebben gekozen is „GET”, een HTTP-methode die wordt gebruikt om gegevens op te halen.

c. Selecteer een entiteit: Om vervolgens te kiezen welke specifieke gegevens u via de inkomende configuratie van de toepassing wilt ontvangen, moet u een gegevensentiteit of een specifiek type gegevens kiezen. Omdat we productgegevens van Picqer willen integreren met Shopify, selecteren we volgens ons voorbeeld de entiteit „Alle producten ophalen”.

d. Kies de HTTP-client: Het belangrijkste is dat we vervolgens de Picqer HTTP-client moeten kiezen die we aan het begin van het bouwen van uw integratie hebben gemaakt, om uw verbindingsmethode te definiëren.

e. Sla binnenkomend op: Daarmee hebben we onze inkomende configuratie met succes geconfigureerd om productgegevens van Picqer naar de Alumio iPaaS te halen. We kunnen nu de inkomende configuratie opslaan en doorgaan met het configureren van de rest van je route.

Opmerking: De extra opties die u op de interface ziet, zijn optionele velden die u kunt configureren om uw verbinding verder aan te passen.

‍

5. Een uitgaande configuratie bouwen: De volgende stap om onze route te voltooien is het aanmaken van de uitgaande configuratie. Dit zal helpen bij het definiëren van de doeltoepassing (Shopify) waarnaar we de gegevens willen verzenden die we hebben opgehaald. U moet de optie Uitgaande configuratie selecteren in de Route-interface door op het pictogram '+' naast het veld te drukken en vervolgens de volgende acties uit te voeren:

a. Voer uitgaande gegevens in: In de interface om de uitgaande configuratie te bouwen, moet u deze eerst een naam en een beschrijving geven waarin wordt aangegeven welke gegevens u naar de doeltoepassing verzendt.

b. Kies een uitgever: Naar definieer hoe Alumio gegevens naar de doeltoepassing verzendt, u moet vervolgens een relevante Publisher- en HTTP-aanvraagmethode kiezen. Zoals je kunt zien, hebben we in de onderstaande schermafbeelding de Shopify Publisher geselecteerd in het uitklapmenu. De gekozen aanvraagmethode is „POST”, een HTTP-methode die wordt gebruikt om nieuwe items aan te maken in een andere toepassing.

c. Selecteer een entiteit: Om vervolgens te kiezen welke specifieke gegevens u via de uitgaande configuratie naar de toepassing wilt sturen, moet u een „Entiteit” of een specifiek type gegevens kiezen. Omdat we productgegevens van Picqer willen integreren met Shopify, selecteren we volgens ons voorbeeld de entiteit „Een nieuw product aanmaken” in Shopify.

d. Kies de HTTP-client: Net als bij de inkomende configuratie moeten we onze uitgaande configuratie voltooien door de Shopify HTTP-client te kiezen die we aan het begin van deze walkthrough hebben gemaakt.

e. Uitgaand opslaan: We hebben onze uitgaande configuratie nu met succes geconfigureerd om de Picqer-productgegevens naar Shopify te sturen via de Alumio iPaaS. We kunnen de uitgaande configuratie opslaan en doorgaan met het voltooien van onze route.

6. Maak de route klaar om te rennen: Als je teruggaat naar de Route-building-interface voor het verzenden van 'Picqer-producten naar Shopify', kun je nu zien dat we met succes een inkomende en uitgaande configuratie hebben gebouwd en hieraan hebben gekoppeld. Hiermee is de route op basisniveau voltooid.

a. Sla de route op: Om u klaar te maken voor het uitvoeren van de route, controleert u nog een laatste keer alle gegevens en klikt u vervolgens op de optie „Opslaan en doorgaan”.

b. Voer het volgende uit: Je kunt ervoor kiezen om de hele route rechtstreeks uit te voeren. Wanneer u echter voor het eerst een route configureert, kunt u eerst de inkomende configuratie handmatig uitvoeren om te controleren of alles werkt. Hiermee kunt u controleren of de Alumio iPaaS gegevens correct ophaalt uit het bronsysteem.

c. Controleer nieuwe taken: Binnen de Route-interface zijn er verschillende tabbladen: Bewerken, versiebeheer, logboeken, geplande taken, waarschuwingen, taken, relaties. Je moet het tabblad „Taken” kiezen om te controleren of het handmatig uitvoeren van je inkomende configuratie de gegevens van Picqer heeft opgehaald. Als u ziet dat taken zijn aangemaakt met de status „NIEUW”, betekent dit dat uw inkomende configuratie werkt. Als de status „Mislukt” is, moet u deze opnieuw configureren door de logboeken te controleren om te zien wat er mis is gegaan.

d. Voer de route uit: Nu we met succes hebben gecontroleerd of Alumio de juiste gegevens uit de brontoepassing haalt, kunnen we nu proberen deze gegevens naar de doeltoepassing te sturen. Om dit te kunnen doen, moeten we de route uitvoeren.

e. Voltooide taken: Nadat je de Route hebt uitgevoerd, kun je de taakpagina binnen de Route verversen om te controleren of de gegevens succesvol zijn geïntegreerd (van Picqer naar Shopify — zoals in ons voorbeeld). Als de status van de taken verandert van „Nieuw” naar „Voltooid”, betekent dit dat de integratie geslaagd is.

Let op: U kunt op elke taak klikken en naar het tabblad Entiteitsgegevens navigeren om de gegevens die worden geïntegreerd (de productgegevens van Picqer tot Shopify) in JSON-formaat te visualiseren.

f. Checklogs: Om na het uitvoeren van de Route alle gegevens die via de integratie in detail zijn uitgewisseld te controleren, selecteert u eenvoudig het tabblad „Logboeken” in de Route. Op het eerste gezicht toont dit overzicht alle datums, tijden en duur van de Route-activiteit, het geheugengebruik en het aantal gegenereerde, mislukte of gefilterde taken.

g. Loggegevens: Klik op de optie „Logs” om de details te zien van elke gebeurtenis en gegevensuitwisseling nadat de route is uitgevoerd binnen de Alumio iPaaS.

7. Controleer de integratie: De laatste stap om te controleren of je integratie via Alumio werkt, is door je daadwerkelijke applicatie te controleren om te zien of de nieuwe gegevens naar de applicatie zijn gestuurd. Volgens ons voorbeeld moeten we Shopify controleren om te zien of producten van Picqer erin succesvol zijn geïntegreerd.

‍

Hiermee is een zeer eenvoudige uitleg voltooid over hoe u uw eerste integratie kunt configureren, testen en handmatig kunt uitvoeren. De Alumio iPaaS helpt u echter niet alleen om snel verbindingen tussen eindpunten op te bouwen, maar is ook ontworpen om u te helpen uw integraties te automatiseren, te transformeren en te orkestreren. Laten we in onze volgende les dus eens kijken hoe u deze integratie intelligent kunt plannen en automatiseren, en hoe u enkele basistransformers kunt toepassen om deze integratie aan te passen.