Support

Support- und Diagnosewerkzeuge für Xplanis-Mitarbeitende: erneuter Versand von Sendungs-Webhooks per CSV-Upload.

Die Seite Support stellt spezielle Diagnose- und Wartungswerkzeuge bereit, die ausschliesslich Xplanis-Mitarbeitenden mit Superadmin-Berechtigung zur Verfügung stehen. Sie dient dazu, im laufenden Betrieb gezielt unterstützende Massnahmen durchzuführen – beispielsweise wenn Sendungsbenachrichtigungen an ein angebundenes Drittsystem erneut ausgelöst werden müssen.

Hinweis: Diese Seite ist nur für Benutzer mit Superadmin-Rechten sichtbar und zugänglich. Reguläre Anwenderinnen und Anwender sehen diese Funktionen nicht.


1. Navigation

Die Support-Seite ist über die globalen Einstellungen erreichbar. Sie wird nur eingeblendet, wenn der angemeldete Benutzer über die erforderliche Superadmin-Berechtigung verfügt.


2. Sendungs-Webhooks erneut versenden

Mit dieser Funktion lassen sich Webhook-Benachrichtigungen für ausgewählte Sendungen erneut auslösen. Das ist beispielsweise dann nützlich, wenn ein angebundenes Drittsystem eine Benachrichtigung nicht empfangen oder verarbeitet hat und die Sendungsinformationen erneut übermittelt werden sollen.

Beim erneuten Versand wird die Benachrichtigung auf Basis der aktuellen Sendungsdaten neu erzeugt. Es wird also nicht die ursprünglich versendete Nachricht wiederholt, sondern eine neue Nachricht mit dem aktuellen Stand der Sendung generiert.

Vorgehen

  1. Eine CSV-Datei mit den gewünschten Sendungen und Auslösern vorbereiten (siehe Abschnitt 2.1).
  2. Im Support-Bereich über das Dateiauswahlfeld die vorbereitete .csv-Datei auswählen.
  3. Den Button «Erneut versenden» klicken.
  4. Die Verarbeitung abwarten. Während des Versands ist der Bereich gesperrt, sodass keine doppelten Vorgänge ausgelöst werden können.

Nach Abschluss wird die Anzahl der erneut versendeten Benachrichtigungen zurückgemeldet.

2.1 Format der CSV-Datei

Die hochzuladende Datei muss eine CSV-Datei mit genau zwei Spalten sein. Die erste Zeile muss die folgende Kopfzeile enthalten:

ShipmentId,Trigger
SpalteBedeutung
ShipmentIdEindeutige ID der Sendung, für die die Benachrichtigung erneut versendet werden soll
TriggerAuslöser bzw. Ereignis, für das die Benachrichtigung erzeugt wird

Jede weitere Zeile beschreibt eine erneut zu versendende Benachrichtigung.

Hinweis: Doppelt erfasste Einträge werden automatisch erkannt und nur einmal verarbeitet.

2.2 Verhalten und Einschränkungen

  • Die Benachrichtigungen werden in Stapeln verarbeitet, um eine zuverlässige Verarbeitung auch grösserer Mengen sicherzustellen.
  • Ist für eine Gruppe das Modul zur Sendungsprüfung aktiv, werden Sendungen, die noch nicht geprüft wurden, beim erneuten Versand übersprungen.
  • Nur Sendungen, die im System gefunden werden, werden berücksichtigt.

3. Beispiel-CSV herunterladen

Damit die Datei im korrekten Format vorbereitet werden kann, steht eine Beispiel-CSV zum Download bereit. Über den entsprechenden Link wird eine Vorlagendatei in einem neuen Browser-Tab geöffnet.

Die Beispieldatei zeigt:

  • die geforderte zweispaltige Struktur mit der Kopfzeile ShipmentId,Trigger,
  • wie die einzelnen Einträge erfasst werden.

Tipp: Verwenden Sie die Beispieldatei als Ausgangspunkt, um Fehler beim Aufbau der Kopfzeile und der Spalten zu vermeiden.


4. Zusammenfassung: verfügbare Funktionen

FunktionBeschreibungVoraussetzung
Sendungs-Webhooks erneut versendenBenachrichtigungen für die in der CSV erfassten Sendungen mit aktuellen Daten neu auslösenSuperadmin-Berechtigung, korrekt formatierte CSV-Datei
Beispiel-CSV herunterladenVorlagendatei mit dem geforderten Format herunterladenSuperadmin-Berechtigung