Aller au contenu principal

Ajouter des lignes à un Excel Feuille de travail dans n8n

Ajouter des lignes est un PDF4me action de nœud dans n8n qui écrit JSON enregistrements dans un Excel feuille de calcul. Utilisez-la pour pousser API Intégrer les résultats dans un rapport, consigner les charges utiles des webhooks dans un classeur partagé ou ajouter CRM exportations vers une feuille de suivi, avec les numéros et les dates d'arrivée comme réel Excel Des valeurs plutôt que du texte.

Que fait ce nœud ?

PDF4me Excel: Ajouter des lignes prend un existant .xlsx cahier d'exercices plus un JSON tableau dans JSON Données de ligneet écrit une ligne par objet. Il possède deux modes de placement: nommer une table dans Cible Excel Tableau et les clés sont associées aux en-têtes, ou laissez le champ vide et Insérer à partir de la ligne plus Insérer à partir de la colonne Définissez la cellule de départ exacte. Cette fonction modifie un classeur que vous fournissez au lieu d'en créer un de toutes pièces.

Articles de blog connexes
Il n'y a pas encore d'article de blog consacré à cette fonctionnalité — à venir prochainement.
En attendant, n'hésitez pas à consulter le blog de PDF4me pour découvrir des tutoriels et des procédures de travail adaptés à toutes les plateformes.
Consultez le blog

Authentification de votre API Demande

Chaque PDF4me nœud dans n8n nécessite un numéro valide Identifiant pour se connecter avecCréez ou sélectionnez-en un qui contient votre PDF4me API clé permettant au flux de travail d'authentifier en toute sécurité les requêtes de feuilles de calcul.

Informations importantes à ne pas manquer

Cible Excel Le tableau détermine le mode
Renseigner ce champ active le placement par en-tête. Le laisser vide active le placement par coordonnées. Tout le reste, concernant l'agencement des lignes, dépend de ce seul champ.
Le JSON doit être plat
Chaque objet devient une ligne et chaque clé une colonne. Un objet imbriqué ou un tableau n'occupe aucune cellule unique ; il faut donc aplatir les données avant qu'elles n'atteignent ce nœud.
Le mode coordonnées peut écraser
Les options « Insérer à partir de la ligne » et « Insérer à partir de la colonne » sont par défaut configurées sur la cellule 1, c’est-à-dire la cellule en haut à gauche. Indiquez-leur une zone vide, sauf si vous souhaitez remplacer un contenu existant.
Le nœud PDF4me Excel dans n8n avec l'opération définie sur Ajouter des lignes, la méthode d'entrée de fichier Excel définie sur À partir du nœud précédent, un tableau JSON dans Données de ligne JSON, Insérer à partir de la ligne et Insérer à partir de la colonne définis sur 1, et Convertir les valeurs numériques et de date activé

JSON Les données de la ligne contiennent un JSON Tableau d'objets plats. Cible Excel Le tableau est vide à cet endroit, donc les fonctions Insérer à partir de la ligne et Insérer à partir de la colonne placent les données dans la cellule A1.

Mode tableau vs mode coordonnées

QuestionMode tableauMode coordonnées
How you switch to itName a table in Target Excel TableLeave Target Excel Table blank
How columns are matchedJSON keys matched against table headersValues written in key order from the start cell
Does column order matterNo, headers drive placementYes, position drives placement
Which fields control itTarget Excel Table and Excel Row NumberInsert From Row and Insert From Column
Best forStructured sheets that already have a tableBlank sheets or a fixed reporting layout
Overwrite riskLower, rows follow the table structureHigher, the start cell is written to directly

De quels paramètres la fonction Ajouter des lignes a-t-elle besoin ?

ParamètreRequisCe que cela faitExemple
Credential to connect withRequiredThe PDF4me API credential the node authenticates with.PDF4me API
OperationRequiredThe action this node performs. Select Add Rows.Add Rows
Excel File Input MethodRequiredHow 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 NameConditionalName of the binary property holding the .xlsx. Appears when the workbook comes from the previous node.data
Worksheet NameRequiredSheet the rows are written to. Match the sheet tab name exactly.Sheet1
JSON Row DataRequiredJSON 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 RowConditionalRow number the data starts at, counting from 1. Used in coordinate mode when no table is named.1
Insert From ColumnConditionalColumn number the data starts at, counting from 1 for column A. Used in coordinate mode.1
Target Excel TableOptionalName of an existing table to write into. Filling this in switches the node to header matching instead of coordinates.Table1
Excel Row NumberConditionalRow index inside the named table where insertion begins. Used in table mode.1
Convert Numeric and Date ValuesOptionalToggle that turns numeric and date strings into real Excel values rather than text. Ships enabled.enabled
Date Format PatternOptionalPattern applied to converted dates. Match it to the shape of the dates in your JSON.yyyy-MM-dd
Numeric Format PatternOptionalFormat applied to converted numbers, such as two decimal places.N2
Skip JSON Property NamesOptionalToggle that omits the JSON keys, writing only values. Ships disabled so headers are included.disabled
Skip Null ValuesOptionalToggle that leaves cells untouched where a JSON value is null instead of clearing them. Ships disabled.disabled
Culture and Language SettingsOptionalCulture code used when parsing numbers and dates, which decides separator handling.en-US
Output File NameOptionalFilename of the returned workbook. Keep a valid Excel extension.excel_with_rows.xlsx

