Ressources · Intégration n8n

Nœud Default Data Loader n8nConfigurer Default Data Loader dans n8n.

Un modèle ne lit pas un fichier, il lit des documents : c'est cette conversion que le nœud fait. Le nœud Default Data Loader n8n récupère le JSON ou le fichier binaire de l'étape précédente, le fait passer par un découpeur de texte et transmet les morceaux à la chaîne au-dessus. Six paramètres, un port requis.

Tester le nœud Default Data Loader sur n8n Voir les 6 paramètres

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

À quoi sert le nœud Default Data Loader n8n ?

Default Data Loader est un sous-nœud, c'est-à-dire un nœud qui ne s'exécute jamais seul : on le tire sur le port d'un nœud racine et il l'alimente. Il lit la donnée de l'étape précédente du workflow, soit le JSON de l'item entrant, soit un fichier binaire qui y est attaché, et la convertit en documents, le format découpé que les nœuds IA savent lire. Sa description dans n8n tient en une ligne : charger la donnée de l'étape précédente.

Premier cas, des devis signés. Le fichier arrive dans le workflow, Type of Data passe sur Binary, Data Format sur PDF, et Split Pages in PDF fabrique un document par page. Les conditions particulières restent ainsi rattachées à la page où elles se trouvent, au lieu de se noyer dans un pavé unique.

Deuxième cas, pas de fichier du tout. Des lignes remontées de Google Sheets ou des messages récupérés dans Gmail arrivent en JSON brut. Type of Data reste sur JSON, Mode sur Load Specific Data, et JSON Pointers ne garde que les champs utiles. Le corps du message part dans l'index, les identifiants techniques non.

Troisième cas, un catalogue produit exporté en CSV. CSV Separator se cale sur le caractère réellement utilisé par l'export et CSV Column désigne la seule colonne qui contient de la prose, la description. Les références et les prix ne deviennent pas des documents. Deux propriétés Metadata en plus, et la recherche saura filtrer dessus plus tard.

Quand prendre autre chose. Ce nœud prépare, il n'interroge rien et ne parle à aucun modèle. Un assistant qui répond à des questions a besoin d'un nœud racine comme AI Agent avec un modèle de chat branché dessus, par exemple OpenAI ; le loader n'intervient que du côté de l'indexation. Et si le texte est déjà dans un champ de l'item, sans aucun fichier à analyser, le mode JSON avec Load All Input Data suffit largement.

Les limites, sans détour. Six paramètres, pas un de plus : aucun aperçu des morceaux produits, aucune étape de nettoyage, aucun dédoublonnage d'une exécution à l'autre. Le découpage lui-même appartient au sous-nœud branché sur le port, pas à ce panneau. Enfin, si Data Format impose un format et que le fichier entrant n'y correspond pas, le nœud tombe en erreur au lieu de deviner. Pour monter une chaîne complète en conditions réelles, la Formation n8n existe, et l'Avis n8n détaille le terrain de comparaison côté hébergement et coût.

Connexions

Qu'est-ce qu'on branche sur ce nœud ?

n8n sépare les nœuds racines, qui vivent dans le flux principal, et les sous-nœuds, qui se raccordent sur leurs ports : le loader accueille un sous-nœud en dessous et s'accroche à un nœud racine au-dessus.

Ports (ce qui se branche)

Text Splitterai_textSplitterrequis

Sortie (où il se branche)

Documentai_document

01Text SplitterLe découpeur tranche le texte long en morceaux avant qu'il ne devienne des documents. Port vide, le loader n'a personne à qui confier ce découpage et l'exécution s'arrête.

Le découpeur tranche le texte long en morceaux avant qu'il ne devienne des documents. Port vide, le loader n'a personne à qui confier ce découpage et l'exécution s'arrête.

Paramètres clés

Required : le port doit porter un sous-nœud pour que le loader tourne.
Recursive Character Text Splitter : le point de départ habituel, il coupe d'abord sur les paragraphes et les phrases avant de tomber sur un découpage par caractères.
Character Text Splitter : coupe sur un seul séparateur choisi, prévisible sur un texte régulier.
Token Splitter : coupe en jetons, l'unité dans laquelle un modèle compte ce qu'on lui envoie.

Cas d'usage

un manuel PDF passe par le découpeur récursif pour garder ses paragraphes entiers, alors qu'un export de logs, une ligne par entrée, va très bien avec le découpeur par caractères.

