Utilitaire de réparation de fichier ODF

[Scrat]

Bonjour.

Mise à jour du 3 février 2021 => Version 1.0.5

Important : Merci de ne publier ici que des messages concernant l'utilisation du logiciel et les éventuels problèmes rencontrés.

Je vous propose ici un utilitaire de réparation de fichier ODF écrit en langage Java que je vous propose de tester.

Vous devez donc avoir Java d'installé, ce qui est normalement le cas si vous avez suivi les tutoriels d'installation de Apache OpenOffice ou de LibreOffice.

Je mets en ligne l'archive ODFRepar_v_1_0_5.zip qui contient un dossier ODFRepar_v_1_0_5, lequel contient l'exécutable ODFRepar.jar et un sous-dossier lib contenant les bibliothèques nécessaires.

ODFRepar_v_1_0_5.zip

Version 1.0.5 du 03/02/2021

(383.48 Kio) Téléchargé 733 fois

Cet utilitaire est conçu par couplage d'un réparateur d'archive zip avec l'utilitaire de réparation de fichier XML XmlRepar. Il vous permet de réparer en seulement quatre interactions un fichier ODF (extensions .odt, .ods, .odp, .odg, .odb) ou Microsoft (extensions .docx, .xslsx, .pptx) sans passer par les étapes intermédiaires habituelles (réparation d'archive, extraction, réparation de fichier XML, reconstitution de l'archive). Si la corruption est modérée, vous obtenez directement un fichier ODF réparé et exploitable.

Un tutoriel complet mis à jour pour les versions multilingues est disponible ici au format pdf:

tutoriel_reparation_ODF.pdf

Tutoriel version du 03/02/2021

(376.91 Kio) Téléchargé 438 fois

Notes de versions :
- 1.0.1 : première version opérationnelle.
- 1.0.2 : amélioration de la détection des caractères non autorisés dans les zones de texte.
- 1.0.3 : ajout d'une nouvelle méthode de récupération des entrées zip pour les fichiers n'ayant plus de structure d'archive.
- 1.0.4 : NOUVEAU : cette version est bilingue français / anglais.
- 1.0.5 : version trilingue français/anglais/italien avec correction d'un bogue de pointeur nul lorsqu'aucune entrée zip n'est identifiable.

Dézippez l'archive et stockez le dossier ODFRepar_v_1_0_5 où vous le désirez. Pour lancer l'utilitaire, vous avez deux possibilités:
- par double clic sur l'icône du fichier ODFRepar.jar dans l'explorateur,
- en ligne de commande avec le code suivant:

Code : Tout sélectionner   AgrandirRéduire

java -jar {chemin du dossier ODFRepar_v_x_x_x}/ODFRepar.jar

Dans cette ligne de commande, x_x_x est le numéro de version.

La nouvelle version 1.0.5 démarre en anglais sur les systèmes anglophones, en italien sur les systèmes en italophones, en français sur tous les autres.

Pour forcer le démarrage en anglais sur un système non anglophone, il suffit de passer l'argument "en" au logiciel :

Code : Tout sélectionner   AgrandirRéduire

java -jar {chemin du dossier ODFRepar_v_1_0_5}/ODFRepar.jar "en"

Pour forcer le démarrage en italien sur un système non italophone, il suffit de passer l'argument "it" au logiciel :

Code : Tout sélectionner   AgrandirRéduire

java -jar {chemin du dossier ODFRepar_v_1_0_5}/ODFRepar.jar "it"

Pour forcer le démarrage en français sur un système non francophone, il suffit de passer l'argument "fr" au logiciel :

Code : Tout sélectionner   AgrandirRéduire

java -jar {chemin du dossier ODFRepar_v_1_0_5}/ODFRepar.jar "fr"

(Note : le code de langage peut être passé avec ou sans les doubles-quotes)

Une fenêtre s'ouvre avec une barre de menu et une zone de texte. La barre de menu contient les menus Fichier et Aide. L'aide vous donne quelques informations sur ce que peut faire l'utilitaire, sinon tout se gère par le menu Fichier en suivant les indications de la zone de texte:

