Fügen Sie Zeilen zu einem hinzu Excel Arbeitsblatt in n8n

Zeilen hinzufügen ist ein PDF4me Knotenaktion in n8n der schreibt JSON Aufzeichnungen in einem Excel Arbeitsblatt. Verwenden Sie es, um zu drücken API Ergebnisse in einen Bericht einfügen, Webhook-Nutzdaten in einer freigegebenen Arbeitsmappe protokollieren oder anhängen CRM Exporte in eine Tracking-Tabelle, wobei Zahlen und Daten als reale Daten erfasst werden. Excel Werte statt Text.

Was dieser Knoten bewirkt

PDF4me ExcelZeilen hinzufügen nimmt eine bestehende .xlsx Arbeitsbuch plus ein JSON Array in JSON Zeilendatenund schreibt eine Zeile pro Objekt. Es hat zwei Platzierungsmodi: Benennen Sie eine Tabelle in Ziel Excel Tisch und die Schlüssel werden den Überschriften zugeordnet, oder lassen Sie es leer und Aus Zeile einfügen plus Aus Spalte einfügen Legen Sie die genaue Startzelle fest. Es bearbeitet eine von Ihnen bereitgestellte Arbeitsmappe, anstatt eine neue von Grund auf zu erstellen.

Verwandte Blog-Beiträge

Zu dieser Funktion gibt es noch keinen Blogbeitrag – folgt in Kürze.

Schauen Sie sich in der Zwischenzeit im PDF4me-Blog Tutorials und Arbeitsabläufe für alle Plattformen an.

Besuchen Sie den Blog →

Authentifizierung Ihres API Anfrage

Jeder PDF4me Knoten in n8n erfordert eine gültige Anmeldeinformationen zum Verbinden mitErstellen oder wählen Sie einen Eintrag aus, der Ihre Daten enthält. PDF4me API Schlüssel, damit der Workflow Tabellenkalkulationsanfragen sicher authentifizieren kann.

Get your API Key

Wichtige Fakten, die Sie nicht verpassen sollten

Ziel Excel Die Tabelle bestimmt den Modus

Wenn Sie dieses Feld ausfüllen, wird der Knoten auf Header-Matching umgestellt. Wenn Sie es leer lassen, erfolgt die Platzierung anhand der Koordinaten. Alles Weitere, wie die Zeilen angeordnet werden, ergibt sich aus diesem einen Feld.

Der JSON muss flach sein

Jedes Objekt wird zu einer Zeile und jeder Schlüssel zu einer Spalte. Ein verschachteltes Objekt oder Array hat keine einzelne Zelle, die belegt werden kann; daher muss die Nutzlast vereinfacht werden, bevor sie diesen Knoten erreicht.

Der Koordinatenmodus kann überschreiben

Die Optionen „Einfügen ab Zeile“ und „Einfügen ab Spalte“ sind standardmäßig auf 1 eingestellt, also die Zelle oben links. Wählen Sie einen leeren Bereich aus, es sei denn, Sie möchten den vorhandenen Inhalt ersetzen.

JSON Die Zeilendaten enthalten eine JSON Array flacher Objekte. Ziel Excel Die Tabelle ist hier leer, daher platzieren die Funktionen Einfügen aus Zeile und Einfügen aus Spalte die Daten in Zelle A1.

Tabellenmodus vs. Koordinatenmodus

Frage	Tabellenmodus	Koordinatenmodus
How you switch to it	Name a table in Target Excel Table	Leave Target Excel Table blank
How columns are matched	JSON keys matched against table headers	Values written in key order from the start cell
Does column order matter	No, headers drive placement	Yes, position drives placement
Which fields control it	Target Excel Table and Excel Row Number	Insert From Row and Insert From Column
Best for	Structured sheets that already have a table	Blank sheets or a fixed reporting layout
Overwrite risk	Lower, rows follow the table structure	Higher, the start cell is written to directly

Welche Parameter benötigt die Funktion „Zeilen hinzufügen“?