02DocumentCôté sortie, le loader ne se place pas dans le flux principal. Il se branche vers le haut, et les documents qu'il fabrique sont consommés par le nœud racine placé au-dessus de lui.

Côté sortie, le loader ne se place pas dans le flux principal. Il se branche vers le haut, et les documents qu'il fabrique sont consommés par le nœud racine placé au-dessus de lui.

Paramètres clés

Required : tant qu'aucun nœud racine n'accepte ces documents, le loader ne produit rien d'utile.
Summarization Chain : le nœud racine qui reçoit cette sortie, lit les documents et en tire un résumé.

Cas d'usage

un compte rendu hebdomadaire arrive en fichier, le loader le transforme en documents, et la chaîne de résumé au-dessus renvoie la version courte publiée dans Slack.

Paramètres

Quel paramètre fait quoi ?

Le nœud Default Data Loader compte 6 paramètres. Pour chacun : le nœud tel que tu le configures dans n8n, ce que le paramètre change, et nos notes de terrain.

Type of Data

dataType

Ce que tu vois dans n8n

Notes & cas d'usage

Ce premier arbitrage reconfigure tout le panneau en dessous.

Paramètres clés

Type of Data : json traite le JSON de l'étape précédente, binary un fichier qui y est attaché.
Mode : allInputData prend tout ce qui entre dans l'agent ou la chaîne parente, expressionData charge un sous-ensemble, specificField un champ binaire nommé.
Data Format : auto détecte par type mime, ou choisis pdfLoader, csvLoader, docxLoader, epubLoader, jsonLoader, textLoader.
Data : le contenu JSON, glissé depuis le panneau d'entrée ou écrit {{ $json.body }}.
Input Data Field Name : le champ qui contient le fichier binaire.

Cas d'usage

une facture jointe à un mail entrant passe en Binary avec Data Format sur PDF, alors qu'un texte déjà présent dans l'item passe en JSON.

JSON Pointers

options.pointers

Ce que tu vois dans n8n

Notes & cas d'usage

Charger un objet JSON entier ramène presque toujours du bruit. Cette option restreint la lecture à des chemins nommés à l'intérieur de l'objet : seul ce que tu pointes devient du texte de document.

Paramètres clés

JSON Pointers : les pointeurs à extraire du JSON, sous la forme /text, ou plusieurs d'un coup avec /text, /meta/title.

Cas d'usage

une fiche article transporte un titre, un corps et une série de champs de suivi ; pointer le titre et le corps garde des documents lisibles et laisse le reste de côté.

CSV Separator

options.separator

Ce que tu vois dans n8n

Notes & cas d'usage

Le CSV n'est standard que sur le papier. Un export produit dans un environnement européen sort souvent en points-virgules là où le loader attend une virgule, et chaque ligne s'effondre alors dans une seule cellule illisible.

Paramètres clés

CSV Separator : le séparateur à utiliser pour le CSV, réglé sur le caractère réellement présent dans le fichier.

Cas d'usage

un export sorti d'un logiciel de comptabilité utilise des points-virgules, on aligne le séparateur dessus avant que quoi que ce soit n'essaie de lire une colonne.

CSV Column

options.column

Ce que tu vois dans n8n

Notes & cas d'usage

Une feuille de calcul contient en général une colonne de texte et une dizaine de colonnes d'identifiants, de dates et de totaux. Nommer cette colonne-là évite de transformer des chiffres en documents.

Paramètres clés

CSV Column : la colonne à extraire du CSV, désignée par son intitulé d'en-tête.

Cas d'usage

un export d'enquête aligne une réponse libre à côté de huit colonnes de notes ; n'extraire que la réponse donne des documents qui ressemblent à des phrases, pas à un tableau.

Split Pages in PDF

options.splitPages

Ce que tu vois dans n8n

Notes & cas d'usage

Un PDF peut ressortir en un seul bloc de texte, ou en un document par page. Cette case tranche, et elle décide de la finesse de tout ce qui lira le résultat ensuite.

Paramètres clés

Split Pages in PDF : découper ou non les pages du PDF en documents distincts.

Cas d'usage

sur un contrat où une clause doit rester rattachée à l'endroit où elle figure, le découpage par page conserve ce repère ; sur une note de deux pages lue d'un bloc, il n'apporte rien.

Metadata

options.metadata

