Clustraly
Sauvegardes, mises à jour & import/export

Import de données : remettez votre contenu exactement là où il doit être

Import de données une fonctionnalité du module Sauvegardes, mises à jour & import/export de Clustraly. L'import de données rétablit vos articles, catégories, tags et pages depuis un export JSON Clustraly, avec choix de la stratégie de doublons.

Téléversez un export JSON Clustraly, choisissez comment traiter les doublons, et retrouvez vos entités et leurs traductions sans jamais mettre vos tables en danger.

Le bénéfice

Votre contenu revient à sa place en un téléversement

Vous récupérez articles, catégories, tags et pages avec leurs traductions à partir d'un simple fichier d'export JSON. Pas de ressaisie, pas de copier-coller d'écran en écran.

L'import lit le fichier produit par l'Export de données et réinjecte chaque entité dans sa table d'origine, à l'identique.

  • Articles, catégories, tags et pages restaurés
  • Tables de traductions (_translations) incluses
  • Un seul fichier JSON à téléverser
Comment ça marche

Un téléversement, une vérification, un import propre

Vous envoyez votre fichier via un formulaire sécurisé, et Clustraly confirme qu'il s'agit bien d'un export maison avant d'écrire la moindre ligne.

L'appel POST /admin/import/upload (multipart, CSRF, permission settings.edit) contrôle l'en-tête cms=clustraly, puis traite les tables reconnues une par une.

  • Contrôle de l'en-tête cms=clustraly
  • Formulaire protégé par jeton CSRF
  • Réservé aux profils habilités (settings.edit)
Vous décidez

Ignorer ou fusionner : c'est vous qui tranchez

Avant de lancer l'import, vous choisissez le comportement face aux contenus déjà présents. Deux stratégies claires, aucun écrasement par surprise.

« Ignorer » laisse intacts les slugs existants (INSERT IGNORE) ; « Fusionner » met à jour les enregistrements en doublon (ON DUPLICATE KEY UPDATE).

  • Ignorer : conserve l'existant, ajoute le reste
  • Fusionner : met à jour les doublons
  • Choix explicite à chaque import
Les garde-fous

Vos tables restent protégées, ligne après ligne

L'import n'écrit que dans les tables qu'il connaît et n'insère que les colonnes qui existent réellement. Un fichier bricolé ne peut pas détourner l'opération.

Une liste blanche des tables d'entités et de traductions, croisée avec les colonnes réelles de chaque table, ferme la porte à l'injection SQL.

  • Liste blanche des tables autorisées
  • Intersection avec les colonnes réelles
  • Protection contre l'injection SQL
Quand l'utiliser

Migrer, réamorcer ou réintégrer votre contenu éditorial

Faites passer votre contenu d'un environnement de test vers la production, réamorcez un nouveau site, ou réintégrez un lot d'entités exporté plus tôt.

L'import fait équipe avec l'Export de données : ce que vous sortez en JSON, vous le réinjectez quand vous le décidez.

  • Migration préprod vers production
  • Réamorçage d'un nouveau site
  • Retour d'un lot exporté
La preuve

Un compte-rendu clair après chaque import

À la fin, vous savez exactement combien d'enregistrements sont entrés et selon quelle stratégie. Rien ne se passe en silence.

Clustraly affiche « X enregistrements importés », émet une notification de fin (importCompleted) et journalise l'opération dans l'audit (data.import) avec le nombre et la stratégie.

  • Rapport « X enregistrements importés »
  • Notification de fin d'import
  • Trace d'audit data.import horodatée
Pourquoi ça compte

Clustraly prépare, vous décidez

Clustraly valide le fichier, respecte vos tables et applique la stratégie que vous avez choisie. À aucun moment vous ne perdez la main sur ce qui entre dans votre base.

FAQ

Questions fréquentes

Quel fichier puis-je importer ?
L'import attend un fichier d'export JSON généré par Clustraly, reconnu à son en-tête cms=clustraly. C'est exactement le fichier produit par la fonctionnalité Export de données.
Que se passe-t-il si un contenu existe déjà ?
Vous choisissez au moment de l'import : « Ignorer » laisse les slugs existants intacts, tandis que « Fusionner » met à jour les enregistrements en doublon. Rien n'est écrasé sans votre décision.
Un fichier modifié peut-il abîmer ma base ?
Non. L'import n'écrit que dans une liste blanche de tables et n'accepte que les colonnes réellement présentes, ce qui bloque l'injection SQL. L'accès exige aussi la permission settings.edit et un jeton CSRF.
Quelles entités sont prises en charge ?
Les articles, catégories, tags et pages, chacun accompagné de sa table de traductions (_translations), tels qu'ils figurent dans l'export.
Prêt à commencer ?

Prêt à réinjecter votre contenu en toute confiance ?

Téléversez votre export JSON Clustraly, choisissez d'ignorer ou de fusionner les doublons, et laissez la validation stricte protéger vos tables. Vous gardez la main, du premier clic jusqu'au compte-rendu final.