Parameter	Erforderlich	Was es tut	Beispiel
Credential to connect with	Required	The PDF4me API credential the node authenticates with.	PDF4me API
Operation	Required	The action this node performs. Select Add Rows.	Add Rows
Excel File Input Method	Required	How the workbook reaches the node: from the previous node as binary data, as a Base64 string, or from a URL.	From Previous Node (Binary Data)
Binary Data Property Name	Conditional	Name of the binary property holding the .xlsx. Appears when the workbook comes from the previous node.	data
Worksheet Name	Required	Sheet the rows are written to. Match the sheet tab name exactly.	Sheet1
JSON Row Data	Required	JSON array of flat objects. Each object becomes one row and each key maps to a column.	[{"Date":"2024-01-15","Amount":1500.00}]
Insert From Row	Conditional	Row number the data starts at, counting from 1. Used in coordinate mode when no table is named.	1
Insert From Column	Conditional	Column number the data starts at, counting from 1 for column A. Used in coordinate mode.	1
Target Excel Table	Optional	Name of an existing table to write into. Filling this in switches the node to header matching instead of coordinates.	Table1
Excel Row Number	Conditional	Row index inside the named table where insertion begins. Used in table mode.	1
Convert Numeric and Date Values	Optional	Toggle that turns numeric and date strings into real Excel values rather than text. Ships enabled.	enabled
Date Format Pattern	Optional	Pattern applied to converted dates. Match it to the shape of the dates in your JSON.	yyyy-MM-dd
Numeric Format Pattern	Optional	Format applied to converted numbers, such as two decimal places.	N2
Skip JSON Property Names	Optional	Toggle that omits the JSON keys, writing only values. Ships disabled so headers are included.	disabled
Skip Null Values	Optional	Toggle that leaves cells untouched where a JSON value is null instead of clearing them. Ships disabled.	disabled
Culture and Language Settings	Optional	Culture code used when parsing numbers and dates, which decides separator handling.	en-US
Output File Name	Optional	Filename of the returned workbook. Keep a valid Excel extension.	excel_with_rows.xlsx

Ausgabe

Feld	Typ	Was es enthält
fileName	String	Name of the returned workbook after the rows were written.
fileSize	Number	Size of the returned workbook in bytes.
success	Boolean	Whether the insertion completed. Branch on this so failures surface as alerts.
originalFileName	String	Name of the input workbook as supplied to the node.
worksheetName	String	The worksheet the rows were written to.
rowsAdded	Number	How many rows were inserted. The most useful verification signal the node returns.
insertFromRow	Number	Starting row used, echoed back when running in coordinate mode.
insertFromColumn	Number	Starting column used, echoed back when running in coordinate mode.
tableName	String	The table written into, or null when coordinate mode was used.
excelRowNumber	Number	Row index inside the table where insertion began, in table mode.
convertNumericAndDate	Boolean	Whether numeric and date conversion was applied.
dateFormat	String	The date pattern applied during conversion.
numericFormat	String	The numeric format applied during conversion.
cultureName	String	The culture code used to parse numbers and dates.
message	String	Human-readable summary, including the row count and worksheet name.

Die aktualisierte Arbeitsmappe selbst wird als Binärdaten zurückgegeben und kann direkt gespeichert, an eine E-Mail angehängt oder an ein anderes System weitergegeben werden. Excel Schritt.

Wie richte ich das Hinzufügen von Zeilen ein? n8n?

1. Füge die PDF4me Excel Fügen Sie den Knoten zu Ihrem Workflow hinzu und legen Sie fest Betrieb Zu Zeilen hinzufügenDie
2. Wählen Sie Ihre PDF4me Anmeldeinformationen, oder erstellen Sie welche und fügen Sie Ihre ein. API Schlüssel.
3. Wähle einen Excel Dateieingabemethode und laden Sie die Arbeitsmappe über das darunter stehende Feld hoch.
4. Satz Name des Arbeitsblatts auf das genaue Tabellenblatt, in das Sie schreiben.
5. Setze ein JSON Array flacher Objekte in JSON Zeilendaten, ein Objekt pro Zeile.
6. Um den Tabellenmodus zu verwenden, geben Sie den Tabellennamen ein in Ziel Excel Tisch und setzen Excel Reihe NumberUm Koordinaten zu verwenden, lassen Sie die Tabelle leer und stellen Sie Folgendes ein: Aus Zeile einfügen Und Aus Spalte einfügenDie
7. Verlassen Numerische und Datumswerte konvertieren aktiviert, dann einstellen Datumsformatmuster, Numerisches Formatmuster, Und Kultur- und Sprachumgebung um Ihre Daten abzugleichen.
8. Satz Name der AusgabedateiFühre den Knoten aus und überprüfe rowsAdded in der Antwort, bevor die Arbeitsmappe weitergeleitet wird.

Typische Konfigurationen

Workflow-BeispieleCommon n8n workflow patterns using Add Rows.

Webhook-Nutzdaten in einer Arbeitsmappe protokollieren

1. Ein Webhook empfängt eine Formularübermittlung als JSONDie
2. Mit Add Rows werden die Zeilen einer benannten Tabelle in einer freigegebenen Arbeitsmappe hinzugefügt.
3. Das Team liest die Liste, ohne dass jemand die Daten erneut eingibt.

Drücken API Ergebnisse in einem Bericht

1. Ein geplanter HTTP Die Anfrage ruft Datensätze aus einem internen System ab. APIDie
2. Ein Code-Knoten wandelt die Antwort in ein einfaches Array um.
3. Mit Add Rows wird der Wert an festen Koordinaten in die Berichtsvorlage eingefügt.

