Comment importer un fichier CSV dans EmDash
Préparez une collection, vérifiez un import CSV et mettez à jour vos contenus avec le plugin gratuit Import/Export de Sneaps.
Commencez par la collection, pas le tableau
Vous pouvez importer des contenus CSV dans EmDash avec @sneaps/import-export. Installez le plugin natif, choisissez une collection, chargez le fichier puis vérifiez l’aperçu avant d’enregistrer. L’import transfère des entrées dans une structure existante ; il ne crée pas les templates de pages.
Avant de préparer des centaines de lignes, décidez où vont les contenus. Une collection d’articles peut prévoir un titre, un slug, un extrait et un corps de texte. Vérifiez les champs obligatoires et leurs noms réels. Les exemples utilisent des noms indicatifs : le schéma de votre collection fait référence.
Installez le plugin natif Import/Export
Ajoutez le package au projet, puis enregistrez importExport() dans la configuration EmDash existante de votre fichier astro.config.mjs. Conservez vos autres intégrations et plugins. Recompilez et déployez après avoir modifié la configuration.
Une entrée Import/Export apparaît alors dans la barre latérale de l’administration. Ce parcours concerne les administrateurs disposant des autorisations d’import et de gestion des contenus nécessaires. L’installation passe par npm, et non par le registre des plugins sandboxés.
pnpm add @sneaps/import-export
// astro.config.mjs
import { defineConfig } from "astro/config";
import emdash from "emdash/astro";
import { importExport } from "@sneaps/import-export";
export default defineConfig({
integrations: [
emdash({
plugins: [importExport()],
// Preserve your other EmDash settings and plugins.
}),
],
});Préparez un petit CSV adapté aux champs
Utilisez une ligne d’en-tête avec des noms uniques et un encodage UTF-8. Nommez les colonnes d’après les champs de la collection ; utilisez slug ou id pour identifier les entrées existantes. Exporter un modèle vide depuis le plugin constitue un bon point de départ : il fournit les colonnes de la collection.
Commencez par deux ou trois lignes représentatives. Incluez un titre accentué, de la ponctuation et un texte riche si vos données en contiennent. Une virgule dans une valeur nécessite les guillemets CSV. Gardez les slugs cohérents entre les imports pour qu’une correction éditoriale ne crée pas une nouvelle entrée.
title,slug,excerpt
"A practical guide",practical-guide,"An introduction, with a comma"
"Second article",second-article,"Another example"Lisez l’aperçu avant de lancer
Ouvrez l’onglet Import, sélectionnez la collection et chargez le fichier. Vérifiez le format détecté, les correspondances de champs, le nombre de créations et de modifications et les avertissements. Rien n’est enregistré à cette étape. Choisissez le format de texte riche pour les colonnes concernées et examinez les premières lignes.
Cette version n’importe pas les champs image, fichier, référence, repeater ou blocks. Traitez-les séparément au lieu de supposer qu’une URL de média deviendra une image téléchargée. Si un champ obligatoire manque, corrigez le fichier ou les correspondances avant de poursuivre.
Choisissez comment enregistrer les entrées
Pour un premier test, enregistrer en brouillon facilite la relecture. Choisissez si l’import doit créer et modifier des entrées ou uniquement créer. Le plugin cherche une correspondance par id, puis par slug, en tenant compte de la locale lorsqu’elle est fournie.
Une cellule CSV vide signifie absence de valeur ; elle ne vide pas un champ existant lors d’une modification. Si vous voulez supprimer le contenu d’un champ, vérifiez-le dans EmDash plutôt que de compter sur une cellule vide. Exportez les contenus existants avant une modification en masse pour comparer le résultat avec l’état précédent.
Lancez l’import et contrôlez le résultat
Gardez l’onglet ouvert pendant l’import. Examinez les lignes en échec et téléchargez leur rapport d’erreur. Vérifiez le nombre d’entrées, quelques enregistrements, le rendu du texte riche et les pages réelles avant publication. Un enregistrement réussi n’est qu’une partie du transfert.
Les limites documentées sont de 8 Mio et 5 000 lignes par import. Découpez les jeux plus volumineux en lots clairement nommés et testez le premier avant de continuer. Si un slug appartient à une entrée dans la corbeille, résolvez le conflit avant de réessayer. Le guide d’export complète ce parcours.
Guide d’export CSV / JSON