Batch aus einer Tabelle

Der Dialog Batch aus Tabelle macht aus jeder Zeile einer CSV- oder Excel-Datei ein Dokument: ein Zertifikat pro Teilnehmerin, einen Brief pro Kunde, ein Namensschild pro Gast. Sie ordnen die Spalten der Tabelle den Feldern einer veröffentlichten Vorlage zu, und die App reiht alle Zeilen als einen Batch ein. Ist er fertig, laden Sie die Dokumente als ein Zip herunter.

Bevor Sie beginnen

• Eine veröffentlichte Vorlage. Der Dialog rendert die veröffentlichte Version einer Vorlage des aktuellen Workspace. Veröffentlichen Sie die Vorlage zuerst; Entwürfe werden nicht angeboten.
• Eine Rolle, die rendern darf. Inhaber, Admins und Editoren sehen die Schaltfläche, Betrachter nicht.
• Einheiten. Jede Zeile ist ein Live-Rendering und kostet Einheiten wie ein Rendering über die API: ein PDF mit bis zu 5 Seiten 1 Einheit, ein Bild 1 Einheit. Der Dialog nutzt nie die Testumgebung, die Dokumente tragen also kein Test-Wasserzeichen. Um die Vorlage vorher auszuprobieren, nutzen Sie Echtes Rendering im Editor oder einen Test-Schlüssel.

Ein Beispiel

Eine Zertifikatsvorlage, deren Beispieldaten so aussehen:

{
  "name": "Max Mustermann",
  "course": { "title": "Data Basics", "date": "2026-10-01" },
  "score": 92,
  "passed": true
}

und eine Tabelle mit einer Teilnehmerin oder einem Teilnehmer pro Zeile (hier als CSV; eine Excel-Datei mit derselben ersten Zeile funktioniert genauso):

name,course.title,date,score,passed,file
Max Mustermann,Data Basics,2026-10-01,92,yes,max-mustermann
Erika Mustermann,Data Basics,2026-10-01,88,yes,erika-mustermann
John Doe,Data Basics,2026-10-01,61,no,john-doe

Der Dialog ordnet name, course.title, score und passed über ihre Namen zu und date über seinen letzten Teil course.date, und sendet die erste Zeile als:

{
  "name": "Max Mustermann",
  "course": { "title": "Data Basics", "date": "2026-10-01" },
  "score": 92,
  "passed": true
}

Steht Dateiname aus Spalte auf file, heißen die drei Dokumente max-mustermann.pdf, erika-mustermann.pdf und john-doe.pdf.

Schritt für Schritt

Öffnen Sie Renderings und wählen Sie Batch aus Tabelle.

1. Vorlage. Wählen Sie eine der veröffentlichten Vorlagen des Workspace (die Liste zeigt jede mit ihrer veröffentlichten Version, Invoice · v7). Die Felder kommen aus dem gespeicherten Datenschema der Vorlage oder, wenn sie keines hat, aus den Beispieldaten der veröffentlichten Version.
2. Datei. Wählen Sie eine CSV-, TSV- oder Excel-Datei (.csv, .tsv, .txt, .xlsx, .xls, .ods). Die erste Zeile enthält die Spaltennamen; eine Spalte ohne Namen heißt column_1, column_2 und so weiter. Leere Zeilen werden übersprungen. Eine Arbeitsmappe mit mehreren Blättern zeigt die Auswahl Tabellenblatt mit der Zeilenzahl jedes Blatts; Blätter ohne Datenzeilen fehlen darin.
3. Spalten den Feldern zuordnen. Die Tabelle listet jedes Feld der Vorlage mit seinem Typ. Eine Spalte wird automatisch zugeordnet, wenn ihr Name dem vollständigen Pfad des Felds (course.title) oder seinem letzten Teil (title) entspricht, ohne Rücksicht auf Groß- und Kleinschreibung, Leerzeichen und Satzzeichen. Für jedes andere Feld wählen Sie unter Quelle eine Spalte, wählen Konstante und tippen einen Wert ein, der für jede Zeile gilt, oder lassen es auf — überspringen —.
4. Optionen.
   • Dateiname aus Spalte: die Spalte, die jedes Dokument benennt. Zeichen außer ASCII-Buchstaben, Ziffern, _, . und - werden zu _ (Müller GmbH wird zu M_ller_GmbH), und die Endung der Ausgabe wird angehängt. Mit Zeilennummer (Standard) heißen die Dokumente row-1, row-2 und so weiter, mit Nullen auf die Breite der Zeilenzahl aufgefüllt (row-001 bei 100 Zeilen und mehr). Eine leere Zelle in der Namensspalte führt ebenfalls zur Zeilennummer.
   • Ausgabe: Wie die Vorlage (PDF bei einer PDF-Vorlage, das Bildformat einer Bildvorlage, das Dokument einer Word- oder PowerPoint-Vorlage) oder eines der Formate, die die Vorlage erzeugen kann: PDF, PNG, JPG oder WebP bei HTML-Vorlagen; Word bzw. PowerPoint und PDF bei Office-Vorlagen.
   • Als Zip bündeln: standardmäßig an; packt alle Dokumente in ein Zip, wenn der Batch fertig ist.
