Bevor Sie beginnen
Um Ihnen den Einstieg in Tembuilder zu erleichtern, führen wir Sie durch die Erstellung Ihres ersten PDF aus einer vorhandenen Rechnungsvorlage. Sie werden versuchen, den Inhalt zu bearbeiten, die Daten zu ändern und eine Vorschau des Ergebnisses anzuzeigen, bevor Sie ein PDF generieren – alles innerhalb der App.
Bevor Sie beginnen, melden Sie sich an und gehen Sie zum Dashboard Vorlagen. Sie können Ihrem Projekt mit einer der folgenden Methoden eine Vorlage hinzufügen.
1. Wählen Sie eine Vorlage aus und öffnen Sie sie
Verwenden Sie eine vorhandene ZIP-Datei oder wählen Sie eine Vorlage von Gallery.
Methode 1: Importieren Sie eine ZIP-Datei
Laden Sie die Rechnungsvorlage (.zip) herunter, klicken Sie unter Vorlagen auf Importieren und wählen Sie die heruntergeladene Datei aus. Geben Sie einen Namen und einen Slug für die Vorlage ein und warten Sie, bis der Import abgeschlossen ist.
Methode 2: Wählen Sie eine Vorlage aus Gallery
Öffnen Sie Gallery, wählen Sie eine Rechnungsvorlage aus und zeigen Sie eine Vorschau des Designs an. Fügen Sie es Ihrem Projekt hinzu, geben Sie einen Namen und einen Slug ein und warten Sie, bis es fertig ist.
Öffnen Sie die Vorlage im Editor
Nachdem Sie eine Vorlage mit einer der beiden Methoden hinzugefügt haben, öffnen Sie sie in Vorlagen, um mit der Bearbeitung zu beginnen.
Wählen Sie im Editor einen Abschnitt in Structure aus. Die verfügbaren Registerkarten HTML, CSS, Props und Config hängen von Ihrer Auswahl ab. Versuchen Sie, eine Beschriftung in Props zu ändern, wenn die Vorlage dieses Feld bereitstellt, und überprüfen Sie dann die Vorschau.
2. Testen Sie die Daten und zeigen Sie eine Vorschau an
Öffnen Sie Parameters → Schema, um Feldnamen und Standardeinstellungen zu überprüfen. Namen unverändert lassen. Layout zeigt Ihre aktuellen Designänderungen.
Speichern Sie die Vorlage, bevor Sie PDF öffnen. Die PDF-Vorschau verwendet gespeicherte Vorlageninhalte und die Parameterwerte des Editors, die ursprünglich aus Defaults ausgefüllt wurden. Nachdem Sie eine weitere Änderung gespeichert haben, generieren Sie PDF neu, um sie anzuzeigen. Die vorherige Vorschau wird nicht automatisch aktualisiert. Die Vorschau verbraucht kein Renderkontingent.
Die Eingaben in Run sind von der PDF-Vorschau getrennt. Um neue Run-Werte zu testen, rendern und überprüfen Sie das Ergebnis dieses Jobs in den Schritten 3–4.
Das Beispiel JSON verwendet invoiceNumber, seller, customer und lineItems, passend zur obigen ZIP-Adresse. Weitere Vorlagen finden Sie im eigenen Parameters. Wenn Sie API aufrufen, fügen Sie das Datenobjekt in parameters ein.
3. Speichern, veröffentlichen und generieren
- Speichern Sie Ihre Änderungen, wählen Sie die richtige Version aus und veröffentlichen Sie sie.
- Erstellen Sie bei Bedarf einen Projektschlüssel API mit der Berechtigung
template:render. - Run öffnen, Schlüssel, Version und Variante auswählen und Daten eingeben.
- Klicken Sie auf Rendern und warten Sie auf den Abschluss.
Für echte Renderings ist eine veröffentlichte Version erforderlich. Jedes erfolgreiche Rendern verbraucht Kontingent; Eine funktionierende Vorschau allein bedeutet nicht, dass eine Vorlage zum Rendern bereit ist.
4. Herunterladen und prüfen
Öffnen Sie nach Erfolg das Ergebnis und laden Sie PDF herunter. Sie finden den Job auch unter Renders. Überprüfen Sie die erste Seite, die letzte Seite und die Datenzeilen in der heruntergeladenen Datei.
Wenn dies fehlschlägt, lesen Sie die Fehlerdetails, bevor Sie es erneut versuchen. Mit jedem Render-Klick kann ein neuer Job erstellt werden. Siehe häufige Fehler, wenn Sie die Ursache nicht identifizieren können.