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.
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

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
| Question | Mode tableau | Mode coordonnées |
|---|---|---|
| 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 |
De quels paramètres la fonction Ajouter des lignes a-t-elle besoin ?
| Paramètre | Requis | Ce que cela fait | Exemple |
|---|---|---|---|
| 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 |
Sortir
| Champ | Taper | Ce qu'il contient |
|---|---|---|
| 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. |
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?
- Ajoutez le PDF4me Excel Ajoutez un nœud à votre flux de travail et définissez Opération à Ajouter des lignes.
- Sélectionnez votre PDF4me Veuillez utiliser vos identifiants ou en créer un et y coller votre code d'identification. API clé.
- Choisissez un Excel Méthode d'entrée de fichier et fournissez le classeur via le champ qui apparaît en dessous.
- Ensemble Nom de la feuille de travail à l'onglet exact de la feuille sur lequel vous écrivez.
- Mettez un JSON tableau d'objets plats dans JSON Données de ligne, un objet par ligne.
- 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.
- 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.
- Ensemble Nom du fichier de sortie, exécutez le nœud et vérifiez
rowsAddeddans la réponse avant de faire transiter le classeur.
Configurations typiques
Exemples de flux de travailCommon n8n workflow patterns using Add Rows.
- Un webhook reçoit une soumission de formulaire sous forme de JSON.
- L'option « Ajouter des lignes » ajoute les lignes à un tableau nommé dans un classeur partagé.
- L'équipe lit la feuille sans que personne ne ressaisisse les données.
- Un programme HTTP La requête extrait des enregistrements d'une base de données interne. API.
- Un nœud Code transforme la réponse en un tableau simple.
- L'option « Ajouter des lignes » inscrit les données dans le modèle de rapport à des coordonnées fixes.
- Un emploi de nuit offre de nouvelles opportunités. JSON.
- Le mode tableau fait correspondre les clés aux en-têtes existants.
- Les modifications de l'ordre des colonnes dans la source ne perturbent pas la feuille de calcul.
- La fonction Ajouter des lignes renvoie les lignes ajoutées dans le classeur.
- Un nœud IF compare cette valeur à la longueur du tableau d'entrée.
- Une incohérence déclenche une alerte au lieu de l'envoi d'un bref rapport.
Conseils pratiques
Aide-mémoire
| Champ | Valeur |
|---|---|
| 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 |