Aller au contenu principal
Blog · Automatisation des documents

Créer des modèles avancés pour la génération de documents

15 janv. 2023 · Concevez des modèles avancés pour générer ou remplir des documents. Utilisez des notions de syntaxe simples pour concevoir des modèles avancés pour vos factures, reçus, etc.

La génération de documents par publipostage consiste à lire des données provenant d'une source et à remplacer les variables correspondantes dans un document modèle. Elle nécessite généralement deux fichiers : un fichier modèle contenant les champs de fusion (les variables contenant les données à insérer) et un fichier contenant les instructions de mise en forme des données variables ainsi que les informations qui seront identiques pour chaque document résultant du publipostage.

Il est possible de créer des modèles à l'aide de différentes syntaxes. PDF4me accepte les modèles Word, HTML et PDF pour la génération de documents. Grâce au nouveau moteur de génération de rapports, vous pouvez utiliser une structure de syntaxe simple pour concevoir des modèles avancés au format Word pour vos factures, reçus, contrats, devis ou tout autre document personnalisé. Pour plus d'informations, consultez notre documentation.

Comment concevoir des modèles Word ?

Vous pouvez créer manuellement les champs de fusion ou les jetons selon la syntaxe suivante

<<[NomDuChamp]>>

Vous pourrez également ajouter des expressions conditionnelles pour évaluer et ajouter une option de données spécifique en fonction du résultat de la condition. Voyons brièvement comment ces options peuvent être utilisées pour concevoir des modèles Word destinés à la génération de documents.

Expressions conditionnelles

L'action « Générer des documents » de PDF4me vous permet d'utiliser des expressions conditionnelles pour alimenter des modèles. Selon l'état d'une condition, des données dynamiques peuvent être ajoutées à un document. Vous pouvez même combiner des expressions pour satisfaire plusieurs conditions avant le remplissage d'une donnée particulière.

syntaxe de condition if else

Syntaxe de base de l'utilisation d'une condition if-else dans un document -

Si [condition1]>> Ajouter les premières données <<sinon si [condition2]>> Ajouter les deuxièmes données <<sinon>> Ajouter les troisièmes données <</si>>

Vous pouvez appliquer des conditions plus avancées. Pour en savoir plus, consultez la section sur les instructions conditionnelles.

Mise en forme dans les modèles

Lors de la génération de documents, vous pouvez appliquer une mise en forme à un résultat généré dynamiquement, comme la valeur résultante d'une expression. Avec PDF4me, vous pouvez facilement formater les résultats de votre condition ou expression.

La syntaxe de base pour appliquer une mise en forme -

<<[token]:"format">>

Ex.

Date de la facture : <<[invoiceDate]:"dd.MM.yyyy">>

Pour connaître toutes les options de mise en forme, consultez la documentation sur la mise en forme des modèles Word.

Tableaux dans les modèles

Les tableaux sont un élément très courant de la plupart des documents. Ils permettent de présenter efficacement les données pour faciliter la comparaison, la consultation ou les calculs. Le générateur de documents PDF4me peut insérer efficacement des tableaux dans les documents à partir des données.

Examinons des exemples de création de la syntaxe d'un tableau.

Nous pouvons créer une liste de produits pour comprendre cela.

Colonne 1 : <<foreach [product in products]>><<[product.productName]>> Colonne 2 : <<[product.manufactured]:"yyyy.MM.dd">> Colonne 3 : <<[product.price]>><</foreach>>

Vous trouverez plus d'informations sur les différentes structures de tables dans la documentation relative aux tables.

Ajouter des images aux modèles

PDF4me permet également d'insérer des images dans les documents. La syntaxe des images peut être ajoutée lors de la conception du modèle.

Il est possible d'ajouter des images de deux manières différentes.

Utilisation d'une URL d'image publique

<<image [imageUrl]>>

Les données peuvent être transmises à la syntaxe ci-dessus de différentes manières :

Avec une chaîne Base64 d'une image

<<image [imageBase64]>>

Consultez la documentation pour plus de détails sur l'ajout d'images dans les modèles Word, avec des exemples .

Insérer des extraits HTML dans les modèles

Vous pouvez désormais ajouter directement des sections HTML et une mise en forme aux modèles pour le remplissage des données. Utilisez la syntaxe suivante pour insérer le code HTML.

<<[token] -html>>

Pour voir un exemple , consultez la documentation relative à l'insertion de code HTML dans les modèles Word.

Modèle d'exemple

Prenons un exemple rapide. Voici un modèle Word et des données pour tester rapidement l'action de génération de document. Vous pouvez télécharger le modèle Word et utiliser le JSON correspondant pour vos tests.

Données d'exemple

{ "VendorName": "PDF4me", "VendorCity":"Zurich", "VendorCountry":"Switzerland", "VendorZip":"8630", "VendorContact":"123456", "InvoiceDate":"22-08-2022", "CustomerName":"John Doe", "CustomerCity":"Start City", "CustomerCountry":"US", "CustomerZip":"3214", "products": [ { "prodctName": "PDF Converter", "value": 2000, "expires": "01/08/2025" }, { "productName": "PDF API", "value": 1250, "expires": "18/02/2029" }, { "productName": "PDF Editor", "value": 1999, "expires": "12/12/2027" } ], "comment":"Ce document est <b>généré par ordinateur</b> et ne nécessite pas de signature.", }

Préparez vos documents.

Intégrez-le à votre produit grâce à l'API, automatisez-le sans coder ou utilisez les outils gratuits directement dans votre navigateur. Aucune carte de crédit n'est requise pour commencer.

Commencez par un seul appelcurl -X POST https://api.pdf4me.com/v1/ConvertToPdf

Niveau gratuit · Aucune carte de crédit requise