1. Menu Fichier -> Ouvrir pour sélectionner le fichier ODF à traiter.
2. Menu Fichier -> Analyser pour démarrer l'analyse. Cela vous donne la liste des entrées, les tailles normales et compressées, et les chances de récupération.
3. Menu Fichier -> Extraire pour extraire les éléments récupérables dans un dossier vide que vous devrez choisir (ou créer).
4. Menu Fichier -> Réparer pour reconstituer une archive avec les éléments qui ont pu être extraits, les fichiers XML étant automatiquement réparés.

Vous ne pouvez accéder à chaque étape que si les précédentes ont été exécutées.

Attention : Réalisez toujours les tentatives de réparation sur une copie de votre document !

Si la corruption est modérée, vous obtenez directement un fichier ODF réparé et exploitable. Si le fichier réparé est inexploitable, il faudra passer par les méthodes habituelles: réparer vous-même les fichiers XML dans le dossier d'extraction en les éditant pour éliminer les parties trop corrompues avant de les traiter par XmlRepar, et ensuite vous devrez utiliser un gestionnaire d'archive pour reconstituer l'archive.

Pour mémoire, la version francophone d'origine est encore accessible ici, mais je conseille toujours de passer à la dernière version :

ODFRepar_v_1_0_1.zip

Version 1.0.1 du 22/09/2019

(401.06 Kio) Téléchargé 3294 fois

Bon tests, et merci pour vos éventuels retours.

A+

[tintin]

Bonjour Scrat,

J'ai installé et mis en pratique ce nouvel outil.

Utilitaire facile à utiliser et qui fournit directement le document réparé avec le nom qui va bien, et en prime dans le dossier dédié, tout le contenu dont le content.xml initial et le content_repare.xml.

* Une remarque pour macOS

par double clic sur l'icône du fichier ODFRepar.jar

