Avant de commencer
Pour vous aider à vous familiariser avec Tembuilder, nous vous guiderons dans la création de votre premier PDF à partir d’un modèle de facture existant. Vous essaierez de modifier le contenu, de modifier les données et de prévisualiser le résultat avant de générer un PDF, le tout dans l’application.
Avant de commencer, connectez-vous et accédez au tableau de bord Modèles. Vous pouvez ajouter un modèle à votre projet en utilisant l’une des méthodes ci-dessous.
1. Choisissez et ouvrez un modèle
Utilisez un fichier ZIP existant ou choisissez un modèle parmi Gallery.
Méthode 1 : Importer un fichier ZIP
Téléchargez le modèle de facture (.zip), cliquez sur Importer dans Modèles et sélectionnez le fichier téléchargé. Entrez un nom et un slug pour le modèle, puis attendez la fin de l’importation.
Méthode 2 : Choisissez un modèle parmi Gallery
Ouvrez Gallery, sélectionnez un modèle de facture et prévisualisez le design. Ajoutez-le à votre projet, entrez un nom et un slug, et attendez la fin.
Ouvrez le modèle dans l’éditeur
Après avoir ajouté un modèle en utilisant l’une ou l’autre méthode, ouvrez-le dans Modèles pour commencer l’édition.
Dans l’éditeur, sélectionnez une section dans Structure. Les onglets HTML, CSS, Props et Config disponibles dépendent de votre sélection. Essayez de modifier une étiquette dans Props si le modèle fournit ce champ, puis vérifiez l’aperçu.
2. Essayez les données et prévisualisez
Ouvrez Parameters → Schema pour inspecter les noms de champs et les valeurs par défaut. Gardez les noms inchangés. Mise en page affiche vos modifications de conception actuelles.
Enregistrez le modèle avant d’ouvrir PDF. L’aperçu PDF utilise le contenu du modèle enregistré et les valeurs des paramètres de l’éditeur, initialement renseignés à partir de Defaults. Après avoir enregistré une autre modification, régénérez le PDF pour le voir ; l’aperçu précédent ne se met pas à jour automatiquement. L’aperçu ne consomme pas de quota de rendu.
Les entrées dans Run sont distinctes de l’aperçu PDF. Pour tester les nouvelles valeurs Run, effectuez le rendu et inspectez le résultat de cette tâche aux étapes 3 et 4.
L’exemple JSON utilise invoiceNumber, seller, customer et lineItems, correspondant au ZIP ci-dessus. Pour les autres modèles, consultez leur propre Parameters. Lors de l’appel du API, placez l’objet de données dans parameters.
3. Enregistrez, publiez et générez
- Enregistrez vos modifications, sélectionnez la bonne version et publier.
- Créez une clé de projet API avec l’autorisation
template:rendersi nécessaire. - Ouvrez Run, sélectionnez la clé, la version et la variante, puis saisissez les données.
- Cliquez sur Render et attendez la fin.
Les rendus réels nécessitent une version publiée. Chaque rendu réussi consomme du quota ; un aperçu fonctionnel à lui seul ne signifie pas qu’un modèle est prêt à être rendu.
4. Téléchargez et vérifiez
Après succès, ouvrez le résultat et téléchargez le PDF. Vous pouvez également trouver le poste dans Renders. Vérifiez la première page, la dernière page et les lignes de données du fichier téléchargé.
En cas d’échec, lisez les détails de l’erreur avant de réessayer. Chaque clic de rendu peut créer un nouveau travail. Voir erreurs courantes si vous ne parvenez pas à identifier la cause.