Aller au contenu

Import / Export

La page Import / Export centralise les trois flux de sauvegarde et restauration. Tous les fichiers produits sont du JSON, validés à l’import par des schémas Zod stricts ; aucune donnée n’est modifiée tant que vous n’avez pas confirmé.

Page Import / Export avec ses six actions : exporter/importer règles, sessions et workspace.Page Import / Export avec ses six actions : exporter/importer règles, sessions et workspace.

Depuis la page Règles ou Import / Export, cliquez sur le bouton Exporter. Toutes les règles du workspace actif sont sérialisées en JSON, copiées dans le presse-papier ou téléchargées en fichier .json selon le sous-bouton du split button.

Le format embarque pour chaque règle : domaine, label, regex de titre et d’URL, mode de configuration, mode de déduplication, paramètres ignorés, catégorie, état activé. Pas d’identifiant de workspace : une règle est portable entre workspaces.

Wizard d'import : choisir entre fichier, texte collé ou pack.Wizard d'import : choisir entre fichier, texte collé ou pack.
  1. Ouvrez le wizard d’import depuis la page Règles ou Import / Export.
  2. Choisissez la source : un fichier JSON (drag and drop ou parcours), du texte collé, ou la galerie de packs (voir Catégories et packs).
  3. Le wizard valide la structure et classifie chaque règle entrante.

Chaque règle entrante est comparée aux règles déjà présentes dans le workspace actif :

StatutDéfinitionAction proposée
NouvelleAucune règle avec ce domaine et ce label dans le workspace.Ajoutée à l’import.
En conflitUne règle existe avec le même domaine et le même label, mais une ou plusieurs propriétés diffèrent.Résolution propriété par propriété (voir ci-dessous).
IdentiqueUne règle existe avec exactement les mêmes valeurs.Ignorée.
Résolution d'un conflit d'import : choix entre version existante et version importée, propriété par propriété.Résolution d'un conflit d'import : choix entre version existante et version importée, propriété par propriété.

Pour chaque règle en conflit, le wizard affiche un tableau à deux colonnes : Existant et Importé. Vous choisissez, pour chaque propriété divergente, laquelle conserver. Un bouton Tout depuis l’import ou Tout depuis l’existant permet de trancher d’un coup sur la règle entière.

Le wizard d’export propose trois cases à cocher correspondant aux trois compartiments :

CompartimentCoché par défaut
ÉpingléesOui
ActivesOui
ArchivéesNon

Les sessions archivées sont décochées par défaut pour que les exports légers (sauvegarde du quotidien) n’embarquent pas tout l’historique. Cochez Archivées si vous voulez un export complet.

L’export propose également un champ Note optionnel, embarqué dans l’archive et affiché à l’import.

Même mécanique que pour les règles : choix de la source (fichier, texte collé), validation par schéma Zod, classification new / conflicting / identical sur la base du nom et du contenu. La résolution se fait au cas par cas : conserver la version existante, écraser, ou ajouter en suffixant le nom.

L’export d’un workspace produit une archive autonome contenant l’intégralité de la configuration de cet espace : règles, sessions, paramètres, et éventuellement statistiques.

  1. Depuis la page Espaces de travail ou Import / Export, ouvrez Exporter le workspace actif.
  2. Le dialog affiche un récapitulatif (nombre de règles, nombre de sessions).
  3. Options : Note (texte libre embarqué) et Inclure les statistiques (décochée par défaut, les compteurs ne sont pas indispensables au transfert et peuvent être considérés comme personnels).
  4. Validez. Le fichier produit suit le format smarttab_organizer_workspace_{slug}.json.

L’export concerne toujours le workspace actif. Pour exporter un autre workspace, basculez dessus au préalable.

  1. Ouvrez Importer un workspace depuis la page Espaces de travail ou Import / Export.
  2. Sélectionnez la source (fichier JSON ou texte collé).
  3. Le dialog valide la structure et affiche un récapitulatif (règles, sessions, présence de statistiques, note éventuelle).
  4. Choisissez le mode d’import (voir ci-dessous) et validez.
ModeComportement
Nouveau workspaceCrée un workspace neuf avec le nom et la couleur fournis par l’archive. Vous pouvez surcharger le nom dans le champ Nom avant validation.
Fusionner dans le workspace actifAjoute les règles et sessions de l’archive au workspace actif. Les conflits éventuels (ID déjà présent) sont gérés au cas par cas.

Toutes les archives sont du JSON Unicode, lisibles à l’oeil nu. Le schéma de chaque type d’archive est défini dans src/schemas/importExport.ts. Le schéma utilisé à l’import est volontairement relaxé (pas de refinements de niveau formulaire), pour tolérer des archives produites par des versions antérieures.