Eine Preset-Integration einrichten

Eine Preset-Integration ist ein Connector, mit dem Transportial bereits kommunizieren kann, etwa ein Bordcomputersystem, ein Buchhaltungsprogramm oder ein Mailserver. Sie geben nur an, wo das System ist, wie die Anmeldung erfolgt und welche Funktionen ausgeführt werden. Die Liste der Systeme hängt davon ab, was für Ihre Plattform verfügbar ist.

Bevor Sie beginnen

• Besorgen Sie sich die Adresse (URL) des anderen Systems und Ihre Zugangsdaten von diesem System oder Ihrem Anbieter: Benutzername und Passwort, einen API-Schlüssel, einen Schlüssel mit Secret oder ein Konto, mit dem Sie autorisieren.
• Klären Sie, welche Daten Sie austauschen möchten, zum Beispiel Positionen, Aktivitäten, Planung oder Rechnungen.

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, zum Beispiel den Namen des Systems.
3. Wählen Sie unter Wählen Sie den Integrationstyp aus die Option Preset-Integration.
4. Wählen Sie unter Wählen Sie Bereitgestellte Integration aus das System. Seine Standardwerte werden ausgefüllt.
5. Wählen Sie im zweiten Auswahlfeld die auszuführenden Funktionen. Jede Option zeigt eine kurze Beschreibung, was sie tut, zum Beispiel Positionen abrufen oder Trips senden.
6. Legen Sie den Zeitplan fest: Wählen Sie eine Einheit (Sekunden, Minuten, Stunden oder Tage) und geben Sie einen Wert ein, zum Beispiel alle 5 Minuten.
7. Prüfen Sie URL und Port des Systems. Der Port ist 443, sofern Ihr Anbieter nichts anderes angibt.
8. Wählen Sie unter Anmeldemethode auswählen, wie die Anmeldung erfolgt, und füllen Sie die Felder aus (siehe unten).
9. Stellen Sie Aus/Ein auf Ein und klicken Sie auf Speichern.

Anmeldemethoden

Es werden nur die Methoden angeboten, die das gewählte System unterstützt.

Methode	Was Sie eingeben
Basic	Nutzername und Passwort.
API-Schlüssel	Den API-Schlüssel, den Ihnen das System gegeben hat.
Zugriff & geheimer Schlüssel	Einen Zugriffsschlüssel und einen Geheimer Schlüssel.
Bearer-Token	Ein Token aus dem anderen System.
Header	Einen oder mehrere Header-Namen und -Werte. Klicken Sie für jeden auf Kopfzeile hinzufügen.
Autorisierung mit einem Konto	Manche Systeme verwenden statt eines Passworts eine Anmeldeseite. Klicken Sie auf Autorisieren, melden Sie sich beim anderen System an und erlauben Sie den Zugriff. Danach kehren Sie zu Transportial zurück.

Connector-Optionen

Manche Connectors zeigen unter den Zugangsdaten einen Abschnitt Optionen. Das sind zusätzliche Einstellungen, die der Connector akzeptiert, etwa welche Daten einbezogen werden. Jede Option zeigt, was die Integration aktuell tut. Lassen Sie eine Option unverändert, behält der Connector seinen eigenen Standard. Gilt eine Option nur für bestimmte Funktionen, steht das dabei („Gilt nur, wenn aktiviert: …“).

Nach einem Cron-Zeitplan ausführen

Für mehr Kontrolle wählen Sie Cron als Zeitplaneinheit. Geben Sie einen Cron-Ausdruck mit fünf Feldern (Minute, Stunde, Tag des Monats, Monat, Wochentag) und eine Zeitzone ein. Zum Beispiel läuft 0 6 * * 1-5 werktags um 06:00 Uhr. Unter den Feldern zeigt Nächste Ausführungen, wann die Integration läuft, sodass Sie den Ausdruck prüfen können.

Messaging-Connectors

Bei Connectors, die Nachrichten empfangen (zum Beispiel Chat- oder Messaging-Dienste), zeigt das Formular eine Eingehende Webhook-URL. Kopieren Sie sie und tragen Sie sie beim Anbieter als Webhook für eingehende Nachrichten ein. Dort eingehende Nachrichten werden in Chats in Transportial geleitet.

Prüfen, ob es funktioniert

Öffnen Sie die Integration aus der Liste und sehen Sie sich nach dem ersten geplanten Lauf die Tabs Protokolle und Anfragen an. Siehe Eine Integration überwachen.