Concevoir dans le Générateur

Commencez avec un modèle

Créez un modèle depuis Modèles dans votre compte ou ouvrez un modèle existant dans le Générateur. Utilisez Ressources pour ajouter textes, titres, tableaux, images ou graphiques. Sélectionner un élément du canevas affiche ses paramètres dans l’Inspecteur.

Mise en page et espace disponible

Utilisez Mise en page pour la position, la taille et l’alignement, et Style pour la typographie et les espacements. Le flux suit l’ordre du document ; le placement absolu convient aux positions précises. Préférez le flux pour les rapports extensibles et testez les sauts de page avec des données longues.

Taille, marges et espacements intérieurs

Une largeur de 100% remplit la zone conteneur, pas la feuille entière. Les marges réduisent la surface utile et les espacements intérieurs réduisent l’espace dans un élément. Les tableaux et graphiques dans des colonnes sont aussi limités par leur largeur.

Effectuez la même opération via l’API

L’éditeur écrit la définition du modèle par le même point de terminaison que vous pouvez appeler vous-même. Lisez la définition actuelle, modifiez-la puis réécrivez-la avec la version lue, pour éviter d’écraser accidentellement une modification publiée entre-temps par quelqu’un d’autre.

# 1 - Télécharger la définition utilisée par l’éditeur
curl -s https://api.pdfgine.com/api/v1/templates/invoice \
  -H "X-PDFgine-Key: $PDFGINE_KEY" > invoice.json

# 2 - Modifier l’objet "definition" dans invoice.json

# 3 - Réécrire avec le même numéro de version
curl -X POST https://api.pdfgine.com/api/v1/templates \
  -H "X-PDFgine-Key: $PDFGINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "code": "invoice",
        "name": "Invoice",
        "saveMode": "manual",
        "expectedVersion": 1,
        "changeReason": "Logo déplacé vers la marge droite.",
        "definition": { "page": { "size": "A4", "orientation": "portrait" }, "elements": [] }
      }'

expectedVersion garantit cette sécurité. Si le modèle a évolué, l’écriture est refusée avec une réponse 409 contenant la version actuelle ; relisez, réappliquez votre modification puis écrivez à nouveau.

Enregistrer et vérifier les sorties

Enregistrez vos modifications, puis vérifiez l’Aperçu et la sortie PDF ou Word requise. Un exemple tenant dans le canevas peut produire plus de pages avec des données réelles plus longues. Vérifiez ensemble titres, tableaux, libellés de graphiques et sauts de page avant de publier.

Les problèmes les plus courants

• Ce que vous voyez dans l’éditeur est le brouillon. Tant que vous ne publiez pas, chaque rendu de production utilise l’ancienne version publiée.
• Les données d’exemple sont plus courtes que les données réelles. Une mise en page tenant dans le canevas peut déborder sur une deuxième page avec un véritable nom de client, une adresse et trente lignes.
• 100% désigne la zone conteneur, pas la feuille. Les marges extérieures et intérieures sont déduites avant de déterminer la largeur de l’élément.
• Le positionnement absolu ne s’écarte pas. Un élément placé à des coordonnées fixes reste en place pendant que le contenu en flux grandit ; utilisez flow pour tout contenu pouvant s’étendre sur plusieurs pages.
• Deux personnes sur le même modèle produisent un 409, pas une fusion. L’écriture contient la version de départ et est refusée si celle-ci a évolué.