5. Erste Zeile als Daten. Das Datenobjekt, das aus der ersten Zeile wird, genau so, wie die Vorlage es erhält. Darunter nennt Nicht zugeordnet die Felder, die in jedem Dokument leer bleiben.
6. n Renderings einreihen sendet den Batch.

Wie aus Zellen Werte werden

Feldtyp	Eine Zelle wird zu	Beispiel
string	Dem Text der Zelle, so wie die Tabelle ihn zeigt, ohne Leerzeichen am Rand; eine leere Zelle wird zu ""	Data Basics
number, integer	Einer Zahl; ein Dezimalkomma wird akzeptiert. Text, der keine Zahl ist (1.234,56 mit Tausenderpunkt, n/a), bleibt Text	92, 4,5 → 4.5
boolean	true für true, yes, 1, ja; false für false, no, 0, nein (Groß- und Kleinschreibung egal); alles andere bleibt Text	ja → true
array	JSON ([{"qty": 2}]) oder Werte, getrennt durch ; oder |, die zu einer Liste von Strings werden	rot; grün → ["rot", "grün"]
object	JSON ({"city": "Musterstadt"}); alles andere bleibt Text

Eine leere Zelle in einem Feld, das kein String ist, wird zu null. Eine Konstante wird genauso umgewandelt. Felder in den Einträgen eines Arrays (items[].qty) werden nicht einzeln angeboten; ordnen Sie das ganze Array einer Spalte mit JSON zu.

Datumsangaben werden nicht umgewandelt: Eine Datumszelle kommt als der Text an, den die Tabelle in ihrem Zellformat zeigt. Formatieren Sie Datumsspalten als Text in der Form, die Ihre Vorlage erwartet, zum Beispiel 2026-10-01, die die Datums-Helfer lesen.

Grenzen

	Grenze
Zeilen pro Batch	1.000. Darüber bleibt die Schaltfläche zum Einreihen gesperrt; teilen Sie die Tabelle oder senden Sie mehrere Batches aus Code.
Vorlagen in der Liste	Die ersten 100 veröffentlichten Vorlagen des Workspace, nach Name
Einheiten	Free-Plan: Der Batch wird abgelehnt, wenn im Zeitraum nicht mindestens eine Einheit pro Zeile übrig ist. Bezahlte Pläne rendern Zeilen über die enthaltenen Einheiten hinaus als Mehrverbrauch, bis zur harten Obergrenze.
Word- und PowerPoint-Vorlagen	Live-Renderings brauchen Starter oder höher

Reichen die Einheiten nicht, meldet der Dialog „Nicht genug Einheiten für diesen Batch“ und reiht nichts ein; kaufen Sie ein Paket oder wechseln Sie den Plan unter Abrechnung.

Den Batch verfolgen und das Zip herunterladen

Der Bereich Batches auf der Seite Renderings listet die letzten 20 Batches des Workspace, auch die über die API gesendeten, mit ihrem Fortschritt (2 von 3 fertig) und Status: wartet, rendert, abgeschlossen, teilweise fehlgeschlagen oder fehlgeschlagen. Wählen Sie einen Batch aus, um im Render-Protokoll darunter nur seine Dokumente zu sehen; jedes Dokument ist dort ein eigenes Rendering mit seiner Ausgabe und, wenn es fehlschlug, seinem Fehler.

Ist das letzte Dokument fertig und war Als Zip bündeln an, erscheint Zip herunterladen. Das Zip enthält jedes erfolgreiche Dokument, nach seiner Zeile nummeriert, damit die Namen eindeutig bleiben: 0001-max-mustermann.pdf, 0002-erika-mustermann.pdf. Eine fehlgeschlagene Zeile ist nicht im Zip, und ihre Nummer fehlt; korrigieren Sie Daten oder Vorlage und senden Sie diese Zeilen erneut.

Aus Code

Der Dialog ruft POST /v1/renders/batch mit einem Eintrag pro Zeile auf, { "data": {…}, "filename": "max-mustermann.pdf" }, dazu zip, die gewählte output und meta mit "source": "spreadsheet", dem Dateinamen und dem Tabellenblatt. Um dasselbe aus einem Skript zu tun, lesen Sie die Datei selbst ein und senden die Zeilen als items; die SDKs bieten dafür renders.batch(). Das Anfrageformat und den Weg für mehr als 1.000 Zeilen beschreibt Asynchron und Batch.