Füge eine nächtliche Datei hinzu CRM Export

1. Ein Nachtjob eröffnet neue Möglichkeiten. JSONDie
2. Im Tabellenmodus werden die Schlüssel den vorhandenen Spaltenüberschriften zugeordnet.
3. Änderungen der Spaltenreihenfolge in der Quelle führen nicht zu Problemen mit dem Tabellenblatt.

Überprüfen Sie den Schreibvorgang vor der Verteilung.

1. Die Funktion "Zeilen hinzufügen" gibt die hinzugefügten Zeilen zusammen mit der Arbeitsmappe zurück.
2. Ein IF-Knoten vergleicht es mit der Länge des Eingabe-Arrays.
3. Bei einer Diskrepanz wird eine Warnung ausgelöst, anstatt einen Kurzbericht zu versenden.

Praktische Tipps

Flatten the JSON first

A Set or Code node that removes nesting is cheaper than debugging why a column arrived empty or full of object text.

Prefer table mode when a table exists

Header matching survives column reordering in the source system, which fixed coordinates cannot.

Check rowsAdded, not just success

A run can succeed while inserting fewer rows than you sent. Comparing the count to your array length catches silent shortfalls.

Match culture to the data, not the reader

Culture drives how decimal and thousands separators are parsed. Set it to the format the JSON arrives in.

Point coordinates at empty cells

Insert From Row and Insert From Column both default to 1, so an unchanged run writes over the top-left of the sheet.

Keep a template workbook

This action edits an existing file. Storing a clean template that the workflow copies each run avoids gradual drift.

Spickzettel

Feld	Wert
Operation	Add Rows
Excel File Input Method	From Previous Node (Binary Data)
Binary Data Property Name	data
Worksheet Name	Sheet1
JSON Row Data	[{"Date":"2024-01-15","Amount":1500.00}]
Insert From Row / Column	1 / 1
Target Excel Table	Table1
Excel Row Number	1
Convert Numeric and Date Values	enabled
Date Format Pattern	yyyy-MM-dd
Numeric Format Pattern	N2
Culture and Language Settings	en-US
Output File Name	excel_with_rows.xlsx

Häufig gestellte Fragen

What JSON format does Add Rows expect?+

A JSON array of flat objects, where each object is one row and each key is a column. Nested objects and arrays have no natural cell to land in, so flatten the structure first, for example with an n8n Code node. The array shape itself follows the ordinary JSON data model.

What is the difference between table mode and coordinate mode?+

Naming a table in Target Excel Table puts the node in table mode, where JSON keys are matched against the table headers so column order in your data does not matter. Leaving it blank uses coordinate mode, where Insert From Row and Insert From Column decide the exact starting cell and values are written in key order.

Why did my numbers and dates arrive as text?+

That happens when Convert Numeric and Date Values is turned off, or when the culture does not match the incoming data. The toggle ships enabled, and Date Format Pattern, Numeric Format Pattern, and Culture and Language Settings control how the strings are parsed and formatted on the way in.

Does Add Rows overwrite existing data?+

In coordinate mode the node writes starting at the row and column you name, so pointing it at occupied cells replaces what is there. Target an empty region, or use table mode so rows follow the table structure rather than a fixed address.

Can I add rows to several sheets in one run?+

Not in a single execution, because Worksheet Name takes one sheet. Chain a second Add Rows node fed by the first node output, or loop the workbook through the node once per sheet, so each pass writes to its own worksheet.

Verwandte Aktionen

Zeilen aktualisieren

Ändern Sie die Werte in bereits vorhandenen Zeilen, anstatt neue zu schreiben.

Zeilen extrahieren

Die Zeilen eines Arbeitsblatts werden als Daten für den restlichen Arbeitsablauf wieder ausgelesen.

Zeilen löschen

Löschen Sie veraltete Datensätze vor einem neuen Import, damit sich die Tabelle nicht mit Datensätzen füllt.

Parse CSV

Drehen Sie einen CSV in strukturierte Daten, die Sie dann in Add Rows eingeben können.

Dieselbe Aufgabe auf anderen Plattformen

Zeilen hinzufügen in Make

Die gleiche Zeileneinfüge-Engine wie eine Make Modul innerhalb Make Szenarien.

Zeilen hinzufügen in Zapier

Schreiben Sie Tabellenzeilen aus Tausenden von SaaS-Anwendungen und Webhooks.

Zeilen hinzufügen in Power Automate

Microsoft 365 fließt mit SharePoint, Outlookund Teams-Integrationen.

Zeilen hinzufügen REST API

Das Rohmaterial PDF4me Endpunkt für benutzerdefinierten Backend-Code oder Postman-Tests.

Hilfe erhalten

n8n Integration Guiden8n SampleGetting Started