Liaison de données dans les templates PDF

La liaison de données injecte du contenu dynamique dans vos templates. Vous définissez les variables dans l’éditeur, puis vous envoyez les vraies valeurs par l’API au moment de générer le PDF.

Définir des variables

Dans n’importe quel élément texte, tapez une variable entre doubles accolades :

Bonjour {{customer_name}} !

Le total de votre facture est de {{amount}}.

Les variables fonctionnent aussi dans les images (champ Source URL or Variable), les codes-barres (champ Value) et les QR codes (champ Content) : par exemple {{product_image}} comme source d’une image, ou {{tracking_number}} comme valeur d’un code-barres.

Envoyer les données par l’API

Quand vous appelez l’API pour générer un PDF, ajoutez vos données sous forme de paires clé-valeur :

{
  "template_id": "your_template_id",
  "data": {
    "customer_name": "John Doe",
    "amount": "$1,234.56"
  }
}

Chaque {{variable}} du template est remplacée par la valeur correspondante de vos données.

Types de données

Plusieurs types de valeurs sont acceptés :

• Texte — "John Doe", "INV-2026-001"
• Nombres — 1234.56, 42
• URL — "https://example.com/logo.png" (pour les images dynamiques, les QR codes)
• Listes — des tableaux JSON d’objets, pour les lignes répétées d’un tableau (voir plus bas)
• Objets — des données imbriquées, lues avec la notation pointée (voir plus bas)

Données imbriquées

La notation pointée donne accès aux champs d’un objet :

{{customer.name}}
{{customer.address.city}}

Avec ces données :

{
  "customer": {
    "name": "Acme Corp",
    "address": {
      "city": "Paris"
    }
  }
}

Listes et tableaux dynamiques

Quand vous envoyez une liste, les lignes du tableau se répètent automatiquement, une par élément. Construisez la ligne du tableau avec des variables de liste :

| {{items.description}} | {{items.qty}} | {{items.unit_price}} |

Puis envoyez une liste dans vos données :

{
  "items": [
    { "description": "Widget A", "qty": 2, "unit_price": 15.00 },
    { "description": "Widget B", "qty": 5, "unit_price": 8.50 }
  ]
}

Le tableau affiche une ligne par élément. Les tableaux dynamiques sont détaillés dans Tableaux.

Variables manquantes

Si une variable du template n’a pas de clé correspondante dans les données, elle s’affiche vide : aucun texte {{variable_name}} n’apparaît dans le résultat. Vos templates peuvent donc contenir des champs facultatifs. Dans un calcul, une variable manquante compte pour zéro (voir Expressions).

Tester dans l’éditeur

Pas besoin d’appeler l’API pour tester vos variables. Ouvrez l’onglet Preview de l’éditeur et saisissez des données de test dans le panneau de droite. L’aperçu se met à jour tout seul : vous voyez votre template avec de vraies valeurs.

Le bouton Add missing key crée automatiquement une entrée pour chaque variable trouvée dans le template.

Pour aller plus loin

• Expressions — calculez des totaux et des moyennes directement dans vos templates
• Variables système — les variables intégrées pour les dates, les numéros de page, etc.
• Référence API — la documentation complète de l’API de génération de PDF