HTML zu PDF-Konvertierung mittels Gotenberg API - n8n-Workflow

Entwickler, die zuverlässige, selbst gehostete Lösungen für die automatisierte Dokumentenerstellung benötigen.
Anwender, die ein privates Hochleistungstool zur PDF-Konvertierung benötigen, das in ihre bestehende n8n-Umgebung integriert ist.
Technische Nutzer, die nach fortgeschrittenen n8n-Vorlagen suchen, welche die komplexe Handhabung von Binärdateien und die Integration externer APIs demonstrieren.
Jeder, der Docker für sein n8n-Setup nutzt und andere containerisierte Dienste einbinden möchte.

Die Erstellung hochwertiger PDF-Dokumente aus dynamischen HTML-Inhalten stellt in der Automatisierung eine häufige Herausforderung dar. Obwohl viele Online-Dienste existieren, bringen diese oft Datenschutzbedenken oder Skalierungsprobleme mit sich. Diese spezielle n8n-Workflow-Vorlage löst dies durch die direkte Integration mit einem selbst gehosteten Gotenberg-Service, der sicher neben Ihrer n8n-Instanz läuft.

Diese Automatisierung bietet eine sichere und hochgradig anpassbare Methode zur Erstellung professioneller Berichte, Rechnungen oder komplexer Dokumente. Der Workflow akzeptiert HTML-Daten und einen gewünschten Dateinamen über den initialen n8n-Trigger, übernimmt intern die Dateivorbereitung und sendet die Anfrage an Gotenberg, was eine effiziente und private PDF-Generierung gewährleistet. Die Beherrschung dieser n8n-Automatisierung bedeutet die volle Kontrolle über Ihre Dokumenten-Pipeline – ein entscheidendes Merkmal für professionelle Systeme.

Dieser n8n-Workflow wird gestartet, wenn er manuell ausgeführt oder durch einen externen Webhook oder Trigger aufgerufen wird. Er erwartet HTML-Inhalte und einen gewünschten Dateinamen.

1. Eingabe-Trigger: Der Workflow beginnt beim n8n-Trigger-Knoten Create PDF from HTML. Dieser Knoten ist so konfiguriert, dass er zwei essentielle Eingabefelder erwartet: html (der zu konvertierende Inhalt) und file_name (der Name der resultierenden PDF).


2. Dateivorbereitung: Der Ablauf geht zum n8n-Knoten Create index.html über, der die interne Funktion convertToFile nutzt. Er nimmt den eingehenden html-String entgegen und wandelt ihn in eine Binärdatei namens index.html um. Dies ist ein notwendiger Schritt, um das HTML ordnungsgemäß für die Gotenberg API zu verpacken.


3. Gotenberg API-Aufruf: Der entscheidende Schritt erfolgt im n8n-Knoten Convert to PDF with Gotenberg (ein HTTP Request n8n-Knoten). Dieser Knoten führt eine POST-Anfrage an den Gotenberg-Service aus (standardmäßig http://gotenberg:3000/forms/chromium/convert/html). Er sendet die in Schritt 2 vorbereitete Binärdatei unter Verwendung der multipart-form-data-Kodierung.


4. Metadaten-Anpassung: Entscheidend ist, dass dieser n8n-Knoten auch angepasste Metadaten (wie Autor, Titel, Erstellungsdatum und Schlüsselwörter) im Request-Body übergibt. Zudem wird der Ausgabedateinamen dynamisch mithilfe eines Ausdrucks gesetzt, der auf die anfängliche Eingabe im n8n-Trigger zurückverweist.


5. Ausgabe: Gotenberg gibt das generierte PDF-Dokument als binäres Ergebnis zurück, das anschließend mit nachfolgenden n8n-Knoten gespeichert, in einen Cloud-Speicher hochgeladen oder einer E-Mail angehängt werden kann.

Um diese n8n-Workflow-Vorlage erfolgreich bereitzustellen, gehen Sie wie folgt vor:

1. n8n-Workflow importieren: Kopieren Sie die bereitgestellten JSON-Daten und fügen Sie sie in Ihrer n8n-Umgebung über die Funktion 'Neu' -> 'Aus JSON importieren' ein.


2. Voraussetzung: Gotenberg einrichten: Dieser Workflow benötigt einen laufenden Gotenberg-Service. Die einfachste Methode besteht darin, sicherzustellen, dass sowohl n8n als auch Gotenberg im selben Docker-Netzwerk laufen. Eine typische Docker-Konfiguration sieht wie folgt aus:

gotenberg:
        image: gotenberg/gotenberg:8
        restart: always

1. API-URL konfigurieren: Überprüfen Sie im n8n-Knoten Convert to PDF with Gotenberg die URL. Wenn Ihr Gotenberg-Service außerhalb des Standard-Docker-Netzwerks oder auf einem anderen Port gehostet wird, müssen Sie den Parameter url von http://gotenberg:3000/forms/chromium/convert/html auf Ihren spezifischen Endpunkt aktualisieren.


2. Metadaten anpassen: Überprüfen Sie die 'Body Parameters' im n8n-Knoten Convert to PDF with Gotenberg, um PDF-Metadaten wie Author und Title nach Ihren Wünschen anzupassen.


3. Testen: Führen Sie den n8n-Trigger Create PDF from HTML manuell aus, um sicherzustellen, dass ein PDF korrekt generiert wird.

Create PDF from HTML (Workflow auslösen)
Funktion: Dient als Ausgangspunkt (n8n-Trigger) für den Workflow und liefert Beispieldaten für die Ausführung.
Wichtige Konfiguration: Die Eingabedaten werden mit html-Inhalt und dem gewünschten Ausgabe-file_name definiert.

Create index.html (In Datei umwandeln)
Funktion: Wandelt den eingegebenen HTML-String in eine speicherbare Binärdatei (index.html) um. Da Gotenberg die Eingabe als Datei erwartet, ist dieser n8n-Knoten für die Vorbereitung unerlässlich.
Wichtige Konfiguration: operation: toText, sourceProperty: html, fileName: index.html.

Convert to PDF with Gotenberg (HTTP Request)
Funktion: Sendet die vorbereitete binäre HTML-Datei an den selbst gehosteten Gotenberg-Service zur Konvertierung in ein PDF-Dokument. Dies ist die Kernaktion des gesamten n8n-Workflows.
Wichtige Konfiguration:
URL: http://gotenberg:3000/forms/chromium/convert/html (Muss angepasst werden, wenn ein entfernter Service genutzt wird).
Content Type: multipart-form-data.
Body Parameters: Enthält die binäre Dateneingabe und umfangreiche, JSON-formatierte PDF-Metadaten zur Anpassung.
* Headers: Nutzt den Header Gotenberg-Output-Filename mit einem dynamischen Ausdruck, um den endgültigen PDF-Namen basierend auf der ursprünglichen n8n-Trigger-Eingabe festzulegen.