Exports PDF
Créez des modèles de documents personnalisés pour générer des PDF professionnels à partir des données de vos objets : factures, devis, bons de livraison, rapports et bien plus.
Introduction
L'écran Exports PDF de la Configuration vous permet de concevoir visuellement des modèles de documents. Chaque modèle est composé de pages, et chaque page est construite à l'aide de widgets que vous disposez librement.
Les données de vos objets sont injectées dynamiquement dans le document grâce à des formules. Par exemple, le nom du client, la date de la facture et les lignes de produits sont automatiquement remplis.
Bon à savoir
Pour qu'un objet puisse être exporté en PDF, l'option « Objet exportable » doit être activée dans sa configuration. Vous pouvez créer plusieurs modèles d'export pour un même type d'objet.
Créer un modèle d'export
Dans la fenêtre « Nouveau modèle d'export », vous renseignez les informations suivantes :
| Propriété | Description |
|---|---|
| « Nom technique » | Identifiant unique utilisé en interne |
| « Nom du modèle » | Nom affiché dans la liste des exports disponibles |
| « Nom du fichier exporté » | Nom du fichier PDF généré (peut contenir des formules ; par défaut, le nom du modèle) |
| « Template PDF (optionnel) » | Fichier PDF de fond, 10 Mo au plus (ex : papier à en-tête). Laissez vide pour créer un document vierge |
Les pages du document s'ajoutent ensuite dans l'éditeur visuel.
Conseil
L'action « Dupliquer » du menu d'un modèle (« Créer une copie du modèle ») permet de créer des variantes rapidement. C'est idéal pour avoir un modèle de facture "classique" et un modèle "détaillé" basés sur la même structure.
Les pages
Chaque modèle contient une ou plusieurs pages. Le « Mode de page » de chacune est l'un des deux suivants :
« Standard » (page unique)
Une seule page est générée pour l'objet. C'est le mode par défaut, adapté à la plupart des documents.
« Itérée » (répétée pour chaque élément)
Génère automatiquement plusieurs pages en parcourant une liste. Par exemple, une page par ligne de facture ou une fiche par produit.
Dans « Itérer sur », vous indiquez une expression MEL qui retourne la liste à parcourir. Chaque élément de la liste génère une page.
Options de page
| Option | Description |
|---|---|
| « Pagination » | Afficher le numéro de page |
| « Marges de la page (pt) » | Espacement autour du contenu (haut, bas, gauche, droite), en points |
Les widgets
Le contenu de chaque page est construit à l'aide de widgetsimbriqués. Chaque widget est un élément visuel que vous configurez et positionnez pour composer votre document.
Propriétés communes
Tous les widgets partagent ces propriétés de base :
| Propriété | Description |
|---|---|
| « Largeur » / « Hauteur » | Dimensions du widget |
| Marges internes | Espace entre le bord du widget et son contenu (« Haut », « Bas », « Gauche », « Droite ») |
| Marges externes | Espace autour du widget (« Haut », « Bas », « Gauche », « Droite ») |
| « Couleur bordure » / « Épaisseur bordure » | Couleur et épaisseur du contour |
| « Couleur de fond » | Couleur d'arrière-plan du widget |
Types de widgets disponibles
La bibliothèque « Widgets » de l'éditeur propose :
« Texte »
Affiche du texte statique ou dynamique (via des formules)
« Image »
Affiche une image (logo, illustration...)
« Disposition linéaire »
Conteneur horizontal ou vertical : dispose les éléments en ligne ou en colonne
« Disposition relative »
Conteneur dont les éléments se superposent depuis son coin supérieur gauche
« Disposition en grille »
Grille de lignes et colonnes
« Tableau »
Tableau statique avec en-têtes et mise en forme configurable
« Tableau dynamique »
Tableau alimenté par une formule retournant une liste d'objets
Widget Texte
Le widget texte est le plus utilisé. Il permet d'afficher du texte statique ou des données dynamiques grâce à des formules entre accolades. Son champ « Texte » « Supporte la syntaxe Markdown et {champ} pour les valeurs dynamiques ».
Le Markdown met en forme le texte à la génération du PDF : gras avec **texte**, italique avec *texte*, listes avec - ou 1., titres avec #.
Exemple de contenu dynamique
Dans le contenu du widget, insérez des formules entre accolades pour injecter les données de l'objet :
Facture n° {numero}
Client : {client.nom}
Date : {dateFacture}
Montant TTC : {montantTTC} EUR| Option | Description |
|---|---|
| « Police » | Arial, Helvetica, Lato ou Avenir |
| « Graisse » | Léger, Normal ou Gras |
| « Taille » | Taille de police en points |
| « Hauteur de ligne » | Espacement entre les lignes de texte |
| « Couleur du texte » | Couleur du texte |
| Alignement « Horizontal » | Début, Centre ou Fin |
| Alignement « Vertical » | Début, Centre ou Fin |
| « Ne pas couper le texte » | Pas de retour à la ligne automatique : seuls vos propres retours à la ligne comptent, et le widget s'élargit à la longueur du texte |
Widgets de disposition
Les widgets de disposition vous permettent d'organiser la structure de votre document.
« Disposition linéaire »
Dispose les éléments enfants en ligne horizontale ou en colonne verticale.
| Option | Description |
|---|---|
| « Direction » | « Horizontal » pour une ligne, « Vertical » pour une colonne |
| « Alignement » | Début, Centre ou Fin |
| « Justification » | Répartition des éléments le long de la direction : « Début » (serrés au début) ou « Espacé » (le premier et le dernier aux extrémités, l'espace partagé entre eux) |
« Disposition en grille »
Organise le contenu dans une grille de lignes et colonnes ; vous placez vos widgets dans chaque case. Chaque case apparaît dans l'arborescence du modèle comme une « Boîte » : sélectionnée, elle règle sa « Position dans la grille », « Colonne » et « Rangée » de « Début » et de « Fin ».
| Option | Description |
|---|---|
| « Colonnes » | Nombre de colonnes de la grille |
| « Lignes » | Nombre de lignes de la grille |
« Disposition relative »
Conteneur dont les éléments partent tous de son coin supérieur gauche et se superposent ; chacun se décale avec ses propres marges.
Widgets de tableaux
Deux types de tableaux sont disponibles selon vos besoins :
« Tableau »
Un tableau statique avec un nombre fixe de lignes et colonnes. Vous configurez manuellement chaque cellule.
Options : « Nombre de colonnes », en-têtes, « Épaisseur des lignes ».
« Tableau dynamique »
Un tableau alimenté par une formulequi retourne une liste d'objets. Le nombre de lignes s'adapte automatiquement aux données.
C'est le widget idéal pour les lignes de facture, les listes de produits, ou tout contenu tabulaire de longueur variable.
| Option | Description |
|---|---|
| « Formule » | Expression retournant la liste de données |
| En-têtes | Noms des colonnes affichés |
| Champs | Propriétés des objets à afficher dans chaque colonne |
Exemple : tableau de lignes de facture
Pour afficher les lignes d'une facture, vous créez un widget « Tableau dynamique » pointant vers la liste des lignes. Les colonnes pourraient être : "Désignation" (champ designation), "Quantité" (quantite), "Prix unitaire" (prixUnitaire), et "Total" (total).
Prochaine étape
Vos factures ont leur modèle PDF. Branchez maintenant la facturation électronique et votre comptabilité.