Documentation

Importer un dossier

Faire d'un dossier un projet, l'empreinte SHA-256 de chaque fichier, réanalyser un dossier qui a changé.

Un projet est un dossier de votre disque que Vault préserve. L’import ne copie ni ne déplace rien : Vault enregistre le chemin du dossier, la structure de ses sous-dossiers et, pour chaque fichier, sa taille, sa date de modification et son empreinte SHA-256. Cette empreinte, prise à l’entrée, est la référence contre laquelle toute altération sera mesurée.

Importer un dossier

  1. Ouvrez Projets (groupe Préserver).
  2. Cliquez sur Importer un dossier….
  3. Choisissez le dossier, puis Importer.

Un import en cours : la ligne « Import de « Carnets de voyage » » avec sa barre de progression (256 sur 300), l’étape « Empreintes SHA-256 » et le bouton d’arrêt

Un bandeau suit l’import en trois étapes :

  • Inventaire du dossier : Vault parcourt l’arborescence ;
  • Empreintes SHA-256 : il lit chaque fichier en entier pour en calculer l’empreinte ;
  • Enregistrement : il écrit les fichiers dans la base, par lots.

À la fin, le bandeau Dossier importé résume le résultat : nombre de fichiers importés, et, s’il y en a, les fichiers illisibles avec leur raison. Cliquez sur Masquer pour le fermer.

Ce que Vault retient pour chaque fichier :

  • son chemin dans le projet, sa taille, son empreinte SHA-256 ;
  • pour une image, quand ImageIO sait la lire : ses dimensions, son profil couleur et sa date de prise de vue.

Quelques fichiers sans valeur sont ignorés : .DS_Store, Thumbs.db, .git, node_modules, les fichiers ._… et les dossiers système d’un volume (.Spotlight-V100, .Trashes, .fseventsd…).

Un dossier qui ne contient aucun fichier à préserver (vide, ou fait seulement de liens symboliques) est refusé : « Ce dossier ne contient aucun fichier à préserver. » Un projet n’est jamais créé vide : si aucun fichier n’a pu être lu, ou si vous arrêtez l’import avant que les premiers fichiers soient enregistrés, le nouveau projet est retiré.

Le dossier de la bibliothèque d’Obscura Vault (sa base, ses sauvegardes) ne peut pas être importé, ni un dossier qui le contient ou qui se trouve à l’intérieur.

Un sous-dossier que Vault n’a pas le droit de lire (ou dont le disque n’est plus là) n’est jamais sauté en silence : il figure parmi les fichiers illisibles du bandeau, avec sa raison (« Dossier illisible : … »), et l’import se termine avec des erreurs. Rendez-le lisible, puis réanalysez le projet.

Si un projet du même nom existe déjà (pour un autre dossier), le nouveau reçoit un nom suivi d’un numéro : « Mariage (2) ».

Arrêter un import

Arrêter interrompt l’import. Les fichiers déjà enregistrés sont conservés ; importez de nouveau le même dossier pour reprendre là où l’import s’est arrêté. Un import qui tourne depuis plus de deux minutes demande confirmation avant de s’arrêter.

Consulter un projet

Le projet « Appartement, mai 2022 » sélectionné : chemin du dossier, nombre de fichiers, taille et date d’import, boutons Réanalyser et Afficher dans le Finder, tableau Fichier / Taille / Dimensions / Profil couleur / Prise de vue / SHA-256 et section Imports

La liste de gauche montre vos projets et leur nombre de fichiers. Choisissez-en un pour voir :

  • le chemin de son dossier, son nombre de fichiers, son volume et sa date d’import ;
  • le tableau de ses fichiers : Fichier, Taille, Dimensions, Profil couleur, Prise de vue (l’heure qu’affichait l’appareil photo, sans conversion de fuseau), SHA-256 (les 16 premiers caractères ; survolez pour l’empreinte complète) ;
  • la section Imports : les cinq derniers imports, leur date, leur issue (terminé, terminé avec des erreurs, arrêté, échec) et le nombre de fichiers ajoutés.

Afficher dans le Finder ouvre le dossier du projet.

Quand le dossier change : réanalyser

Vault surveille les dossiers de vos projets pendant qu’il est ouvert. Quand un fichier y change, une pastille orange apparaît à côté du projet et un bandeau le signale : « Des fichiers de ce dossier ont changé depuis l’import. Réanalysez-le pour voir lesquels. » Rien n’est réimporté sans vous.

Réanalyser (ou importer de nouveau le même dossier) fait un import incrémental :

  • les nouveaux fichiers sont ajoutés avec leur empreinte ;
  • les fichiers inchangés (même taille, même date) sont laissés tels quels ;
  • un fichier dont la taille ou la date a changé est relu : si son empreinte est différente, il est signalé, et l’empreinte d’origine est conservée ;
  • les fichiers disparus du dossier sont signalés ;
  • les fichiers d’un sous-dossier devenu illisible sont signalés comme illisibles, pas comme disparus.

Ce que la réanalyse prouve entre aussitôt au journal de fixité, comme un audit : un fichier dont l’empreinte a changé devient Altéré, un fichier disparu ou illisible Non vérifiable, un fichier relu à l’identique Vérifié. Le Tableau de bord et l’écran Intégrité le montrent sans attendre le prochain audit. Un fichier dont seule la date a changé (contenu identique) n’est plus relu aux réanalyses suivantes.

Le bandeau Dossier réanalysé liste les fichiers modifiés et absents (les cinq premiers de chaque liste).

Vault ne remplace jamais l’empreinte prise à l’import par une nouvelle. Si vous avez retouché volontairement un fichier, c’est un nouvel original : rangez-le sous un autre nom, et il entrera comme nouveau fichier à la prochaine réanalyse.

Dossier déplacé ou import par erreur

Vault reconnaît un projet au chemin de son dossier. Si vous avez déplacé ou renommé le dossier (par exemple sur un nouveau disque), le projet affiche « Le dossier de ce projet est introuvable à cet emplacement… » : cliquez sur Relocaliser le dossier… et choisissez le dossier à son nouvel emplacement. Vault garde les empreintes prises à l’import, vérifie que le dossier choisi contient bien des fichiers du projet, puis le réanalyse.

Le menu … à côté de Réanalyser propose aussi :

  • Relocaliser le dossier… ;
  • Retirer de la bibliothèque… : retire le projet, ses empreintes et son historique d’intégrité de la bibliothèque, après confirmation. Le dossier et ses fichiers ne sont ni déplacés ni supprimés, les archives déjà créées restent, et le retrait est noté au journal.

Bon à savoir

  • Le dossier d’un projet sur un disque externe n’est lisible que quand le disque est branché. Débranché, ses fichiers sont « non vérifiables » à l’audit (voir Comprendre les verdicts).
  • Un même dossier n’est jamais deux projets : Vault reconnaît un dossier à son chemin, pas à son nom.
  • Chaque import est noté au journal (« Dossier importé ») et dans le journal de préservation du projet.