Sur macOS : première ouverture par clic droit en pressant sur la touche ctrl (pour surpasser la sécurité Gate Keeper qui empêche l'installation des applications non reconnues par App Store). Par la suite, le double clic fonctionne.

* Autre remarque – déjà faite pour ton ancien outil et concernant mon installation macOS – une fois le document réparé, je l'ai ouvert avec LibreOffice (car sur ma machine, c'est AOO qui est l'application déclarée par défaut) et reçu cette fenêtre

J'accepte la réparation, le document s'ouvre.
Quand je le referme, j'ai cet autre message

J'ai renouvelé la procédure d'ouverture avec ce même document test_recupODF_corrompu_repare, enregistré sous, renommé, et là le document s'ouvre à chaque fois normalement par double clic.

Idem avec OpenOffice.

etc.
Ce n'est pas gênant, il suffit de le savoir et le résultat est là.

Bravo

[Scrat]

Bonjour tintin.

Merci pour tes retours.

C'est assez curieux cette demande de réparation avec la version Mac qui disparaît une fois qu'on a fait "Enregistrer sous". Mais ici, il y a peut-être une bonne raison, car cette toute première version de l'outil de réparation ODF n'enregistre pas tout dans le document réparé.

Si on analyse un document odt simple avec un gestionnaire d'archive, on voit quelques dossiers de la structure ODF qui ne contiennent rien, par exemple tous les sous-dossiers du dossier "Configurations2".

L'outil de réparation identifie tous les dossiers, y compris les dossiers vides, et il les extrait aussi. Par contre, lors de la reconstruction de l'archive à partir des éléments extraits et réparés, les dossiers vides ne sont pas inclus. Apparemment, l'absence des dossiers vides ne gêne pas LibreOffice, du moins ma version Linux, mais je recommande de faire immédiatement "Enregistrer sous" pour que le document retrouve sa structure ODF complète (c'est d'ailleurs ce que je fais systématiquement quand je répare un document sur le forum).

Une prochaine évolution de l'outil de réparation visera à inclure ces fameux dossiers vides lors de la reconstruction de l'archive de manière à mieux respecter la structure ODF d'origine. À bientôt pour la version 1.0.1... avec un tutoriel.

A+

[Scrat]

Bonjour.

Première mise à jour en version 1.0.1 dans le premier message.

Cette nouvelle version reconstitue l'archive en incluant les dossiers éventuellement vides présents dans la structure ODF (tous les sous-dossiers du dossier Configurations2) qui étaient ignorés dans la première version.

En prime, j'ai ajouté un tutoriel au format pdf.

Bon tests.

A+

[tintin]

Bonjour Scrat,

Comportement identique à celui décrit supra.

Rien de plus à dire à mon niveau si ce n'est qu'hier ton nouvel utilitaire m'a déjà permis de rendre un document réparé : viewtopic.php?f=35&t=61021&p=330912#p330912
et les explications fournies dans le tutoriel sont les bienvenues.

Cordialement

[mapyar]

bonjour
un grand grand MERCI pour cet utilitaire qui m'a permis de récupérer mon document.
c'est très simple et efficace

Pas de commentaire autre que pour le fonctionnement de l'utilitaire. Merci

[Scrat]

Bonjour.

Mise à jour en version 1.0.2 dans le premier message.

Cette mise à jour suit celle de l'utilitaire XmlRepar qui inclut une redéfinition des caractères autorisés dans les zones de texte selon les spécifications XML 1.0.

Cette mise à jour devrait améliorer la détection des caractères non autorisés.

Bon tests.

[Scrat]

Bonjour.

Je vous propose ici une nouvelle mise à jour qui devrait permettre de récupérer certaines archives trop corrompues rejetées par la version 1.0.2 avec le message "CE FICHIER N'A PAS DE STRUCTURE ZIP" mais récupérables par l'utilitaire ZipRepar.

ODFRepar_v_1_0_3.zip

Future version 1.0.3 à tester

(403.65 Kio) Téléchargé 53 fois

Cette mise à jour sera la future version 1.0.3, mais je ne la mettrai à disposition dans le premier message que lorsqu'elle aura été suffisamment testée, car les modifications apportées par rapport à la version 1.0.2 sont importantes. J'ai déjà fait quelques tests concluants, mais je fais appel aux bonnes volontés pour faire davantage de tests.

NOTE IMPORTANTE : Ce message remplace celui mis en ligne un peu plus tôt dans la journée où la version proposée au téléchargement comportait une erreur d'aiguillage faussant les diagnostics d'extraction. Si vous avez téléchargé la version 1.0.3 avant la mise en ligne de ce message, veuillez la télécharger à nouveau.

Pour info, les nouveautés par rapport à la version 1.0.2 :

- test de la présence d'octets nuls.

- Introduction d'une nouvelle méthode d'analyse et d'extraction qui recherche des entrées zip dans le flux de données en s'affranchissant de l'en-tête de l'archive zip.

L'analyse et l'extraction démarrent avec la méthode classique de la version 1.0.2. Si le document n'est pas reconnu comme une archive zip, on bascule sur la nouvelle méthode. Donc, pour les documents dont la structure d'archive est reconnaissable, la version 1.0.3 fonctionne exactement comme la version 1.0.2.

À vos tests, et merci d'avance pour vos éventuels retours.

A+

[Scrat]

Bonjour.

Le Père Noël est passé cette nuit et il vous a apporté la dernière version 1.0.4 disponible dans le premier message.

Grande nouveauté : cette version est BILINGUE FRANÇAIS / ANGLAIS.

Elle démarre en anglais sur les systèmes anglophones, en français sur tout autre système.
On peut forcer le passage en anglais sur un système non anglophone en rajoutant l'argument "en" à la ligne de commande.
On peut forcer le passage en français sur un système anglophone en ajoutant l'argument "fr" à la ligne de commande.

Pour le reste, cette version est quasiment identique à la version 1.0.3 publiée il y a quelques jours dans le message précédent, avec la correction de quelques erreurs mineures (pour l'essentiel, des erreurs d'activation des éléments du menu en cas d'échec de l'opération en cours).

Joyeux Noël !

[fcm]

Bonjour Scrat,
Et un Grand merci pour cette livraison de Noël, qui n'aura pas tardé à être mise à profit par un utilisateur en galère
La version bilingue ne m'a pas été utile pour cette fois, mais c'est bon de savoir cela dispo

Merci

François

Pas de commentaire autre que pour le fonctionnement de l'utilitaire. Merci

[charlie.it]

Je m'excuse pour mon français, j'écris en utilisant google translate.
J'ai essayé votre utilitaire de réparation avec intérêt, en l'essayant sur une vingtaine de fichiers publiés sur le forum italien AOO.
Tous avaient le problème du filtre ASCII à l'ouverture.
Je n'ai réussi qu'avec 2 fichiers, les deux .ods.
Aucun résultat avec les fichiers .odt qui sont les plus.

Analyse :
Contrôle des octets nuls...
56646 octets lus.
56646 octets nuls.

CE FICHIER NE CONTIENT QUE DES OCTETS NUL !
Échec de l'analyse !

Ouvrez un autre fichier ou quittez.

Je ne veux pas critiquer votre travail, je vous donne simplement des "feedback" .

[Scrat]

Bonjour Charlie.it

CE FICHIER NE CONTIENT QUE DES OCTETS NUL !

L'utilitaire vous indique ce qu'il a trouvé dans votre document : uniquement des octets nuls. Il n'y a rien à en tirer et il ne peut aller plus loin.

The utility tells you what it has found in your file : only null bytes (value = 0). It cannot go further. Sorry.

Note : you can force english for menus and output if you are on an italian system : just add "en" at the end of the command line:

Code : Tout sélectionner   AgrandirRéduire

java -jar {Path to the ODFRepar_v_1_0_4 folder}/ODFRepar.jar "en"

[charlie.it]

Merci pour votre réponse.
Ce que je voulais faire était de vous donner l'information que votre utilitaire n'a fonctionné que quelques fois et n'a jamais fonctionné avec des fichiers .odt.
J'aimerais savoir quels sont vos taux de réussite.
Sur le forum italien, je reçois plusieurs demandes d'aide mais je n'arrive presque jamais à donner une solution aux fichiers corrompus.

[Scrat]

Bonjour Charlie.it

Cet utilitaire a trois fonctions :
- extraire le maximum d'éléments du document même si la structure d'archive zip est corrompue,
- réparer les fichiers xml qui ont pu être extraits,
- reconstituer une archive correcte à partir des éléments extraits et réparés.

Mais il ne faut pas rêver : si cet utilitaire peut réparer un document en 4 clics lorsque la corruption est modérée, il ne fait pas de miracles en cas de forte corruption pour lequel une intervention manuelle est requise.

Voici les cas de corruption qu'on peut rencontrer, du plus grave au moins grave:

- le document ne contient que des octets nuls, il est irrécupérable.

- la structure d'archive zip est endommagée : l'utilitaire peut malgré tout extraire quelques éléments de l'archive corrompue, mais si le "content.xml" est absent ou ne peut pas être extrait, le document est irrécupérable.

- le "content.xml" a pu être extrait, mais il est endommagé : l'utilitaire tente de le réparer, mais la réparation peut échouer ou donner un fichier inexploitable si la corruption est trop importante. Dans ce cas, il faut intervenir manuellement : reprendre la procédure jusqu'à l'étape d'extraction, puis SANS FERMER L'UTILITAIRE, éditer le fichier xml (par exemple avec Notepad++) pour le NETTOYER en supprimant tout ce qui paraît trop corrompu (mélange de caractères, généralement vers la fin), et ensuite lancer l'étape de réparation, le logiciel se chargeant de fermer correctement le fichier xml tronqué.

- le "content.xml" a pu être extrait et la corruption est modérée (définitions multiples d'un attribut au sein d'une balise, balise manquante ou fichier tronqué) : aucune intervention manuelle n'est nécessaire, la réparation vous donne immédiatement un document exploitable avec un minimum de pertes.

En résumé, si vous n'avez pu réparer aucun odt, c'est que la corruption était trop importante, soit parce que les documents sont réduits à une suite d'octets nuls, soit parce que le "content.xml" est absent, soit parce que la réparation du "content.xml" nécessite une intervention manuelle de nettoyage avant de démarrer la réparation. Il n'y a aucune différence de structure entre les documents ods et odt, l'utilitaire les traite de la même façon.

Pour savoir si votre document a une chance d'être réparé, vous pouvez d'abord utiliser le testeur de fichier corrompu disponible dans la rubrique Récupération de document. Si vous parcourez l'interminable liste d'appels au secours dans cette rubrique, vous aurez une idée du taux de réussite de l'utilitaire de réparation : il y a des réussites, mais aussi beaucoup d'échecs.

Je termine en ajoutant que l'utilitaire de réparation n'est qu'un dernier recours. La meilleure protection contre les pertes de documents, c'est de faire souvent des COPIES DE SAUVEGARDE. Consultez à ce sujet le lien dans ma signature (sauvegarde incrémentale).

A+

[charlie.it]

Ciao @Scrat, merci pour les nouvelles informations.
J'ai pris la liberté de traduire les 2 utilitaires en italien et je demande la permission de les publier sur le forum italien AOO.
Bien sûr, je citerai cet article en tant que source et vous en tant qu'auteur.
Merci.

Tester_file_danneggiati.odt

(18.56 Kio) Téléchargé 40 fois

Ripara_ODF_v_1_0_4.zip

(369.33 Kio) Téléchargé 38 fois

[Scrat]

Merci pour ces traductions, Charlie, et pas de problème pour publier sur le site italien.

Mais on peut conserver les traductions françaises et anglaises et rendre l'utilitaire trilingue en rajoutant vos traductions dans des fichiers dont le nom se termine par "_it.properties". D'ailleurs, toutes les bonnes volontés sont les bienvenues pour ajouter d'autres langues.

Par exemple, les ressources pour la classe Block pourraient être :
BlockResult.properties pour le français qui est le langage par défaut,
BlockResult_en.properties pour l'anglais
BlockResult_it.properties pour l'italien.

Ainsi, le logiciel démarrera en anglais sur un système anglais, en italien sur un système italien, et en français par défaut sur tout autre système.

De plus, le langage italien pourra être forcé sur les systèmes francophones et anglophones en ajoutant l'argument "it" à la ligne de commande.

Dans une prochaine mise à jour, j'ajouterai vos traductions dans la version mise en ligne sur ce forum en vous citant pour la traduction dans une nouvelle rubrique "Crédits" de l'aide. Mais chacun est libre d'adapter l'utilitaire à ses besoins pour l'alléger, par exemple en ne laissant que les fichiers correspondant à la langue désirée par défaut dans les fichiers dont le nom n'a pas l'extension de langage.

[charlie.it]

Mais on peut conserver les traductions françaises et anglaises et rendre l'utilitaire trilingue

Voilà, merci encore.

[Scrat]

Merci Charlie.

Votre version me permet de découvrir une erreur dans le code : je n'avais prévu que les arguments "fr" et "en", et tout autre argument est ignoré. Donc, avec l'argument "it" qu'elle ne reconnaît pas, votre nouvelle version démarre avec le langage par défaut des fichiers .properties dont le nom n'a pas d'extension de langage, c'est-à-dire le français.

En attendant une modification du code dans une prochaine mise à jour, conservez votre première version où le langage français par défaut a été remplacé par la traduction en italien.

[charlie.it]

[Scrat]

Bonjour.

Je vous propose aujourd'hui la mise à jour en version 1.0.5 que vous pourrez télécharger dans le premier message.

1. Cette nouvelle version est trilingue français/anglais/italien grâce à la traduction de charlie.it du forum italien OpenOffice. En outre, la programmation a été modifiée pour accepter en argument tout code de langage pour lequel on aura ajouté les fichiers de traduction. En outre le tutoriel de réparation au format pdf a été mis à jour pour expliquer comment fonctionne l'internationalisation de l'application et comment rajouter des langages.

2. Cette version corrige aussi un bogue présent depuis la version 1.0.3 qui se produisait à l'analyse de fichiers irrécupérables. En effet, depuis la version 1.0.3, lorsque le fichier analysé n'est pas reconnu comme une archive zip, l'utilitaire bascule sur une nouvelle méthode pour rechercher d'éventuelles entrées de type zip dans le flux de données. Mais lorsqu'aucune entrée de type zip n'est trouvée, cette nouvelle méthode provoque une erreur de type pointeur nul, et la fenêtre de diagnostic ne se met pas à jour. Avec la version 1.0.5, lorsque qu'il n'y a aucune entrée de type zip et que tout est perdu fors l'honneur, la version 1.0.5 vous le dit poliment.

Bonne mise à jour.

[charlie.it]

Testé avec succès, merci.