Webhook-Nachrichten

Die Webhook-Nachrichten zeigen ein Protokoll aller ausgehenden Webhook-Meldungen, die X4fleet bei bestimmten Ereignissen an angebundene Zielsysteme versendet. Die Seite richtet sich an Disponenten und Administratoren und dient der Überwachung der Schnittstellenkommunikation: Sie können den Versandstatus einsehen, einzelne Nachrichten im Detail prüfen, bei Bedarf anpassen und erneut versenden, exportieren oder löschen.

1. Navigation

Die Webhook-Nachrichten sind über das Hauptmenü im Bereich Überwachung › Webhook-Nachrichten erreichbar.

Hinweis: Der Zugriff steht Benutzern mit der Rolle Disponent und Administrator zur Verfügung.

2. Übersichtstabelle

Die Übersicht zeigt alle versendeten Webhook-Nachrichten in einer seitenweise geladenen, sortierbaren Tabelle. Pro Zeile wird eine Webhook-Nachricht dargestellt.

Standardspalten

Sortierung

Durch Klick auf eine Spaltenüberschrift wird die Liste auf- oder absteigend nach dieser Spalte sortiert.

Mehrfachauswahl

Über die Auswahlkästchen am Zeilenanfang können mehrere Nachrichten gleichzeitig markiert werden. Die Toolbar-Aktionen «Erneut senden» und «Löschen» arbeiten auf allen markierten Nachrichten.

3. Datumsbereich

Über den Datumsbereich-Filter lässt sich die Liste auf einen Zeitraum (von/bis) eingrenzen. Es werden nur Nachrichten angezeigt, deren Zeitstempel innerhalb des gewählten Zeitraums liegt.

Der zuletzt gewählte Datumsbereich wird gespeichert und beim nächsten Aufruf der Seite automatisch wieder angewendet.

Hinweis: Auf dieser Seite ist nur ein einzelner, begrenzter Zeitraum (von/bis) möglich; erweiterte Varianten («davor»/«danach») stehen hier nicht zur Verfügung.

4. Gruppenbereich

Die angezeigten Nachrichten werden auf die aktuell aktive Gruppe und deren Untergruppen eingegrenzt. Über die Option «Nur aktuelle Gruppe» lässt sich die Anzeige auf Nachrichten der aktiven Gruppe beschränken; ist sie deaktiviert, werden auch Nachrichten der Untergruppen einbezogen.

Wird über den globalen Gruppen-Umschalter die aktive Gruppe gewechselt, lädt die Tabelle automatisch neu.

Hinweis: Für Subunternehmer-Gruppen entfällt die Option «Nur aktuelle Gruppe».

5. Spaltenfilter und Schnellsuche

Unterhalb der Spaltenüberschriften steht eine Filterzeile zur Verfügung. Pro Spalte kann ein Suchwert eingegeben werden; die Liste schränkt sich entsprechend ein.

• Für die Spalten Status, Tour-Auslöser und Sendungs-Auslöser wird der Filter als Auswahlliste mit den jeweils verfügbaren Werten angeboten.
• Die Spalte Zeitstempel lässt sich über die Filterzeile nicht filtern; für die zeitliche Eingrenzung verwenden Sie den Datumsbereich (siehe Abschnitt 3).

Zusätzlich durchsucht die Schnellsuche die angezeigte Liste über mehrere Spalten hinweg. Über den Button «Filter zurücksetzen» werden alle aktiven Filter wieder entfernt.

6. Nachrichten erneut senden (Auswahl)

Schlägt der Versand einer Webhook-Nachricht fehl oder soll eine Nachricht erneut zugestellt werden, können markierte Nachrichten direkt aus der Toolbar erneut versendet werden.

1. Eine oder mehrere Nachrichten in der Liste markieren.
2. Den Button «Erneut senden» in der Toolbar klicken.
3. Die ausgewählten Nachrichten werden erneut an ihre jeweilige Ziel-URL versendet.

Nach erfolgreichem Versand erscheint eine Bestätigungsmeldung.

Hinweis: Der Button ist nur aktiv, solange mindestens eine Nachricht markiert ist.

7. Detailansicht: anzeigen, bearbeiten, erneut senden

Über die Detailansicht lässt sich eine einzelne Webhook-Nachricht vollständig einsehen, anpassen und erneut versenden. Sie öffnet sich als breites Fenster.

Die Detailansicht enthält:

• Protokoll / Fehler: Ein aufklappbarer Bereich mit den Protokolleinträgen zur Zustellung der Nachricht. Hier sind eventuelle Fehlermeldungen ersichtlich.
• Rohnachricht: Der vollständige Nachrichteninhalt als strukturierter JSON-Editor.
• Nutzdaten (Payload): Die übermittelten Nutzdaten als zweiter strukturierter JSON-Editor.

Beide JSON-Editoren werden in einer aufgeklappten Formularansicht dargestellt und können bearbeitet werden.

Bearbeiten und erneut senden

1. Die Detailansicht der gewünschten Nachricht öffnen.
2. Bei Bedarf den Inhalt der Rohnachricht bzw. der Nutzdaten in den JSON-Editoren anpassen.
3. Den Button «Senden» klicken – die Nachricht wird mit dem aktuell angezeigten (ggf. bearbeiteten) Inhalt erneut an die Ziel-URL versendet.

Hinweis: Größere Nachrichteninhalte werden bei der Anzeige aus dem Speicher nachgeladen. Bei sehr umfangreichen Nutzdaten kann das Öffnen der Detailansicht daher einen Moment dauern.

8. Nachrichten löschen

Nicht mehr benötigte Webhook-Nachrichten können direkt aus der Übersicht gelöscht werden.

1. Eine oder mehrere Nachrichten markieren.
2. Den Button «Löschen» in der Toolbar klicken.
3. Die Sicherheitsabfrage bestätigen.

Die markierten Nachrichten werden endgültig aus dem Protokoll entfernt.

Achtung: Das Löschen ist unwiderruflich. Gelöschte Nachrichten können nicht wiederhergestellt werden.

9. Export

Die Webhook-Nachrichten lassen sich exportieren.

• Über den Export-Button in der Toolbar wird der Inhalt der aktuell angezeigten Tabelle exportiert.
• Zusätzlich stehen separate Exporte für sendungsbezogene und tourbezogene Webhook-Nachrichten zur Verfügung.

Beim Export werden die zugehörigen Nutzdaten zusammengeführt. Nicht relevante Teilsendungen können dabei je nach Webhook-Einstellungen ausgeschlossen werden.

Hinweis: Der Zugriff auf die Exporte ist gruppenbezogen abgesichert; exportiert werden nur Nachrichten der Gruppen, für die Sie berechtigt sind.

10. Tabellenlayout und Vorlagen

Die Spalten- und Layout-Einstellungen der Webhook-Nachrichten werden pro Benutzer automatisch gespeichert und bleiben nach dem Abmelden erhalten.

• Spaltenauswahl / Layout: Über die Layout-Funktionen der Toolbar lassen sich Spalten ein- und ausblenden sowie die Anordnung der Tabelle anpassen.
• Vorlagen: Gespeicherte Vorlagen können über die zugehörigen Buttons in der Toolbar auf die aktuelle Ansicht angewendet werden, um schnell zwischen unterschiedlichen Spalten- und Filterkonfigurationen zu wechseln.

11. Zusammenfassung: verfügbare Aktionen