Das App-Backend
Prozess-Leitstand
Rendering-Anfragen einsehen, Probleme erkennen und verwalten
Der Prozess-Leitstand (früher "Cockpit") ermöglicht eine intuitive Steuerung und Überwachung aller Output-Management-Prozesse in Echtzeit, mit Zugriff auf detaillierte Einstellungen und gezielte Steuerungsoptionen für individuelle Rendering-Anfragen.
Diese Seite zeigt eine Liste aller Elemente, und darüber diverse Aktionen, die du ausführen kannst:
Rendering-Anfragen-Liste
Die Übersicht zeigt alle Rendering-Anfragen mit ihren Metadaten, Status-Informationen und zugehörigen Prozessen.
ID, Externe ID, Vorlage-Identifier
ID | Externe ID | Vorlage-Identifier |
|---|---|---|
| 8814056 | Null | rechnung_monatsabschluss_main |
| 7583922 | Null | rechnung_monatsabschluss_mail |
ID
Eindeutige Nummer zur internen Identifikation der Rendering-Anfrage. Wird bei sehr langen IDs abgekürzt dargestellt (z.B. "100140…").
Externe ID
Optionale externe Identifikation der Rendering-Anfrage, die von externen Systemen übergeben werden kann. Wird als "Null" Badge angezeigt, wenn keine externe ID vorhanden ist.
Vorlage-Identifier
Identifier bzw. Gruppen-Identifier der docx-Vorlage oder E-Mail-Vorlage, die für diese Rendering-Anfrage verwendet wird.
Status, Kommentar, E-Mail Prozesse, Renderprozesse
Status | Kommentar | E-Mail Prozesse | Renderprozesse |
|---|---|---|---|
| done | kommentar zum prozess | -- | System-ID: 6092552 Vorlage Monatsabrechnung Hauptdokument render_template |
| custom_mapping | Null | System-ID: 6092551 E-Mail-Vorlage Rechnungsversand send_email | -- |
Status
Aktueller Verarbeitungsstatus der Rendering-Anfrage. Siehe Status-Badges für Details zu den verschiedenen Status-Werten.
Kommentar
Optionaler Kommentar zur Rendering-Anfrage für interne Notizen und Dokumentation. Kann Text enthalten oder als "Null" Badge angezeigt werden, wenn kein Kommentar vorhanden ist.
E-Mail Prozesse
Mit dieser Rendering-Anfrage verknüpfte E-Mail-Prozesse. Wird als "--" angezeigt, wenn keine E-Mail-Prozesse vorhanden sind. Wenn E-Mail-Prozesse vorhanden sind, werden sie als klickbare Badges mit System-ID, Template-Name und Prozess-Typ (z.B. "send_email") angezeigt.
Renderprozesse
Mit dieser Rendering-Anfrage verknüpfte Dokumenten-Renderprozesse. Wird als "--" angezeigt, wenn keine Renderprozesse vorhanden sind. Wenn Renderprozesse vorhanden sind, werden sie als klickbare Badges mit System-ID, Template-Name und Prozess-Typ (z.B. "render_template") angezeigt.
Erstellt am, Aktualisiert am
| Validatoren | Pausiert | Aktiv | Erstellt am | Aktualisiert am |
|---|---|---|---|---|
| Null | NO | Ja | ||
| missing_street | YES | Nein |
Zugewiesene Validierungsregeln für das Rendering-Anfrage. Prüfen Ihre Bedingungen vor der Verarbeitung und aktivieren/deaktivieren das Rendering entsprechend.
Temporäre Deaktivierung des Rendering-Anfrages. Pausierte Elemente werden nicht verarbeitet.
Aktivierungsstatus des Rendering-Anfrages. Nur aktive Elemente werden beim Rendern berücksichtigt.
Erstellt am
Zeitstempel der Rendering-Anfrage-Erstellung.
Aktualisiert am
Zeitstempel der letzten Änderung. Zeigt wann Rendering-Anfrage-Konfiguration zuletzt bearbeitet wurde.
Kontext-Aktionen
Jede Rendering-Anfrage bietet über das Drei-Punkte-Menü am Ende der Zeile verschiedene Aktionen:
Aktions-Dropdown
Aktions-Dropdown
Erneut versuchen
Anzeigen
Kommentar bearbeiten
Im Prozess-Leitstand anzeigen
Löschen
Aktions-Dropdown
Klicken Sie auf das Drei-Punkte-Menü am Ende jeder Zeile für Aktionen mit der jeweiligen Rendering-Anfrage.
Erneut versuchen
Startet die Verarbeitung der Rendering-Anfrage erneut. Nützlich bei fehlgeschlagenen oder hängengebliebenen Anfragen.
Anzeigen
Öffnet eine reine Detailansicht der kompletten Meta-Informationen und Einstellungen der Rendering-Anfrage.
Kommentar bearbeiten
Öffnet ein Bearbeitungsformular, um den Kommentar der Rendering-Anfrage zu ändern oder hinzuzufügen.
Im Prozess-Leitstand anzeigen
Öffnet die detaillierte Prozess-Leitstand-Ansicht für diese spezifische Rendering-Anfrage mit allen zugehörigen Prozessen und Status-Informationen.
Löschen
Entfernt die Rendering-Anfrage dauerhaft aus dem System. Diese Aktion kann nicht rückgängig gemacht werden.
Achtung: Die Aktion "Erneut versuchen" ist nur für Rendering-Anfragen mit Status "start" verfügbar. Für abgeschlossene Anfragen (Status "done") stehen nur "Anzeigen", "Kommentar bearbeiten" und "Löschen" zur Verfügung.
Im Prozess-Leitstand anzeigen
Die Detailansicht "Im Prozess-Leitstand anzeigen" bietet eine umfassende Übersicht über eine einzelne Rendering-Anfrage mit vollständigem Zugriff auf alle Metadaten, den Payload und Steuerungsoptionen.
Page Header Actions
In der Detailansicht stehen verschiedene Aktionen zur Verfügung, die je nach Status der Rendering-Anfrage und zugehöriger E-Mail-Prozesse angezeigt werden:
Bedingte Anzeige: Die E-Mail-bezogenen Aktionen (Als nicht zugestellt markieren, Als zugestellt markieren, E-Mail erneut senden, Als bearbeitet markieren, Erneut senden) werden nur angezeigt, wenn entsprechende E-Mail-Prozesse vorhanden sind und bestimmte Status-Bedingungen erfüllt sind.
Request-Details
Die Detailansicht zeigt alle relevanten Informationen zur Rendering-Anfrage in einer übersichtlichen Tabellenstruktur:
Anfrage 10014075 wurde am 11.11.2025 00:11:03 empfangen und beim Verarbeiten blockiert. Siehe Logs für Details.
Externe ID | 105003 |
|---|---|
Template-Identifier des Requests | rechnung_mahnung_template |
Status | start |
Kommentar | Optionaler Kommentar zur Rendering-Anfrage... Kommentar speichern |
Logs
Fehler- und Verarbeitungslogs werden in einem ausklappbaren Accordion angezeigt:
[2025-11-11 00:03:05] Error occurred: Custom code error: Custom code error: Brand ID not found.
[2025-11-11 00:03:07] Error occurred: Custom code error: Custom code error: Brand ID not found.
[2025-11-11 00:03:12] Error occurred: Custom code error: Custom code error: Brand ID not found.
[2025-11-11 00:03:43] Error occurred: Custom code error: Custom code error: Brand ID not found.JSON-Editor und Payload-Bearbeitung
Auf der rechten Seite der Detailansicht befindet sich ein vollständiger JSON-Editor, der den kompletten Payload der Rendering-Anfrage anzeigt und bearbeitbar macht, um eventuelle fehlerhafte Daten zu korrigieren oder Nachträge vorzunehmen:
Vorschau
Daten speichern und erneut versuchen
Prozesse löschen und Anfrage schließen
{
"version": 8,
"document": {
"identifier": "rechnung_monatsabschluss_main",
"accountId": "ACCT-10293",
"items": [
{
"position": 1,
"description": "Grundgebühr",
"value": 29.9
},
{
"position": 2,
"description": "Verbrauch",
"value": 58.12
}
]
}
}Strukturiertes JSON zur Fehleranalyse und für schnelle Korrekturen am Request-Payload.
JSON-Konfiguration
Validieren Sie Änderungen mit dem gleichen Schema, das auch für die eigentlichen Requests genutzt wird.
Der Editor verändert ausschließlich den Inhalt des Feldes data, das im POST-Request an die Rendering-API übergeben wird (z.B. Rechnungspositionen, Kundendaten, Diagramm-Werte). Top-Level-Felder wie template, externalId, webhook, comment, emailServer, format oder metadata sind Teil des Requests selbst und werden außerhalb dieses Editors gepflegt.
Preview vor Save & Retry
Mit Vorschau können Sie die aktuell bearbeiteten JSON-Daten und Kommentaränderungen prüfen, bevor Sie Daten speichern und erneut versuchen ausführen. Die Preview rendert Dokumente und E-Mail-Inhalte transient und zeigt Fehler direkt im Artefakt an.
Das Request-Preview-Modal zeigt:
- eine kompakte Workflow-Zusammenfassung,
- Template-Zuordnungen für Dokument- und E-Mail-Templates,
- Webhook-Entscheidungen pro simuliertem Prozess,
- ausgeführte Validierungen inklusive Ergebnis, Fehlertext und Begründung,
- Dokument-Previews inklusive PDF-, HTML- und TXT-Inline-Anzeige,
- E-Mail-HTML oder Text-Fallback inklusive Empfänger, Betreff, Sender und Mailserver-Status,
- verknüpfte Anhang-Dokumente und Artefaktfehler.
PDF-, HTML-, TXT- und E-Mail-Previews können per Vollbild öffnen auf den gesamten Browser-Viewport erweitert werden. So lassen sich Layout, lange Textausgaben und E-Mail-HTML vor dem produktiven Retry besser prüfen.
Die Preview im Prozess-Leitstand verändert den bestehenden Request nicht, speichert keine Prozessartefakte dauerhaft und löst keine Workflows, Webhooks oder E-Mail-Transporte aus. Cockpit-Benutzer können die Preview nur für Requests ihres Mandanten- bzw. Subclient-Kontexts starten.
Wichtig: Änderungen am JSON-Payload können das Verhalten der Rendering-Anfrage erheblich beeinflussen. Stellen Sie sicher, dass Sie die Struktur und die Werte korrekt anpassen, bevor Sie die Daten speichern und erneut versuchen.
Tipp: Der JSON-Editor unterstützt Syntax-Highlighting, Fehlererkennung und automatische Formatierung. Nutzen Sie zuerst Vorschau, um geänderte Payloads zu prüfen, und starten Sie erst danach mit Daten speichern und erneut versuchen die produktive Verarbeitung.
Modal-Bestätigungen
Bestimmte Aktionen (z.B. "Prozesse löschen und Anfrage schließen") erfordern eine Bestätigung über ein Modal:
Möchten Sie diese Aktion wirklich ausführen?
Status-Badges
Die Status-Badges zeigen den aktuellen Verarbeitungsstatus jeder Rendering-Anfrage:
start Start
Rendering-Anfrage wurde erstellt und wartet auf Verarbeitung oder befindet sich aktuell in der Verarbeitung.
done Abgeschlossen
Rendering-Anfrage wurde erfolgreich verarbeitet und alle zugehörigen Prozesse (Dokumente, E-Mails) sind abgeschlossen.
custom_mapping Custom Mapping
Rendering-Anfrage befindet sich in der Verarbeitung durch ein eingerichtetes Datenmapping. Dieser Status tritt auf, wenn eine Datenmapping-Regel auf den Payload bzw. Request angewendet wird.
Tipp: Nutzen Sie die Filter-Funktion, um Rendering-Anfragen nach Status, Vorlage-Identifier, Datum oder anderen Kriterien zu filtern. Dies ist besonders nützlich bei großen Mengen von Anfragen.
Prozess-Leitstand-Integration und nächste Schritte
Der Prozess-Leitstand ist zentral für die Überwachung und Verwaltung aller Rendering-Prozesse. Verwandte Bereiche:
- Rendering-Anfragen: Detaillierte Verwaltung einzelner Rendering-Anfragen
- Dokumente: Übersicht aller gerenderten Dokumente
- E-Mails: Verwaltung aller E-Mail-Prozesse
- Dashboard: Gesamtübersicht über System-Performance und Statistiken