Conversion HTML vers PDF via l'API Gotenberg - Workflow n8n

Développeurs ayant besoin de solutions fiables et auto-hébergées pour la génération automatisée de documents.
Utilisateurs nécessitant un outil de conversion PDF privé et à fort volume, intégré à leur environnement n8n existant.
Utilisateurs techniques à la recherche de modèles n8n avancés démontrant la gestion complexe des fichiers binaires et l'intégration d'API externes.
Toute personne utilisant Docker pour sa configuration n8n et souhaitant tirer parti d'autres services conteneurisés.

Générer des documents PDF de haute qualité à partir de contenu HTML dynamique est un défi courant dans l'automatisation. Bien que de nombreux services en ligne existent, ils soulèvent souvent des problèmes de confidentialité ou d'évolutivité. Ce modèle de workflow n8n spécialisé résout ce problème en s'intégrant directement à un service Gotenberg auto-hébergé, fonctionnant en toute sécurité à côté de votre instance n8n.

Cette automatisation offre une méthode sécurisée et hautement personnalisable pour créer des rapports professionnels, des factures ou des documents complexes. Le workflow accepte les données HTML et un nom de fichier de sortie souhaité via son déclencheur n8n initial, gère la préparation du fichier en interne, et envoie la requête à Gotenberg, assurant une génération PDF efficace et privée. Maîtriser cette automatisation n8n signifie avoir un contrôle total sur votre pipeline documentaire, une fonctionnalité essentielle pour les systèmes professionnels.

Ce workflow n8n se déclenche lorsqu'il est exécuté manuellement ou appelé par un webhook ou un déclencheur externe, attendant le contenu HTML et un nom de fichier souhaité.

1. Déclenchement de l'entrée : Le workflow démarre au niveau du nœud de déclenchement n8n Create PDF from HTML. Ce nœud est configuré pour attendre deux champs d'entrée essentiels : html (le contenu à convertir) et file_name (le nom du PDF résultant).


2. Préparation du Fichier : Le flux passe ensuite au nœud n8n Create index.html, qui utilise la fonction interne convertToFile. Il prend la chaîne html entrante et la convertit en un fichier binaire nommé index.html. C'est une étape nécessaire pour empaqueter correctement le HTML destiné à l'API Gotenberg.


3. Appel API Gotenberg : L'étape cruciale se produit dans le nœud n8n Convert to PDF with Gotenberg (un nœud HTTP Request n8n). Ce nœud effectue une requête POST vers le service Gotenberg (par défaut http://gotenberg:3000/forms/chromium/convert/html). Il envoie le fichier binaire préparé à l'étape précédente en utilisant l'encodage multipart-form-data.


4. Personnalisation des Métadonnées : De manière critique, ce nœud n8n transmet également des métadonnées personnalisées (telles que l'Auteur, le Titre, la Date de Création et les Mots-clés) dans le corps de la requête. Il définit également le nom de fichier de sortie dynamiquement via une expression faisant référence à l'entrée initiale définie dans le déclencheur n8n.


5. Sortie : Gotenberg retourne le document PDF généré en sortie binaire, qui peut ensuite être enregistré, téléchargé vers un stockage cloud, ou joint à un e-mail en utilisant les nœuds n8n suivants.

Pour déployer ce modèle de workflow n8n avec succès, suivez ces étapes :

1. Importation du workflow n8n : Copiez les données JSON fournies et collez-les dans votre environnement n8n en utilisant la fonction 'Nouveau' -> 'Importer depuis JSON'.


2. Prérequis : Configuration de Gotenberg : Ce workflow nécessite un service Gotenberg fonctionnel. La méthode la plus simple consiste à s'assurer que n8n et Gotenberg s'exécutent sur le même réseau Docker. Une configuration Docker typique ressemble à ceci :

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

1. Configuration de l'URL de l'API : Dans le nœud n8n Convert to PDF with Gotenberg, vérifiez l'URL. Si votre service Gotenberg est hébergé en dehors du réseau Docker standard ou sur un port différent, vous devez mettre à jour le paramètre url de http://gotenberg:3000/forms/chromium/convert/html vers votre point de terminaison spécifique.


2. Personnalisation des Métadonnées : Examinez les 'Paramètres de corps' dans le nœud n8n Convert to PDF with Gotenberg pour ajuster les métadonnées du PDF comme Author et Title selon vos besoins.


3. Test : Exécutez manuellement le déclencheur n8n Create PDF from HTML pour vérifier qu'un PDF est généré correctement.

Create PDF from HTML (Déclencheur d'Exécution de Workflow)
Fonction : Sert de point de départ (déclencheur n8n) pour le workflow, fournissant des données d'exemple pour l'exécution.
Configuration Clé : Les données d'entrée sont définies avec le contenu html et le file_name de sortie souhaité.

Create index.html (Conversion en Fichier)
Fonction : Transforme la chaîne HTML d'entrée en un fichier binaire stockable (index.html). Gotenberg exige que l'entrée soit envoyée sous forme de fichier, rendant ce nœud n8n essentiel pour la préparation.
Configuration Clé : operation: toText, sourceProperty: html, fileName: index.html.

Convert to PDF with Gotenberg (Requête HTTP)
Fonction : Envoie le fichier HTML binaire préparé au service Gotenberg auto-hébergé pour le convertir en document PDF. C'est l'action centrale de l'ensemble du workflow n8n.
Configuration Clé :
URL : http://gotenberg:3000/forms/chromium/convert/html (Doit être ajustée si vous utilisez un service distant).
Type de contenu : multipart-form-data.
Paramètres de corps : Inclut l'entrée de données binaires et des métadonnées PDF étendues au format JSON pour la personnalisation.
* En-têtes : Utilise l'en-tête Gotenberg-Output-Filename avec une expression dynamique pour définir le nom final du PDF en fonction de l'entrée du déclencheur n8n initial.