Gestalten im Generator

Mit einer Vorlage beginnen

Erstellen Sie unter Vorlagen in Ihrem Konto eine Vorlage oder öffnen Sie eine vorhandene im Generator. Fügen Sie über Ressourcen Text, Überschriften, Tabellen, Bilder oder Diagramme hinzu. Die Auswahl eines Elements zeigt seine Einstellungen im Inspektor.

Layout und verfügbarer Platz

Verwenden Sie Layout für Position, Größe und Ausrichtung und Stil für Typografie und Innenabstände. Fließplatzierung folgt der Dokumentreihenfolge; absolute Platzierung eignet sich für feste Positionen. Bevorzugen Sie flow bei wachsenden Berichten und prüfen Sie Seitenumbrüche mit langen Daten.

Größe, Außen- und Innenabstände

100% Breite füllt den umgebenden Bereich, nicht das ganze Blatt. Seitenränder verkleinern den nutzbaren Dokumentbereich, Innenabstände den Platz innerhalb eines Elements. Tabellen und Diagramme in Spalten sind zusätzlich durch deren Breite begrenzt.

Dasselbe über die API ausführen

Der Editor schreibt die Vorlagendefinition über denselben Endpunkt, den Sie selbst aufrufen können. Lesen Sie die aktuelle Definition, ändern Sie sie und schreiben Sie sie mit der gelesenen Versionsnummer zurück. So überschreiben Sie nicht versehentlich zwischenzeitlich veröffentlichte Änderungen anderer Personen.

# 1 - Definition herunterladen, mit der der Editor arbeitet
curl -s https://api.pdfgine.com/api/v1/templates/invoice \
  -H "X-PDFgine-Key: $PDFGINE_KEY" > invoice.json

# 2 - Das Objekt „definition“ in invoice.json bearbeiten

# 3 - Mit derselben Versionsnummer zurückschreiben
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 an den rechten Rand verschoben.",
        "definition": { "page": { "size": "A4", "orientation": "portrait" }, "elements": [] }
      }'

expectedVersion sorgt für Sicherheit. Hat sich die Vorlage inzwischen geändert, wird das Schreiben mit 409 abgelehnt und die Antwort enthält die aktuelle Version. Lesen Sie erneut, wenden Sie Ihre Änderung wieder an und schreiben Sie nochmals.

Ausgaben speichern und prüfen

Speichern Sie die Änderungen und prüfen Sie Vorschau sowie benötigte PDF- oder Word-Ausgabe. Ein Beispiel, das auf die Arbeitsfläche passt, kann mit längeren echten Daten mehr Seiten erzeugen. Prüfen Sie Überschriften, Tabellen, Diagrammbeschriftungen und Seitenumbrüche gemeinsam vor der Veröffentlichung.

Häufige Fehler

• Im Editor sehen Sie den Entwurf. Bis zur Veröffentlichung verwendet jede Produktionserstellung weiterhin die ältere veröffentlichte Version.
• Beispieldaten sind kürzer als echte Daten. Ein Layout, das auf die Arbeitsfläche passt, kann bei echtem Kundennamen, Adresse und dreißig Zeilen auf eine zweite Seite überlaufen.
• 100% bezeichnet den umgebenden Bereich, nicht das Blatt. Außen- und Innenabstände werden abgezogen, bevor das Element seine Breite erhält.
• Absolute Platzierung weicht nicht aus. Ein Element an festen Koordinaten bleibt dort, während Fließinhalte daran vorbeiwachsen. Verwenden Sie flow für Inhalte, die mehrere Seiten umfassen können.
• Gleichzeitiges Bearbeiten derselben Vorlage führt zu 409, nicht zu einer Zusammenführung. Der Schreibvorgang enthält die Ausgangsversion und wird abgelehnt, wenn diese sich geändert hat.