Eine selbstkonfigurierbare Integration erstellen

Eine selbstkonfigurierbare Integration ist für Systeme gedacht, für die es keinen fertigen Connector gibt. Sie legen fest, wann sie läuft, welche Datensätze sie verarbeitet und wie Felder im anderen System den Feldern in Transportial zugeordnet werden. Eine Integration kann mehrere Datenquellen haben, zum Beispiel eine, die Aufträge abruft, und eine, die Statusupdates zurücksendet.

Festlegen, wie die Integration startet

Nachdem Sie Selbstkonfigurierbare Integration als Typ gewählt haben, wählen Sie unter Triggertyp auswählen einen Auslöser:

• Geplant: läuft in festen Abständen oder nach einem Cron-Zeitplan, zum Beispiel um alle 10 Minuten einen FTP-Ordner abzufragen.
• Auslöser: läuft, wenn in Transportial etwas geschieht. Wählen Sie unter Triggerereignis auswählen ein oder mehrere Ereignisse, zum Beispiel wenn ein Trip aktualisiert wird.
• Listener: wartet darauf, dass das andere System Daten sendet, zum Beispiel über einen Webhook oder per E-Mail. Seine Datenquellen sind dann auf eingehende Daten eingestellt.

Für Auslöser und Listener können Sie Filter hinzufügen, damit die Integration nur für passende Datensätze läuft.

Die Integration erstellen

1. Öffnen Sie das Seitenmenü (☰, oben rechts), wählen Sie Integrationen und klicken Sie auf + Integration erstellen.
2. Geben Sie einen Name ein und wählen Sie Selbstkonfigurierbare Integration unter Wählen Sie den Integrationstyp aus.
3. Wählen Sie den Auslöser unter Triggertyp auswählen und legen Sie bei einer geplanten Integration den Zeitplan fest.
4. Klicken Sie bei einer Integration vom Typ Auslöser oder Listener optional auf + Filter hinzufügen und erstellen Sie eine Bedingung: einen Selektor (das Feld), einen Vergleich (zum Beispiel Gleich (==) oder Ist in ...) und einen Wert.
5. Klicken Sie auf + Datenquelle hinzufügen.
6. Wählen Sie die Richtung unter Datenrichtung auswählen...: EINGEHEND für Daten, die in Transportial eingehen, AUSGEHEND für ausgehende Daten.
7. Wählen Sie die Verbindung unter Verbindungstyp auswählen... und füllen Sie ihre Felder aus (siehe unten).
8. Wählen Sie unter Entität auswählen, welche Art von Datensatz die Datenquelle erstellt oder liest, zum Beispiel einen Transportauftrag oder einen Trip.
9. Ordnen Sie die Felder zu (siehe unten) und testen Sie die Zuordnung.
10. Stellen Sie Aus/Ein auf Ein und klicken Sie auf Speichern.

Verbindungstypen

Verbindung	Was Sie einrichten
API	Die URL und die Anfragemethode unter Anfragemethode auswählen.
SQL-Verbindung	Die Datenbankadresse und die Zugangsdaten.
FTP / SFTP	Host, Port, Pfad und Zugangsdaten.
Virtuelles FTP	Transportial stellt den FTP-Server für Sie bereit. Verbindungsdaten und Zugang werden beim Speichern erzeugt; geben Sie sie an Ihren Partner weiter.
Webhook	Nach dem Speichern erscheint eine Webhook-Adresse. Geben Sie sie dem anderen System, damit es Daten an Transportial senden kann.
E-Mail-Empfänger	Transportial empfängt die Daten per E-Mail.

Bei jeder Verbindung bestimmt der Schalter Mit Authentifizierung, wie der Zugriff gesichert wird. Schalten Sie ihn ein, um Zugangsdaten einzugeben. Lassen Sie ihn aus, um nur die eingegebenen IP-Adressen zuzulassen. Wählen Sie für ausgehende Daten das Dateiformat (JSON, XML oder CSV) unter Datentyp auswählen.

Die Felder zuordnen

Jede Zuordnungszeile verbindet ein Feld im anderen System mit einem Feld in Transportial.

• Eingehend und Ausgehend: der Pfad des Felds auf jeder Seite.
• Feldtyp auswählen: Text, Liste, Objekt, Boolesch, Datum & Uhrzeit, Zeit und mehr. Listen und Objekte enthalten eigene Zeilen.
• Format, Regex und Standardwert: ein Datum in einem bestimmten Format lesen, einen Teil eines Werts herausgreifen oder einen Wert setzen, wenn das Feld leer ist.
• Optionen wie Identifikation (das Feld identifiziert den Datensatz, sodass eine zweite Lieferung ihn aktualisiert, statt ein Duplikat anzulegen), Trimmen oder Auf Großbuchstaben.

Klicken Sie auf + Feld hinzufügen, um eine Zeile hinzuzufügen, oder schalten Sie den JSON-Modus ein, um die gesamte Zuordnung als Text zu bearbeiten. Ist eine Entität ausgewählt, entwirft Mapping mit KI generieren eine Zuordnung für Sie. Schalten Sie OTM ein, wenn die Datenquelle statt Ihrer eigenen Zuordnung den Standard Open Trip Model verwendet.

Optionen für eingehende Daten

• Sequentielle Verarbeitung: Lieferungen einzeln und der Reihe nach verarbeiten.
• Teilweise Aktualisierungen: Eine Lieferung nennt nur einige Elemente (zum Beispiel einen Auftrag eines Trips), die übrigen bleiben erhalten. Jedes Element muss eine Kennung tragen; ein mit deleted = true geliefertes Element wird entfernt.

Die Zuordnung testen

1. Schalten Sie für die Datenquelle die Testansicht ein.
2. Fügen Sie Beispieldaten aus dem anderen System ein oder geben Sie sie ein.
3. Klicken Sie auf Zu testen und prüfen Sie das daneben angezeigte Ergebnis.