Ce que tu vois dans n8n

Notes & cas d'usage

Un document seul ne dit rien de sa provenance. Metadata accroche des propriétés à chacun d'eux, et ce sont ces propriétés qui servent ensuite à filtrer au moment de la recherche.

Paramètres clés

Metadata : les métadonnées ajoutées à chaque document, saisies propriété par propriété avec le bouton Add property.
Name : le nom de la propriété, obligatoire pour chaque entrée.
Value : sa valeur, souvent une expression du type {{ $json.source }}.

Cas d'usage

marquer chaque document avec sa langue et son service permet à une recherche ultérieure de répondre depuis le bon sous-ensemble plutôt que depuis tout l'index.

Besoin d'aide

Besoin d'aide pour automatiser Default Data Loader avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Default Data Loader et n8n, les questions fréquentes

01Le nœud Default Data Loader n8n est-il gratuit ?

Oui. Il fait partie du paquet IA de n8n, @n8n/n8n-nodes-langchain, livré avec n8n. Rien à installer, aucun surcoût côté n8n, aussi bien sur n8n Cloud que sur une instance auto-hébergée en Community Edition sous licence Sustainable Use. Un workflow se comporte de la même façon des deux côtés : ce qui a été monté sur Cloud se déplace vers un serveur maison sans retoucher le loader. Le seul coût qui apparaît dans ce type de chaîne vient d'ailleurs, du fournisseur du modèle branché plus loin, qui facture ses propres appels d'API selon ses conditions. n8n n'ajoute rien par-dessus.

02Quels identifiants faut-il pour ce nœud ?

Aucun. Le nœud n'a ni credential, c'est-à-dire l'identifiant enregistré dans n8n pour se connecter à un service, ni sélecteur Authentication. Rien à relier, aucune clé à coller avant de l'utiliser. C'est assez rare parmi les nœuds IA pour être signalé : l'authentification se trouve sur le sous-nœud modèle branché plus loin dans la chaîne, qui porte la clé du fournisseur. Ce que le loader réclame, en revanche, c'est un Text Splitter sur son port requis et de la donnée qui arrive vraiment de l'étape précédente. Une exécution qui casse ici vient d'un port vide, d'un champ requis laissé blanc ou d'un fichier au mauvais format, jamais d'une histoire de connexion.

03Quelles sont les limites du nœud ?

Il prépare des documents, et s'arrête là. Il n'interroge rien, ne calcule aucun vecteur et n'embarque aucun modèle. La version 1 du nœud expose six paramètres : la marge de manœuvre est volontairement étroite, sans aperçu des morceaux produits, sans passe de nettoyage, sans dédoublonnage entre deux exécutions. Le découpage est délégué au découpeur branché sur le port, donc ses réglages vivent sur ce sous-nœud et pas dans ce panneau. Un comportement surprend souvent : avec un Data Format imposé et un fichier dont le type mime ne correspond pas, le nœud tombe en erreur au lieu de se rabattre sur autre chose.

04Que faut-il brancher au minimum, et par quel sous-nœud commencer ?

Un sous-nœud en dessous, un nœud racine au-dessus. En dessous, le port Text Splitter est requis, et le Recursive Character Text Splitter est le bon premier réflexe : il cherche des coupures naturelles avant de se rabattre sur un comptage brut de caractères. Au-dessus, la Summarization Chain accepte la sortie Document. Une fois ce triangle en place, faire évoluer une pièce à la fois devient simple : passer au Token Splitter si un modèle refuse des entrées trop longues, ou au Character Text Splitter quand le texte porte déjà son propre séparateur.

05n8n ou Make pour charger des documents dans une chaîne IA ?

Tout dépend de l'endroit où ces documents ont le droit de passer. n8n s'auto-héberge en Docker ou en npm, ou tourne sur n8n Cloud : un contrat ou un export se traite alors sur une machine maîtrisée. Make est hébergé uniquement, sans option d'auto-hébergement, et facture à l'opération, ce qui compte quand un seul fichier se transforme en quantité de documents. La logique visuelle diffère aussi : n8n raccorde des sous-nœuds sur les ports d'un nœud racine, une forme qui parle ou qui ne parle pas. Le plus simple reste de charger un vrai fichier des deux côtés.

Hack'celeration Lab

Reçois nos tips intégration chaque semaine.

Pas de spam. Désinscription à tout moment.