Sortir

ChampTaperCe qu'il contient
fileNameStringName of the returned workbook after the rows were written.
fileSizeNumberSize of the returned workbook in bytes.
successBooleanWhether the insertion completed. Branch on this so failures surface as alerts.
originalFileNameStringName of the input workbook as supplied to the node.
worksheetNameStringThe worksheet the rows were written to.
rowsAddedNumberHow many rows were inserted. The most useful verification signal the node returns.
insertFromRowNumberStarting row used, echoed back when running in coordinate mode.
insertFromColumnNumberStarting column used, echoed back when running in coordinate mode.
tableNameStringThe table written into, or null when coordinate mode was used.
excelRowNumberNumberRow index inside the table where insertion began, in table mode.
convertNumericAndDateBooleanWhether numeric and date conversion was applied.
dateFormatStringThe date pattern applied during conversion.
numericFormatStringThe numeric format applied during conversion.
cultureNameStringThe culture code used to parse numbers and dates.
messageStringHuman-readable summary, including the row count and worksheet name.

Le classeur mis à jour est renvoyé sous forme de données binaires, prêtes à être enregistrées, jointes à un courriel ou transmises à un autre processus. Excel étape.

Comment configurer l'ajout de lignes dans n8n?

  1. Ajoutez le PDF4me Excel Ajoutez un nœud à votre flux de travail et définissez Opération à Ajouter des lignes.
  2. Sélectionnez votre PDF4me Veuillez utiliser vos identifiants ou en créer un et y coller votre code d'identification. API clé.
  3. Choisissez un Excel Méthode d'entrée de fichier et fournissez le classeur via le champ qui apparaît en dessous.
  4. Ensemble Nom de la feuille de travail à l'onglet exact de la feuille sur lequel vous écrivez.
  5. Mettez un JSON tableau d'objets plats dans JSON Données de ligne, un objet par ligne.
  6. Pour utiliser le mode tableau, saisissez le nom du tableau dans Cible Excel Tableau et ensemble Excel Rangée NumberPour utiliser des coordonnées, laissez le tableau vide et définissez Insérer à partir de la ligne et Insérer à partir de la colonne.
  7. Partir Convertir des valeurs numériques et des dates activé, puis définir Modèle de format de date, Modèle de format numérique, et Paramètres culturels et linguistiques pour correspondre à vos données.
  8. Ensemble Nom du fichier de sortie, exécutez le nœud et vérifiez rowsAdded dans la réponse avant de faire transiter le classeur.

Configurations typiques

Exemples de flux de travailCommon n8n workflow patterns using Add Rows.
Consignez les charges utiles des webhooks dans un classeur.
  1. Un webhook reçoit une soumission de formulaire sous forme de JSON.
  2. L'option « Ajouter des lignes » ajoute les lignes à un tableau nommé dans un classeur partagé.
  3. L'équipe lit la feuille sans que personne ne ressaisisse les données.
Pousser API résultats dans un rapport
  1. Un programme HTTP La requête extrait des enregistrements d'une base de données interne. API.
  2. Un nœud Code transforme la réponse en un tableau simple.
  3. L'option « Ajouter des lignes » inscrit les données dans le modèle de rapport à des coordonnées fixes.
Ajouter une mise à jour nocturne CRM exporter
  1. Un emploi de nuit offre de nouvelles opportunités. JSON.
  2. Le mode tableau fait correspondre les clés aux en-têtes existants.
  3. Les modifications de l'ordre des colonnes dans la source ne perturbent pas la feuille de calcul.
Vérifiez l'écriture avant de la distribuer.
  1. La fonction Ajouter des lignes renvoie les lignes ajoutées dans le classeur.
  2. Un nœud IF compare cette valeur à la longueur du tableau d'entrée.
  3. Une incohérence déclenche une alerte au lieu de l'envoi d'un bref rapport.

Conseils pratiques

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.

Aide-mémoire

ChampValeur
OperationAdd Rows
Excel File Input MethodFrom Previous Node (Binary Data)
Binary Data Property Namedata
Worksheet NameSheet1
JSON Row Data[{"Date":"2024-01-15","Amount":1500.00}]
Insert From Row / Column1 / 1
Target Excel TableTable1
Excel Row Number1
Convert Numeric and Date Valuesenabled
Date Format Patternyyyy-MM-dd
Numeric Format PatternN2
Culture and Language Settingsen-US
Output File Nameexcel_with_rows.xlsx

Questions fréquentes

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.

Actions connexes

Même tâche sur d'autres plateformes

Obtenez de l'aide