Données de test

Dernière mise à jour le 23 mars 2026

Les données de test vous permettent de prévisualiser le rendu de votre modèle avec des valeurs réelles avant de générer le moindre document. Vous saisissez un exemple JSON dans l’éditeur de payload, et le builder reflète immédiatement ces données sur le canevas (les blocs Text affichent votre contenu, les images se chargent depuis vos URL, et les boucles se répètent sur vos tableaux).

Ouvrir l’éditeur de payload

Cliquez sur le bouton Edit Test Data dans la barre d’outils en haut du canevas. Cela ouvre une fenêtre contenant un éditeur JSON complet propulsé par Monaco (le même éditeur utilisé dans VS Code).

Format JSON

Saisissez vos données de test sous forme d’objet JSON. Les clés de premier niveau deviennent les variables disponibles dans l’ensemble de votre modèle. Consultez les règles de nommage pour savoir quels formats de clés sont valides.

{
  "name": "Marie Dupont",
  "company": "Acme Corp",
  "date": "2025-03-15",
  "items": [
    { "description": "Widget A", "quantity": 2, "price": 19.99 },
    { "description": "Widget B", "quantity": 1, "price": 49.99 }
  ],
  "logo_url": "https://example.com/logo.png"
}

L’éditeur de payload supporte les commentaires JSON (commentaires en ligne // et commentaires en bloc /* */). Les commentaires sont supprimés lors de l’analyse, ils n’affectent donc jamais votre modèle. Utilisez-les pour noter quels champs sont requis ou quel format une valeur doit respecter :

{
  // Informations client
  "name": "Marie Dupont",
  "email": "marie@example.com",

  /* Tableau d'articles - chaque article nécessite description, quantity et price */
  "items": []
}

Données de test par défaut

Les nouveaux modèles sont fournis avec un payload par défaut contenant des champs courants comme name, company, items, date et url. Remplacez-les par des données correspondant à vos payloads de documents réels (les valeurs par défaut ne sont qu’un point de départ).

Comment les données de test se connectent à votre modèle

Les données de test sont le pont entre la conception de votre modèle et les valeurs dynamiques qui apparaîtront dans le PDF final. Trois fonctionnalités du builder lisent directement vos données de test :

Lorsque vous configurez une liaison de propriété (par exemple, en définissant la source d’un bloc Image), une liste déroulante du navigateur de variables apparaît. Elle répertorie chaque chemin disponible dans vos données de test. Si vos données de test contiennent logo_url au premier niveau et items[0].description imbriqué dans un tableau, les deux chemins apparaissent comme options sélectionnables.

Conditions de visibilité

Le paramètre d’affichage conditionnel du panneau Logic évalue des expressions JavaScript par rapport à vos données de test. Quand vous saisissez une condition comme items.length > 0, le panneau montre immédiatement si l’élément est actuellement visible ou masqué en fonction des valeurs des données de test.

Répétition

Lorsque vous configurez la répétition sur un élément et le pointez vers une collection comme items, le builder itère sur ce tableau dans vos données de test. Le canevas affiche une copie de l’élément pour chaque item, ce qui vous permet de voir exactement à quoi ressemble votre mise en page répétée avec des données réelles.

Aperçu en direct

Les modifications des données de test mettent à jour le canevas immédiatement. Modifiez un nom, ajoutez un élément à un tableau, ou changez une URL, et le modèle se re-rend en temps réel. Cela fait de l’éditeur de payload l’outil principal pour déboguer le contenu dynamique (si quelque chose ne va pas, vérifiez d’abord vos données de test).

Lien avec la génération de documents

La structure JSON que vous utilisez comme données de test est la même structure que vous transmettez en tant que payload lors de la génération de documents via l’API ou le tableau de bord. Garder vos données de test réalistes garantit que ce que vous voyez dans le builder correspond à ce que vous obtenez dans le PDF final.

Les données de test sont enregistrées avec le modèle. Vous pouvez fermer l’éditeur et revenir plus tard sans perdre votre payload d’exemple.

Conseils pour des données de test efficaces

  • Couvrez toutes les branches : si votre modèle a des conditions de visibilité, incluez des données de test qui déclenchent à la fois l’état visible et l’état masqué. Changez les valeurs entre les essais pour vérifier les deux chemins.
  • Utilisez des longueurs de tableau réalistes : si votre modèle se répète sur une liste d’articles, testez avec un article, quelques-uns, et suffisamment d’articles pour déclencher un saut de page. Les cas limites dans la répétition sont plus faciles à détecter tôt.
  • Reproduisez votre payload de production : plus vos données de test ressemblent aux vrais payloads API, moins vous aurez de surprises lors de la génération de documents réels.

Questions fréquentes

Que sont les données de test dans le builder PDFMonkey ?
Les données de test sont un exemple JSON que vous saisissez dans l’éditeur de payload pour prévisualiser le rendu de votre modèle avec du contenu réaliste. Le builder les utilise pour remplir le texte, les images et les boucles en temps réel avant de générer des documents.
Quels formats de clés JSON sont valides pour les données de test PDFMonkey ?
Les clés doivent être des identifiants JavaScript valides : camelCase, snake_case ou noms préfixés par un dollar fonctionnent. Les clés contenant des points, des espaces, des tirets ou commençant par un chiffre sont invalides car le builder les traite comme des expressions JavaScript.
Les données de test sont-elles sauvegardées avec mon modèle PDFMonkey ?
Oui. Les données de test sont sauvegardées avec le modèle, vous pouvez donc fermer l’éditeur et y revenir plus tard sans perdre votre payload d’exemple.
La structure JSON des données de test correspond-elle au payload de l'API ?
Oui. La structure JSON que vous utilisez comme données de test est la même que celle que vous transmettez comme payload lors de la génération de documents via l’API. Garder des données de test réalistes garantit que l’aperçu du builder correspond au PDF final.
Navigation