Warteschlangenverwaltung

Sendestatus überwachen, Fehler beheben und die E-Mail-Warteschlange verwalten.

Die Warteschlangenverwaltung ermöglicht die Überwachung des Fortschritts Ihrer PDF-Generierung und E-Mail-Versandaufgaben. Sie bietet eine detaillierte Ansicht jedes Auftrags — vom Gesamtprofilstatus bis hin zu einzelnen E-Mail-Elementen.

Übersicht

Das Warteschlangensystem ist in vier Ebenen gegliedert, um Ihnen das Analysieren von Problemen zu erleichtern:

Profilliste: Übersicht aller Profile und ihrer letzten Aktivitäten.
Batchliste: Import-Verlauf (Dateien) für ein bestimmtes Profil.
Detailliste: Einzelne Elemente (Empfänger) innerhalb eines Batches.
Elementdetails: Detaillierte Daten und Status für ein einzelnes Element.

1. Profilliste (Übersicht)

Die Hauptansicht zeigt eine Karte für jedes konfigurierte Profil.

Statistiken: Jede Karte visualisiert den Status der Elemente der letzten 30 Tage.
- Fehler: Fehlgeschlagene Elemente (PDF-Generierung, Versand oder Import).
- Ausstehend: Elemente, die auf Verarbeitung warten (PDF-Generierung).
- PDF generiert: Elemente mit generierten PDFs, die auf den Versand warten.

Aktion: Klicken Sie auf eine Profilkarte (oder das Details-Symbol), um deren Batchliste anzuzeigen.

2. Batchliste (Verlauf)

Diese Liste zeigt alle Dateien, die Sie für das ausgewählte Profil importiert haben.

Batch-Name: Entspricht dem Dateinamen der importierten CSV.
Importdatum: Dient zur Unterscheidung mehrerer Importe derselben Datei.
Statusspalten:
- Gesamt: Gesamtzahl der Elemente im Batch.
- Fehler: Gesamtzahl der Fehlschläge.
- Ausstehend: Warten auf PDF-Generierung.
- PDF generiert: PDFs erstellt, warten auf E-Mail-Versand.
- Gesendet: Erfolgreich versendet.

Aktion: Klicken Sie auf das Details-Symbol einer Batchzeile, um deren Detailliste anzuzeigen.

3. Detailliste (Elemente)

Diese Ansicht listet jeden einzelnen Empfänger innerhalb des ausgewählten Batches auf.

Funktionen

Suche: Sie können nach Empfänger (An), Status, Fehlermeldung oder Dateninhalt (JSON) suchen.
Filter: Verwenden Sie das Dropdown, um nur bestimmte Status anzuzeigen (z. B. nur „Fehler").
Batch löschen: Die Schaltfläche Batch löschen ermöglicht das Entfernen des gesamten Batchverlaufs.

Statusdefinitionen

Status	Interner Wert	Beschreibung
Ausstehend	`pending`	Wartet auf PDF-Generierung durch das System.
PDF generiert	`pdf_generated`	PDF wurde erfolgreich erstellt. Wartet auf Versand.
Gesendet	`sent`	E-Mail wurde erfolgreich an den SMTP-Server übermittelt.
Fehler (Import)	`error_import`	Datenimport für dieses Element fehlgeschlagen.
Fehler (PDF)	`error_pdf`	PDF-Generierung fehlgeschlagen.
Fehler (E-Mail)	`error_email`	E-Mail-Versand fehlgeschlagen (wiederholbar).
Fehler (E-Mail Fatal)	`error_email_fatal`	E-Mail-Versand dauerhaft fehlgeschlagen (z. B. ungültige Adresse).

Häufige Fehlermeldungen

Die folgenden Fehler können in der Spalte Fehlermeldung oder in der Fehlerliste des Batches erscheinen:

E-Mail-Versandfehler

MISSING_TO_RECIPIENT: Die „An"-Adresse ist leer. Prüfen Sie Ihre Zuordnungskonfiguration.
INVALID_EMAIL_FORMAT: Das E-Mail-Adressformat ist ungültig.
BACKEND_CONNECTION_FAILED: Verbindung zum SMTP-Server nicht möglich. Prüfen Sie Ihre Internetverbindung oder VPN.
SMTP_AUTH_ERROR: SMTP-Authentifizierung fehlgeschlagen. Prüfen Sie Benutzername und Passwort.
RETRY_LIMIT_REACHED_SKIP: Das System hat nach der maximalen Anzahl von Wiederholungen aufgegeben und dieses Element übersprungen.
RETRY_LIMIT_REACHED_ABORT: Das System hat nach der maximalen Anzahl von Wiederholungen aufgegeben und den Batch abgebrochen.

Import- und Verarbeitungsfehler

TEMPLATE_FILE_NOT_FOUND: Die konfigurierte PDF-Vorlagendatei fehlt im Arbeitsbereich.
MISSING_MASTER_LOOKUP_VALUE: Das Element hat keinen Wert für den Suchschlüssel (z. B. Kunden-ID ist leer), daher konnten keine Masterdaten abgerufen werden.
CSV_DATA_EMPTY_OR_UNREADABLE: Die importierte CSV-Datei war leer oder beschädigt.

4. Elementdetails (Bearbeiten & Wiederholen)

Durch Klicken auf das Details-Symbol eines Elements können Sie dessen Daten ändern oder einen fehlgeschlagenen Prozess erneut starten.

Daten ändern

Sie können E-Mail-Adressen (An, CC, BCC) korrigieren, falls diese fehlerhaft importiert wurden.

Warnung zur Datenkonsistenz

Eingabefelder vs. Masterdaten-JSON

Die An/CC/BCC-Eingabefelder auf der linken Seite sind getrennt vom Kunden-Masterdaten-JSON auf der rechten Seite.

Die Eingabefelder steuern, wohin die E-Mail gesendet wird für diesen spezifischen Versuch.
Die JSON-Daten werden für die PDF-Generierung und das Vorlagenrendering verwendet.
Eine Änderung des einen aktualisiert nicht automatisch das andere. Wenn Sie eine E-Mail-Adresse für den Versand korrigieren müssen, aktualisieren Sie das Eingabefeld.

Status ändern (Wiederholung)

Der Status ändert sich beim Speichern nicht automatisch. Sie müssen den entsprechenden Status manuell auswählen, um eine Wiederholung auszulösen:

Ausstehend: Wählen Sie diesen Status, um das aktuelle PDF zu verwerfen und die Generierung erneut zu versuchen (z. B. nach Korrektur der JSON-Daten).
PDF generiert: Wählen Sie diesen Status, um den Versand des vorhandenen PDFs erneut zu versuchen (z. B. nach Korrektur einer E-Mail-Adresse).

JSON bearbeiten

Sie können Document Content Data und Customer Master Data direkt bearbeiten.

JSON-Syntax

Seien Sie beim Bearbeiten von JSON äußerst vorsichtig. Sie müssen die gültige Syntax einhalten, einschließlich doppelter Anführungszeichen (""), Kommas (,) und Klammern ([], {}). Ungültiges JSON führt dazu, dass der Prozess erneut fehlschlägt.