Een zelf te configureren integratie bouwen

Een zelf te configureren integratie is bedoeld voor systemen waarvoor geen preset koppeling bestaat. Jij bepaalt wanneer hij draait, welke records hij verwerkt en hoe velden in het andere systeem worden gekoppeld aan velden in Transportial. Eén integratie kan meerdere gegevensbronnen hebben, bijvoorbeeld één die orders ophaalt en één die statusupdates terugstuurt.

Kiezen hoe de integratie start

Kies na het type Zelf te configureren integratie een trigger bij Selecteer triggertype:

• Gepland: draait met vaste tussenpozen of volgens een cron-schema, bijvoorbeeld om elke 10 minuten een FTP-map te controleren.
• Trigger: draait als er iets gebeurt in Transportial. Kies een of meer gebeurtenissen bij Selecteer triggergebeurtenis, bijvoorbeeld wanneer een trip wordt bijgewerkt.
• Listener: wacht tot het andere systeem gegevens instuurt, bijvoorbeeld via een webhook of per e-mail. De gegevensbronnen staan dan op inkomende gegevens.

Bij Trigger en Listener kun je filters toevoegen, zodat de integratie alleen draait voor records die voldoen.

De integratie aanmaken

1. Open het zijmenu (☰, rechtsboven), kies Integraties en klik op + Integratie aanmaken.
2. Vul een Naam in en kies Zelf te configureren integratie bij Selecteer integratietype.
3. Kies de trigger bij Selecteer triggertype en stel voor een geplande integratie het schema in.
4. Klik voor een integratie met Trigger of Listener eventueel op + Filter toevoegen en bouw een voorwaarde: een Selector (het veld), een vergelijking (bijvoorbeeld Gelijk aan (==) of Is in ...) en een Waarde.
5. Klik op + Gegevensbron toevoegen.
6. Kies de richting bij Selecteer gegevensrichting...: IN voor gegevens die Transportial binnenkomen, OUT voor gegevens die naar buiten gaan.
7. Kies de verbinding bij Selecteer verbindingstype... en vul de velden ervan in (zie hieronder).
8. Kies bij Selecteer entiteit welk soort record de gegevensbron aanmaakt of leest, bijvoorbeeld een transportorder of een trip.
9. Koppel de velden (zie hieronder) en test de koppeling.
10. Zet Uit/Aan op aan en klik op Opslaan.

Verbindingstypes

Verbinding	Wat je instelt
API	De URL en de requestmethode bij Selecteer requestmethode.
SQL-verbinding	Het adres van de database en de inloggegevens.
FTP / SFTP	Host, Port, Pad en inloggegevens.
Virtuele FTP	Transportial host de FTP-server voor je. De verbindingsgegevens en inlog worden bij het opslaan gegenereerd; deel ze met je partner.
Webhook	Na het opslaan verschijnt er een webhookadres. Geef dat aan het andere systeem, zodat het gegevens naar Transportial kan posten.
E-mailontvanger	Transportial ontvangt de gegevens per e-mail.

Bij elke verbinding bepaalt de schakelaar Met authenticatie hoe de toegang is beveiligd. Zet hem aan om inloggegevens in te vullen. Laat hem uit om alleen de IP-adressen toe te staan die je invult. Kies voor uitgaande gegevens het bestandsformaat (JSON, XML of CSV) bij Selecteer gegevenstype.

De velden koppelen

Elke koppelregel verbindt een veld in het andere systeem met een veld in Transportial.

• Inkomend en Uitgaand: het pad van het veld aan elke kant.
• Selecteer veldtype: Tekst, Lijst, Object, Boolean, Datum & Tijd, Tijd en meer. Lijsten en objecten bevatten hun eigen regels.
• Formaat, Regex en Standaardwaarde: lees een datum in een bepaald formaat, neem een deel van een waarde, of vul een waarde in als het veld leeg is.
• Opties zoals Identificatie (het veld identificeert het record, zodat een tweede levering het bijwerkt in plaats van een dubbel aan te maken), Spaties aan begin en eind verwijderen of Naar hoofdletters.

Klik op + Veld toevoegen om een regel toe te voegen, of zet JSON-modus aan om de hele koppeling als tekst te bewerken. Met een gekozen entiteit stelt Mapping genereren met AI een koppeling voor je op. Zet OTM aan als de gegevensbron de Open Trip Model-standaard gebruikt in plaats van je eigen koppeling.

Opties voor inkomende gegevens

• Sequentiële verwerking: verwerk leveringen één voor één, op volgorde.
• Gedeeltelijke updates: een levering noemt maar een deel van de elementen (bijvoorbeeld één order van een trip) en de andere blijven behouden. Elk element moet een identificatie hebben; een element dat wordt geleverd met deleted = true wordt verwijderd.

De koppeling testen

1. Zet Testweergave aan voor de gegevensbron.
2. Plak of typ voorbeeldgegevens uit het andere systeem.
3. Klik op Testen en controleer het resultaat dat ernaast wordt getoond.