↑ ↓ to navigate
    ↵ to select
    esc to close
    X4Fleet Help Center

    Gateway-Protokolle

    Gateway-Integrationsprotokolle nachschlagen: Anfrage- und Antwortinhalte einer Schnittstellenmeldung anhand der Entitäts-ID und der Protokollquelle einsehen.

    Die Gateway-Protokolle sind ein Diagnosewerkzeug, mit dem die über die Integrations-Schnittstellen (Gateway) ausgetauschten Meldungen nachvollzogen werden können. Zu einem einzelnen Vorgang lassen sich der gesendete Anfrageinhalt und der empfangene Antwortinhalt im Detail einsehen. Das Werkzeug dient in erster Linie der Fehlersuche bei der Anbindung externer Systeme.

    Hinweis: Diese Seite steht ausschliesslich Benutzern mit der Rolle Superadmin (Xplanis-Personal) zur Verfügung.

    1. Navigation

    Die Gateway-Protokolle sind über die globalen Einstellungen erreichbar.

    2. Protokoll nachschlagen

    Über das Suchformular wird ein einzelnes Gateway-Protokoll anhand seiner Kennung und der Protokollquelle ermittelt.

    1. Im Feld ID die eindeutige Kennung der gesuchten Entität bzw. des Protokolleintrags eingeben.
    2. Unter Protokolltyp die gewünschte Quelle auswählen. Die Auswahl legt fest, aus welchem Bereich der Integration der Eintrag stammt.
    3. Auf die Schaltfläche Suchen klicken.

    Wird ein passender Eintrag gefunden, werden anschliessend der zugehörige Anfrage- und Antwortinhalt angezeigt (siehe Abschnitte 3 und 4).

    Hinweis: Pro Suchvorgang wird genau ein Protokolleintrag geladen. Existiert zur eingegebenen Kombination aus ID und Protokolltyp kein Eintrag, bleiben die Inhaltsbereiche leer.

    3. Anfrageinhalt anzeigen

    Der Bereich Anfrageinhalt zeigt den vollständigen Nutzdateninhalt (Payload) der Anfrage an, die an die Schnittstelle übermittelt wurde.

    • Der Inhalt wird in einem grossen, mehrzeiligen Textfeld dargestellt.
    • Das Feld ist schreibgeschützt und dient ausschliesslich der Ansicht.
    • Bei umfangreichen Inhalten kann innerhalb des Feldes gescrollt werden.

    So lässt sich nachvollziehen, welche Daten genau gesendet wurden.

    4. Antwortinhalt anzeigen

    Der Bereich Antwortinhalt zeigt den vollständigen Nutzdateninhalt (Payload) der Antwort an, die von der Schnittstelle zurückgegeben wurde.

    • Der Inhalt wird – analog zum Anfrageinhalt – in einem grossen, schreibgeschützten Textfeld dargestellt.
    • Auch hier kann bei längeren Inhalten innerhalb des Feldes gescrollt werden.

    Durch den Vergleich von Anfrage- und Antwortinhalt lässt sich feststellen, wie die Gegenstelle auf eine übermittelte Meldung reagiert hat – beispielsweise bei der Analyse fehlgeschlagener Übertragungen.

    5. Hinweise

    • Die Gateway-Protokolle sind ein reines Diagnose- und Nachschlagewerkzeug. Es lassen sich keine Inhalte bearbeiten oder erneut versenden.
    • Sowohl der Anfrage- als auch der Antwortinhalt werden unverändert so dargestellt, wie sie übertragen wurden.
    • Da die Seite ausschliesslich der Rolle Superadmin vorbehalten ist, steht sie regulären Anwendern nicht zur Verfügung.