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

La génération de documents à l’aide de la fusion de courrier est la méthode qui consiste à lire les données d’une source de données et à remplacer les variables correspondantes dans un document modèle. Elle nécessite généralement deux fichiers, un modèle pour stocker les champs de fusion - la variable pour les données à insérer. L’autre contient à la fois les instructions de formatage des données variables et les informations qui seront identiques pour chaque résultat de la fusion de courrier.

Les modèles peuvent être créés en utilisant différentes syntaxes. PDF4me accepte les modèles Word, HTML et PDF pour générer des documents. Avec le nouveau moteur de rapport, vous pouvez utiliser une structure syntaxique simple pour concevoir des modèles avancés dans Word pour vos factures, reçus, contrats, devis, ou tout autre document personnalisé. Pour une lecture détaillée suivez le lien vers notre documentation -

Comment concevoir des modèles Word ?

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

<<[Nom du champ]>>

Vous pourrez également ajouter des expressions conditionnelles à évaluer et ajouter une option de données particulière en fonction du résultat de la condition. Voyons brièvement comment ces options peuvent être utilisées pour concevoir des modèles Word pour 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 introduire des données dans les modèles. En fonction de 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 qu’une donnée particulière ne soit remplie.

Syntaxe de la condition If else

Une syntaxe de base de la façon dont une condition if-else peut être utilisée dans un document.

<<si [condition1]>>
  Ajouter les premières données
  <<elseif [condition2]>>
    Ajouter les secondes données
  <<else>>
    Ajouter une troisième donnée
<</if>>

Il existe des conditions plus avancées que vous pouvez appliquer. En savoir plus sur les expressions conditionnelles

Formater dans les modèles

Lors de la génération de documents, il se peut que vous souhaitiez appliquer un formatage à un résultat alimenté dynamiquement, comme la valeur d’une expression. Grâce à PDF4me, vous pouvez facilement appliquer un formatage aux résultats de votre condition ou expression.

La syntaxe de base pour appliquer le formatage -

<<[token] : "format">>

Par exemple…

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

Pour connaître toutes les possibilités de formatage [en savoir plus sur le formatage des modèles Word] (/general-guidelines/formatting-in-word-template/)

Tableaux dans les modèles

Les tableaux sont un élément très courant de la plupart des documents. Ils permettent d’afficher efficacement les données pour faciliter la comparaison, la référence ou le calcul. Le générateur de documents PDF4me peut insérer efficacement des tableaux dans les documents en fonction des données.

Examinons des exemples de création de la syntaxe des tableaux.

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

Colonne 1 : <<foreach [product in products]>><<[product.productName]>>.
Colonne 2 : <<[produit.fabriqué] : "yyyy.MM.dd">>
Colonne 3 : <<[produit.prix]>><</foreach>>.

Pour en savoir plus sur les différentes structures de tableau, vous pouvez consulter la documentation sur les tableaux (/general-guidelines/tables-in-templates/).

Ajouter des images dans les modèles

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

Les images peuvent être ajoutées de deux façons

Utilisation de l’URL d’une image publique

<<image [imageUrl]>>

Les données peuvent être transmises à la syntaxe ci-dessus de la manière suivante respectivement -

Avec une chaîne Base64 d’une image

<<image [imageBase64]>>

Lisez la documentation pour plus de détails sur [l’ajout d’images dans les modèles Word avec des exemples] (/general-guidelines/images-in-templates/).

Insérer des extraits HTML dans les modèles

Désormais, vous pouvez également ajouter directement des sections et des mises en forme HTML aux modèles pour alimenter les données. Vous pouvez utiliser la syntaxe suivante pour insérer le HTML

<<[token] -html>>

Pour voir l’exemple [lire la documentation sur l’insertion de HTML dans les modèles Word] (/general-guidelines/html-in-templates/)

Exemple de modèle

Examinons un échantillon rapide à essayer. Voici un exemple de modèle Word et de données pour vous permettre de tester rapidement l’action de génération de document. Vous pouvez télécharger le modèle Word et utiliser le JSON pour le modèle à tester.

Exemples de données

{
    "VendorName" : "PDF4me",
    "VendorCity" : "Zurich",
    "VendorCountry" : "Suisse",
    "VendorZip" : "8630",
    "VendorContact":"123456",
    "InvoiceDate":"22-08-2022",
    "Nom du client" : "John Doe",
    "CustomerCity" : "Ville de départ",
    "CustomerCountry" : "US",
    "CustomerZip":"3214",
    "produits" : [
    {
      "prodctName" : "Convertisseur PDF",
      "valeur" : 2000,
      "expire" : "01/08/2025"
    },
    {
      "productName" : "PDF API",
      "valeur" : 1250,
      "expire" : "18/02/2029"
    },
    {
      "productName" : "PDF Editor",
      "valeur" : 1999,
      "expire" : "12/12/2027"
    }
   ],
   "comment" : "Ce document est <b>généré par ordinateur</b> et ne nécessite pas de signature.",
  }