Extraire des lignes d'une feuille de calcul Excel à l'aide de n8n action
PDF4me Extraire les lignes convertit n'importe quelle tranche de feuille de calcul en élément prêt à l'emploi JSON dans n8nSpécifiez les plages de lignes/colonnes à partir de 0, décidez si la première ligne doit servir d'en-tête, ignorez les lignes masquées ou vides et choisissez si les valeurs doivent conserver leur type (nombres, booléens, etc.). ISO (dates) ou converties en texte. Idéal pour transférer des données Excel vers APIs, bases de données ou autres PDF4me actions.
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 →
Installation
Ajoutez le PDF4me Nœud « Extraire les lignes » à votre n8n Suivez le flux de travail et configurez les paramètres requis. Pour les instructions de configuration initiale, consultez notre documentation. n8n Guide d'intégration.
Prérequis
- PDF4me API informations d'identification
- n8n accès au flux de travail
Configuration
- Ajoutez le PDF4me nœud du flux de travail
- Sélectionnez l'action « Extraire les lignes de la feuille de calcul Excel ».
- Indiquez la source Excel et la fenêtre d'extraction
Paramètres
Important: Les paramètres marqués d'un astérisque (***) sont obligatoires. Les indices de ligne/colonne sont Base 0 (Ligne 0 = ligne 1 d'Excel).
| Paramètre | Taper | Description | Exemple |
|---|---|---|---|
| Type de données d'entrée*** | String | Sélecteur de source Excel (Binary Data, Base64 String, URL). | Binary Data |
| Champ binaire d'entrée*** | Binaire | Requis lorsque Binary Data est sélectionné. | {{ $binary.data }} |
| Contenu du document Base64*** | String | Requis lorsque Base64 String est sélectionné. | UEsDBBQAAAA... |
| URL du document*** | String | Requis lorsque URL est sélectionné. Lien vers le fichier public. | https://files.example.com/report.xlsx |
| Nom de fichier*** | String | Nom logique du classeur avec extension. | analytics.xlsx |
| Nom de la feuille de travail | String | Feuille de travail à lire. Vide = première feuille. | Summary |
| Première rangée*** | Nombre | Ligne de départ à partir de 0 pour l'extraction. | 0 |
| Dernière rangée | Nombre | Ligne de fin indexée à 0. Utiliser -1 lire jusqu'à la dernière ligne de données. | -1 |
| Première colonne | Nombre | Colonne de départ basée sur 0 (0 = colonne A). | 0 |
| Dernière colonne | Nombre | Colonne de fin indexée à 0. Utiliser -1 pour la dernière colonne de données. | -1 |
| Comporte une ligne d'en-tête | Boolean | true utilise First Row en tant qu'en-têtes de colonnes et les exclut des données. | true |
| Exclure les lignes masquées | Boolean | Ignorer les lignes masquées dans Excel. | false |
| Exclure les colonnes masquées | Boolean | Ignorer les colonnes masquées. | false |
| Exclure les lignes vides | Boolean | Supprimez les lignes où toutes les cellules sont vides. | true |
| Exporter les cellules vides | Boolean | Incluez les cellules vides avec des valeurs de type chaîne vide au lieu de les omettre. | false |
| Exporter les valeurs sous forme de texte | Boolean | Forcer toutes les valeurs à être converties en chaînes de caractères. false préserve les espèces indigènes. | false |
| Nom de la sortie de données binaires*** | String | Emplacement binaire stockant des données sérialisées JSON (PDF4me retours JSON octets). | document |
Sortir
Paramètres de sortie
| Paramètre | Taper | Description | Exemple |
|---|---|---|---|
| succès | Boolean | PDF4me état de fonctionnement - Boolean Drapeau indiquant le succès ou l'échec du processus d'extraction de lignes. PDF4me retours true pour des opérations réussies et false pour toute erreur | true |
| Nom de fichier original | String | Nom du fichier Excel d'origine - Le nom du fichier Excel d'entrée | myExcelFile.xlsx |
| Nom de la feuille de travail | String | Nom de la feuille de travail - Le nom de la feuille de calcul à partir de laquelle les lignes ont été extraites | First Worksheet |
| aHeaderRow | Boolean | État de la ligne d'en-tête - Indique si la première ligne a été traitée comme des en-têtes. true si des en-têtes étaient utilisés, false sinon | true |
| première ligne | Nombre | Index de la première ligne (à partir de 0) - L'index à partir de 0 de la première ligne extraite | 0 |
| dernière ligne | Nombre | Index de la dernière ligne (à partir de 0) - L'index à partir de 0 de la dernière ligne extraite. -1 indique l'extraction jusqu'à la dernière ligne de données | 2 |
| première colonne | Nombre | Index de la première colonne (à partir de 0) - L'index à partir de 0 de la première colonne extraite (0 = colonne A) | 0 |
| dernière colonne | Nombre | Indice de la dernière colonne (à partir de 0) - L'index à partir de 0 de la dernière colonne extraite. -1 indique l'extraction jusqu'à la dernière colonne de données | -1 |
| exclure les lignes vides | Boolean | Exclusion des lignes vides - Indique si les lignes vides ont été exclues. true si exclu, false si inclus | true |
| exclure les lignes cachées | Boolean | Exclusion de la ligne masquée - Indique si les lignes masquées ont été exclues. true si exclu, false si inclus | true |
| exclure les colonnes cachées | Boolean | Exclusion de colonne masquée - Indique si des colonnes masquées ont été exclues. true si exclu, false si inclus | true |
| exporterValuesAsTexte | Boolean | Mode d'exportation de texte - Indique si les valeurs ont été exportées sous forme de texte. true si on les force à obéir, false si les types indigènes sont préservés | false |
| exporterCellulesVide | Boolean | Exporter les cellules vides - Indique si des cellules vides ont été exportées. true si inclus avec des chaînes vides, false si omis | false |
| exportAsObject | Boolean | Mode d'exportation d'objets - Indique si les données ont été exportées au format objet | false |
| Format du lien hypertexte | String | Format de lien hypertexte - Format utilisé pour les hyperliens dans les données extraites. Valeurs : « Texte », « Url », etc. | Text |
| culture | String | Code culturel/local - Code de culture utilisé pour l'extraction des données (par exemple, « en-US », « de-DE », « fr-FR ») | en-US |
| lignes extraites | Nombre | Nombre de lignes extraites - Nombre total de lignes extraites avec succès | 1 |
| données extraites | Object | Objet de données extrait - Objet imbriqué contenant les données de ligne extraites avec le tableau rowData | {"rowData": [{"Column1": 1, "First Name": "Dulce"}]} |
| message | String | Message d'opération - Message descriptif indiquant le résultat de l'opération d'extraction de lignes, y compris le nombre de lignes extraites et le nom de la feuille de calcul | Successfully extracted 1 row(s) from worksheet 'First Worksheet' |
N8N Réponse à l'action
Le PDF4me Extraire des lignes d'une feuille de calcul Excel API renvoie une réponse pouvant être affichée dans plusieurs formats. Choisissez l'affichage qui correspond le mieux à vos besoins :
- JSON
- Table
- Schema
- Binary
JSON Format de réponse
Le cru JSON réponse de la API:
[
{
"success": true,
"originalFileName": "myExcelFile.xlsx",
"worksheetName": "First Worksheet",
"hasHeaderRow": true,
"firstRow": 0,
"lastRow": 2,
"firstColumn": 0,
"lastColumn": -1,
"excludeEmptyRows": true,
"excludeHiddenRows": true,
"excludeHiddenColumns": true,
"exportValuesAsText": false,
"exportEmptyCells": false,
"exportAsObject": false,
"hyperlinkFormat": "Text",
"culture": "en-US",
"rowsExtracted": 1,
"extractedData": {
"document": null,
"fileName": null,
"success": true,
"errorMessage": null,
"rowData": [
{
"Column1": 1,
"First Name": "Dulce",
"Last Name": "Abril",
"Gender": "Female",
"Country": "United States",
"Age": 32,
"Date": "15/10/2017",
"Id": 1562
},
{
"Column1": 2,
"First Name": "Mara",
"Last Name": "Hashimoto",
"Gender": "Female",
"Country": "Great Britain",
"Age": 25,
"Date": "16/08/2016",
"Id": 1582
}
]
},
"message": "Successfully extracted 1 row(s) from worksheet 'First Worksheet'"
}
]
Vue tableau
Données de réponse présentées sous forme de tableau structuré :
| Paramètre | Valeur |
|---|---|
| succès | true |
| Nom de fichier original | myExcelFile.xlsx |
| Nom de la feuille de travail | First Worksheet |
| aHeaderRow | true |
| première ligne | 0 |
| dernière ligne | 2 |
| première colonne | 0 |
| dernière colonne | -1 |
| exclure les lignes vides | true |
| exclure les lignes cachées | true |
| exclure les colonnes cachées | true |
| exporterValuesAsTexte | false |
| exporterCellulesVide | false |
| exportAsObject | false |
| Format du lien hypertexte | Text |
| culture | en-US |
| lignes extraites | 1 |
| données extraites | Objet contenant le tableau rowData |
| message | Successfully extracted 1 row(s) from worksheet 'First Worksheet' |
Objet de données extraites :
| Paramètre | Valeur |
|---|---|
| document | null |
| nom de fichier | null |
| succès | true |
| message d'erreur | null |
| données de ligne | Tableau d'objets de lignes extraites |
Remarque : rowData contient les objets de ligne extraits sous forme de tableau, les en-têtes de colonnes servant de clés.
Vue schématique
Structure des données et types de réponses :
1 item
success: ☑ true
originalFileName: T myExcelFile.xlsx
worksheetName: T First Worksheet
hasHeaderRow: ☑ true
firstRow: # 0
lastRow: # 2
firstColumn: # 0
lastColumn: # -1
excludeEmptyRows: ☑ true
excludeHiddenRows: ☑ true
excludeHiddenColumns: ☑ true
exportValuesAsText: ☑ false
exportEmptyCells: ☑ false
exportAsObject: ☑ false
hyperlinkFormat: T Text
culture: T en-US
rowsExtracted: # 1
extractedData: {} Object
document: null
fileName: null
success: ☑ true
errorMessage: null
rowData: [] Array
[0]: {} Object
Column1: # 1
First Name: T Dulce
Last Name: T Abril
Gender: T Female
Country: T United States
Age: # 32
Date: T 15/10/2017
Id: # 1562
[1]: {} Object
Column1: # 2
First Name: T Mara
Last Name: T Hashimoto
Gender: T Female
Country: T Great Britain
Age: # 25
Date: T 16/08/2016
Id: # 1582
message: T Successfully extracted 1 row(s) from worksheet 'First Worksheet'
Indicateurs de type :
T= String (Texte)#= Nombre☑= Boolean[]= Array{}= Objectnull= Valeur nulle
Vue des données binaires
Les données extraites sont renvoyées sous forme de JSON dans la réponse. Accédez directement aux données de la ligne depuis le extractedData.rowData tableau:
extractedData
─────────────────────────────
rowData: Array of row objects
success: true
errorMessage: null
Accès aux données :
- Tableau de données de ligne:
$json.extractedData.rowData - Rangées individuelles:
$json.extractedData.rowData[0] - Valeurs de la colonne:
$json.extractedData.rowData[0]["First Name"] - JSON Réponse: Disponible sous forme structurée JSON dans n8n réponse
Cas d'utilisation
- API alimentationExtraire les lignes filtrées et les envoyer directement à REST points de terminaison ou consommateurs de webhook.
- Ingestion de bases de donnéesTransformer les rapports Excel en données structurées JSON chaque nuit avant l'insertion dans les bases de données SQL/NoSQL.
- Validation et assurance qualitéExtrayez des plages de valeurs pour les vérifications de règles, envoyez des alertes ou enrichissez d'autres flux de travail sans exportation manuelle.