Eine Umwandlung für mehrere Abläufe
Eine Anwendung erstellt einen Bericht, eine andere benötigt einen PDF-Anhang. Wenn jede dafür ihren eigenen Browser und ihre eigenen Schriften mitbringt, wächst der Wartungsaufwand. Ein eigener Umwandlungsdienst kann diese Aufgabe zentral übernehmen.
Gotenberg ist eine Docker-Anwendung mit einer Schnittstelle für Dokumentumwandlungen. In meiner Umgebung taucht sie unter anderem im Dokumenten- und Automatisierungsumfeld auf. Der praktische Vorteil liegt in der klaren Aufgabenverteilung: Ein Ablauf liefert die Vorlage, der Dienst erzeugt daraus die Datei.
Zuerst die Vorlage vollständig machen
Ein PDF aus HTML hängt von mehr als dem sichtbaren Text ab. Schriften, Bilder und Formatregeln müssen bei der Umwandlung verfügbar sein. Eine Vorlage, die am eigenen Rechner gut aussieht, kann auf dem Server anders ausfallen, wenn dort eine Ressource fehlt.
Für wiederkehrende Berichte bevorzuge ich deshalb eine möglichst vollständige Vorlage mit bewusst bereitgestellten Dateien. Größen, Seitenränder und Umbrüche gehören dazu. Gerade Tabellen mit langen Bezeichnungen sollten mit realistischen Beispielen geprüft werden, bevor die Ausgabe automatisch verschickt wird.
Mit einer festen Prüfausgabe beginnen
Zum Einstieg eignet sich ein kleines Dokument mit Überschrift, Fließtext, Tabelle und einem langen Absatz. Prüfen Sie die erste und letzte Seite, Sonderzeichen, abgeschnittene Zeilen und leere Seiten. Ein zusätzliches Bild zeigt, ob die eingebundenen Ressourcen wirklich ankommen.
Diese Datei bleibt als Vergleich erhalten. Nach einer Änderung an Vorlage, Schrift oder Container wird sie erneut erzeugt. So lässt sich eine sichtbare Abweichung gezielt einer Änderung zuordnen, statt erst durch eine fehlerhafte Kundenunterlage davon zu erfahren.
Die Schnittstelle gehört in einen begrenzten Bereich
Ein Dienst, der Dokumente verarbeitet und Webseiten abruft, benötigt einen bewusst begrenzten Zugang. In einem eigenen Aufbau sollten nur die vorgesehenen Anwendungen die Schnittstelle aufrufen können. Eine beliebige öffentliche Upload-Adresse entsteht daraus nicht automatisch.
Besonders bei URL-Aufträgen muss auch der ausgehende Zugriff betrachtet werden. Die Gotenberg-Dokumentation beschreibt Filter für solche Ziele. Welche Regeln passen, hängt davon ab, ob ausschließlich eigene Vorlagen oder auch fremde Webseiten verarbeitet werden. Interne Verwaltungsadressen gehören nicht unkontrolliert in diesen Zugriffspfad.
Inhalt und Zustellung getrennt prüfen
Ein erfolgreicher Aufruf bedeutet zunächst, dass eine Ausgabe erzeugt wurde. Ob alle Daten der Vorlage enthalten sind und die Datei richtig abgelegt oder versandt wurde, sind zusätzliche Fragen. Diese Nachweise sollten im aufrufenden Ablauf getrennt sichtbar bleiben.
Vorlagen und erzeugte Dokumente haben außerdem unterschiedliche Lebenszyklen. Eine Vorlage wird weiterentwickelt, ein fertiger Bericht soll seinen damaligen Stand bewahren. Aufbewahrung, Zugriff und Sicherung der Ausgaben werden deshalb außerhalb des Umwandlungsdienstes festgelegt.
Wann sich die Trennung lohnt
Gotenberg ist besonders hilfreich, wenn mehrere Anwendungen wiederholt PDFs erzeugen sollen. Für die manuelle Bearbeitung einzelner PDF-Dateien bleibt eine dafür gedachte Oberfläche oft bequemer. Beide Werkzeuge können sich ergänzen.
Mein Einstieg wäre ein begrenzter Bericht mit festen Beispieldaten. Erst wenn Gestaltung, Inhalt und Fehlerbehandlung geprüft sind, folgt der automatische Betrieb. So wird aus einer technischen Umwandlung ein nachvollziehbarer Bestandteil des eigenen Arbeitsablaufs.