Comment automatiser la création de documents PDF avec un moteur de rendu HTML

L'automatisation de la création de documents est une fonctionnalité cruciale pour de nombreux produits SaaS, que ce soit pour générer des factures, des rapports ou des certificats. À l'aide d'un moteur de rendu HTML, les développeurs peuvent convertir du contenu HTML dynamique en documents PDF ou en images PNG de haute qualité avec seulement quelques lignes de code. Dans ce guide, nous vous montrerons comment intégrer les capacités de création de documents d'ExoAPI dans votre produit SaaS, économisant ainsi du temps et des efforts.

Pourquoi automatiser la génération de documents ?

L'automatisation de la création de documents permet aux entreprises de :

• Générez des documents cohérents et d'aspect professionnel à grande échelle.
• Gagnez du temps en automatisant les tâches répétitives comme la facturation ou la génération de rapports.
• Améliorez la précision en supprimant la création manuelle de documents, réduisant ainsi le risque d'erreurs.
• Proposer aux clients des documents personnalisés basés sur des données dynamiques (par exemple, des rapports personnalisés).

Cas d'utilisation pour la génération automatisée de documents

Voici quelques exemples pratiques où les capacités d'automatisation des documents peuvent simplifier les flux de travail de vos produits SaaS :

• Systèmes de facturation : générez automatiquement des PDF des factures clients en fonction des détails de la commande. Exemple : après qu'un client a passé une commande, générez dynamiquement une facture PDF de marque et envoyez-la-lui par e-mail.
• Tableaux de bord de rapports : permet aux utilisateurs de télécharger des rapports au format PDF. Exemple : Un produit SaaS proposant des analyses peut permettre aux utilisateurs d'exporter leurs données sous forme de rapports PDF d'aspect professionnel.
• Certificats et badges : créez des certificats ou des badges PNG téléchargeables pour les cours terminés, les événements ou les réalisations. Exemple : Une plateforme d'apprentissage en ligne pourrait générer automatiquement des certificats personnalisés pour les étudiants à la fin d'un cours.
• Résumés de commande pour le commerce électronique : générez automatiquement des confirmations de commande ou des étiquettes d'expédition au format PDF ou PNG. Exemple : Après avoir passé une commande, générez une étiquette d'expédition au format PDF, prête à être imprimée.

Voyons comment configurer la génération automatique de documents à l'aide du moteur de rendu HTML d'ExoAPI.

Prérequis : S'inscrire à ExoAPI

Visitez ExoAPI et créez un compte pour obtenir votre clé API.

1. Installez le SDK :

npm install @flower-digital/exoapi-sdk

2. Créer une instance d'ExoAPI :

Dans votre application JavaScript ou Node.js, initialisez l'ExoAPI avec votre clé API :

import { ExoAPI } from "@flower-digital/exoapi-sdk";
const exoapi = new ExoAPI({ apiKey: YOUR_API_KEY });

Exemple de génération PDF de base

Regardons maintenant un exemple simple de génération d'un PDF à partir de contenu HTML. L'extrait de code suivant montre comment créer un document PDF avec un style de base :

npm install @flower-digital/exoapi-sdk

Comment ça marche :

• La fonction htmlRenderer() envoie une chaîne HTML à ExoAPI, qui la traite et renvoie un document PDF.
• Nous enregistrons le PDF localement à l'aide du module fs de Node.js, en écrivant le fichier sous le format document.pdf.
• Vous pouvez remplacer la chaîne HTML par du contenu dynamique ou des modèles en fonction des exigences de votre application (par exemple, les détails du client, les résumés de commande).

Personnalisation PDF avancée

ExoAPI offre une variété d'options pour personnaliser vos PDF. Vous pouvez contrôler la taille de la page, les marges, l'orientation, les en-têtes, les pieds de page et même injecter du CSS personnalisé pour un style précis.

Voici un exemple avancé montrant comment personnaliser la sortie PDF :

import { ExoAPI } from "@flower-digital/exoapi-sdk";
const exoapi = new ExoAPI({ apiKey: YOUR_API_KEY });

Paramètres clés :

• titre : Le titre du document PDF, qui apparaîtra dans les métadonnées.
• pageSize : Définit la taille du PDF (par exemple, A4, Letter, etc.). Vous pouvez également définir des dimensions explicites à l'aide de pageWidth et pageHeight.
• marge : définit des marges uniformes pour le document, ou utilisez marginTop, marginLeft, etc., pour un contrôle plus granulaire.
• paysage : défini sur true pour l'orientation paysage ou sur false pour le portrait.
• css : des CSS personnalisés peuvent être ajoutés pour styliser le contenu du document.
• en-tête et pied de page : vous pouvez ajouter des en-têtes et des pieds de page avec des espaces réservés pour le numéro de page, le total des pages et la date.

Générer des images PNG

ExoAPI prend également en charge la génération d'images PNG à partir de contenu HTML. Ceci est utile lorsque vous avez besoin d'une sortie visuelle, telle que des badges, des certificats ou des rapports visuels. Voici un exemple de la façon de générer une image PNG :

import { ExoAPI } from "@flower-digital/exoapi-sdk";
import fs from "fs";

const exoapi = new ExoAPI({ apiKey: YOUR_API_KEY });

async function htmlRenderer() {
  try {
    const res = await exoapi.htmlRenderer({
      html: '<p style="padding:8px;font-size:36px">Hello <b style="color: green">world!</b></p>',
      format: "pdf",
    });
    fs.writeFileSync("document.pdf", Buffer.from(await res.arrayBuffer()));
    console.log("PDF document generated successfully!");
  } catch (err) {
    console.error("Error generating PDF:", err);
  }
}

htmlRenderer();

Personnalisation des dimensions de l'image :

• Les paramètres imageWidth et imageHeight vous permettent de spécifier la taille de l'image PNG en pixels.
• Si imageHeight n'est pas fourni, il s'adaptera automatiquement pour s'adapter au contenu.

Commencer

Le moteur de rendu HTML d'ExoAPI rend la création de documents dans les produits SaaS incroyablement simple et personnalisable. Avec seulement quelques lignes de code, vous pouvez automatiser la génération de PDF et d'images, en rationalisant les processus tels que la facturation, le reporting et la création de documents visuellement attrayants. En intégrant ExoAPI dans votre flux de travail, vous pouvez améliorer les fonctionnalités de votre application tout en gagnant du temps sur les tâches de création manuelle de documents.

Essayez ExoAPI dès aujourd'hui pour voir comment il peut simplifier la création de documents et augmenter la productivité de vos applications SaaS. Consultez la documentation officielle d'ExoAPI pour explorer plus de fonctionnalités et d'options de personnalisation.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!