Importacties maken gebruik van import mappings. In een importactie wordt gedefinieerd waar het te importeren bestand vandaan komt; bestanden kunnen worden opgehaald via API-aanroepen of FTP/SFTP. Daarnaast kun je definiëren wat er vóór of na een import moet gebeuren met voor- en nabewerkingstaken. Bijvoorbeeld: een API-autorisatieverzoek uitvoeren, een andere API-aanroep doen met de verkregen autorisatie en vervolgens een status bijwerken binnen de modellen van Babeldat.
Beheer > Uitwisseling > Importeren > Import Actie
STAP 1:
Klik op de knop “Aanmaken”.
STAP 2:
Voer de informatie over de aan te maken import actie in:
|
Code |
De naam voor de aan te maken import actie. |
|
Prioriteit |
OPTIONEEL: De prioriteit van de aan te maken import actie. |
|
Taak |
OPTIONEEL: De uit te voeren taak behorend bij de import actie. |
|
Mapping |
OPTIONEEL: De import mapping die uitgevoerd dient te worden op de nieuwe import actie. |
STAP 3:
Klik op “Opslaan” om de import actie uit te voeren.
VOORBEWERKINGSTAKEN
Voorverwerkingstaken zijn taken die worden uitgevoerd voordat de import plaatsvindt. Dit wordt meestal gebruikt om API-aanvragen te autoriseren of om het importbestand van een opgegeven bron op te halen. Je kunt zoveel voorverwerkingstaken aan elkaar koppelen als nodig is.
Nummer: Definieer een volgorde door een nummer in te stellen; de actie met het laagste nummer begint eerst.
Taak: Selecteer de taak die moet worden uitgevoerd.
NABEWERKINGSTAKEN
Nabewerkingstaken zijn taken die worden uitgevoerd nadat de import heeft plaatsgevonden. Dit wordt meestal gebruikt om een orderstatus in te stellen. Je kunt zoveel nabewerkingstaken aan elkaar koppelen als nodig is.
API GERELATEERDE FUNCTIES
Een variabele registreren: Als je weet hoe een API-aanroep wordt uitgevoerd, gaan we wat dieper in op Babeldat-specifieke functies met betrekking tot het aan elkaar koppelen van meerdere API-aanroepen. Naast de gebruikelijke API-velden (URL, Body, Headers, etc.) heeft Babeldat een Register-veld dat wordt gebruikt om een API-responswaarde op te slaan in een variabele om te gebruiken in een volgende aanvraag binnen dezelfde ‘importactie’. Bijvoorbeeld: je moet een autorisatieverzoek uitvoeren om een bearer token te ontvangen voordat de volgende aanvraag kan worden uitgevoerd om de daadwerkelijke gegevens op te vragen die moeten worden geïmporteerd. Zoek de variabele naam in de response body en registreer die waarde door de variabele naam in te vullen in het registerveld.
Een geregistreerde variabele gebruiken als autorisatie: Plak de geregistreerde variabele naam tussen twee tildes (\~). Bijvoorbeeld: je hebt een bearer token geregistreerd in de variabele genaamd access_token, je zou dan \access_token\ moeten invullen in het autorisatieveld van de volgende aanvraag.
Een geregistreerde variabele gebruiken in URL mapping-variabelen: Soms moet je een variabele gebruiken binnen de request URL. Om dit te bereiken moeten we gebruikmaken van het URL mapping-variabelenveld. Babeldat heeft hiervoor twee functies, paste_before en paste_after. Vul eerst de variabelenaam in gevolgd door een pipe (|), daarna de functienaam gevolgd door een dubbele punt (:) en de bijpassende waarde. Bijvoorbeeld: je hebt een order-ID geregistreerd met de vorige API-aanroep in de variabele genaamd orderID. Je zou dan “https://api.bol.com/retailer/orders\” moeten invullen in het URL-veld en “orderId|paste_before:https://api.bol.com/retailer/orders/\” in het URL mapping-variabelenveld.