Print Generierungsdialog

Owned by Christopher Holden
Last updated: März 11, 2024 by Sebastian Schulz
2 min read

Um eine Generierung zu starten, kann bei einem Dokument oder einem Inhalt die Aktion "Generieren" ausgeführt werden. Diese Aktion wird in der Toolbar im jeweiligen Datensatz oder im Kontextmenü angeboten. Nach Ausführen der Aktion wird ein Modal geöffnet, in dem nach einer Konfiguration für die Generierung gefragt wird.

Es besteht mit der Aktion "Als Standard definieren" auch die Möglichkeit, die ausgewählte Konfiguration für das nächste Generieren bei dem aktuellen Dokument oder Inhalt zu hinterlegen. Diese Konfiguration wird beim nächsten Mal automatisch ausgewählt werden.

Generierung Konfiguration

Die Konfiguration für die Generierung definiert, wie und was beim Generierungsprozess beachtet werden soll.

Ausgabearten

Browseransicht

Das generierte HTML wird mit dem Styling aus dem Theme in einem neuen Browsertab dargestellt. Diese Ansicht dient als Vorschau für das Element und kann in verschiedenen Browser kleine Unterschiede aufweisen.

Preflight-Ansicht

Die Preflight-Ansicht dient dazu, ein einheitliches Ergebnis zu generieren. Hierbei wird das HTML über den Server verarbeitet und weist damit keine Browser-Unterschiede beim Verteilen der Inhalte auf mehrere Seiten mehr auf. Diese Ansicht dient damit als Vorschau für die Verteilung der Elemente.

Technisch wird das HTML hier an einen Headless Chrome via Puppeteer übergeben.

Druck PDF

Bei der Ausgabe "Druck PDF" wird das HTML serverseitig zu einem PDF umgewandelt und zum Download angeboten.

Technisch wird das HTML an Puppeteer übergeben um Seitenumbrüche und ähnliches und verarbeiten und das Ergebnis ohne Javascript mit PdfReactor zu einem PDF umgewandelt.

callas pdfToolbox Profile

Es kann im Dialog ein Profil gewählt werden, welches auf das Druck-PDF angewendet wird. Damit kann zum Beispiel ein Low-Res-PDF erzeugt werden.

Kontext-Hierarchie

Es gibt verschiedene Ebenen, in welchen Informationen als Kontext für die Generierung gespeichert werden können.

  • Generierung Konfiguration (PrintRenderConfiguration) → Unabhängig des Inhalts, unabhängig der speziellen Generierung

    • Bsp. Umbruchverhalten, Beginn Seitenzahl, Formatierung Inhaltsverzeichnis, Callas Profil

  • Dokument (PrintDocument), Inhalt (PrintPage) → Abhängig des Inhalts, unabhängig der speziellen Generierung 

    • Bsp. Warengruppe

  • Generierung Kontext (PrintRenderContext) → Abhängig des Inhalts, abhängig der speziellen Generierung 

    • Bsp. Sprache, Ausgabekanal (Browser, PDF)