← Retour à la marketplaceVoir les projets →
📊
Import Excel
Import et export de données via fichiers Excel (XLSX) et CSV.
IntégrationSimple~3 joursv1.1.0
Module d'import/export Excel avec validation des colonnes, mapping configurable, prévisualisation avant import, gestion des erreurs ligne par ligne et export de templates.
excelxlsxcsvimportexport
Dépendances requises :
📋 Schéma Prisma
// === Module Import Excel ===
enum ImportStatus {
PENDING
PROCESSING
COMPLETED
FAILED
}
model ImportJob {
id String @id @default(cuid())
entity String // "contacts", "products", etc.
filename String
totalRows Int @default(0)
processedRows Int @default(0)
errorRows Int @default(0)
status ImportStatus @default(PENDING)
errors Json?
createdAt DateTime @default(now())
updatedAt DateTime @updatedAt
@@map("import_jobs")
}🔌 Endpoints API
## API Import Excel POST /api/import/upload # Upload fichier + démarrer l'import GET /api/import/:id/status # Statut et progression GET /api/import/:id/errors # Détail des erreurs par ligne GET /api/export/:entity # Exporter en Excel GET /api/export/:entity/template # Télécharger le template vide
🛠️ Guide d'implémentation
## Implémentation Import Excel ### Dépendances ```bash npm install xlsx # ou exceljs ``` ### Étape 1 — Parser Créer src/lib/excel/parser.ts : - Lire le fichier XLSX/CSV - Mapper les colonnes selon la config - Valider chaque ligne (Zod) - Collecter les erreurs sans stopper ### Étape 2 — Import asynchrone Pour les gros fichiers : créer un ImportJob, traiter en background (ou en streaming). ### Étape 3 — Rapport d'import Après import : X lignes importées, Y erreurs avec détail (ligne, colonne, message).
Prêt à installer ce module ?
Ajoutez-le à un projet existant depuis la page modules du projet.