Import de données en masse

Pour un très gros fichier, bench data-import importe un CSV ou un XLSX en ligne de commande, sans passer par le délai d’une requête web.

1 min de lectureMis à jour le 5 octobre 2026Source : docs.frappe.io

Pourquoi la ligne de commande

Pour de très grands jeux de données, par exemple plus de 5 000 documents, la source recommande l’utilitaire bench data-import plutôt que l’interface web. Cela évite les délais dépassés des requêtes web et rend l’import plus fiable.

Exemple

terminal

bench --site test.erpnext.com data-import ~/Downloads/Activity_Type.csv

L’aide de la commande :

terminal

bench data-import --help

Usage

terminal

bench data-import [OPTIONS]

La commande importe en masse des documents depuis des fichiers CSV ou XLSX.

Option	Rôle
`--file FILE`	Chemin du fichier `.csv` ou `.xlsx`. Un chemin relatif est résolu depuis le dossier `sites`. Obligatoire, sauf si le chemin est donné en argument positionnel.
`--doctype TEXT`	DocType cible. Obligatoire.
`--type [Insert\|Update]`	Insère de nouveaux enregistrements, ou met à jour les enregistrements existants.
`--submit-after-import`	Valide le document après l’import.
`--mute-emails`	Coupe les e-mails pendant l’import.
`--help`	Affiche l’aide et quitte.

Point d’attention

--file peut être omis si le chemin est passé en argument positionnel, comme dans l’exemple. Le DocType cible reste obligatoire. Un chemin relatif ne part pas du dossier courant : il est résolu depuis sites.