Avez-vous jamais eu besoin de documenter la structure de vos classeurs Calc ? Avez-vous un jour reçu en héritage un classeur à maintenir que vous n’aviez pas créé ? Avez-vous passé des heures à collecter les informations dispersées un peu partout dans l’outil pour les noter dans un document d’audit ou pour simplement comprendre le fonctionnement du classeur ? Avez-vous pesté contre ce travail de bénédictin, source d’erreurs ou d’oublis ?
Si vous avez répondu « oui » à l’une de ces questions, alors TheCAT est pour vous.

TheCAT (The Calc Auditing Tool) est un outil d’audit pour les documents tableur LibreOffice Calc. Grâce à lui, vous obtiendrez, sous forme d’un document unique, un grand nombre d’informations à propos du classeur analysé.

TheCAT :

• documente les paramètres généraux du document : description, propriétés personnalisées, options de sécurité,

• documente les propriétés du classeur : sécurisation, options d’affichage, formats de nombres personnalisés, styles, polices utilisées, plages nommées et de bases de données, liste des feuilles et de leurs relations, tables dynamiques, liens externes, listes de validité, macros et événements,

• détaille chaque feuille : nom, zone de données, liens avec d’autres feuilles, paramètres, zones (zone d’impression, colonnes ou lignes à répéter), colonnes et lignes masquées, plages, tables dynamiques, liens externes, formats conditionnels, annotations, scénarios, objets OLE, diagrammes, images, contrôles et événements,

• le dernier chapitre du rapport est constitué d’un ensemble de notes ou conseils, en fonction des points particuliers rencontrés (métadonnées absentes, date de création invalide, styles personnels non utilisés, formats de nombres personnalisés non utilisés, polices uniquement utilisées dans des formatages conditionnels, partage d’écran à des valeurs anormales, tables dynamiques invalides, styles inexistants référencés par des formatages conditionnels, objets OLE non nommés),

• crée des rapports sous Writer à partir de modèles paramétrables.

En outre :

• Le modèle de rapport peut être personnalisé pour y ajouter un logo, un nom d’entreprise ou encore en vue de sa localisation,

• vous pouvez choisir le modèle à utiliser et pouvez gérer la liste des modèles. Cette dernière est conservée entre les sessions,

• l’outil peut être localisé grâce à l’emploi de fichiers PO.

  Le format PO (portable object) et son usage sont décrits dans les pages gettext du projet GNU Translation Project, ici : https://www.gnu.org/software/gettext/manual/gettext.html

Les icônes de TheCAT ont été trouvées sur le site Flaticon (https://www.flaticon.com) : l’icône de l’extension et les icônes des boutons sont de freepik (https://www.freepik.com/). L’utilisation de ces icônes est libre.

Le dialogue principal | Contenu des rapports | Rapports personnalisés | Localiser TheCAT | Crédits | Auteur | Licence

Le dialogue principal

Ce dialogue permet de choisir le classeur à auditer, de sélectionner le modèle de rapport à utiliser et de lancer la réalisation du rapport :

Contenu des rapports

Les rubriques des rapports indiquent clairement leurs contenus. Voici cependant quelques points qu’il semble nécessaire de détailler.

Rapports incomplets

Lorsque vous demandez un rapport pour un document non enregistré (Sans nom N), ce rapport est nécessairement incomplet. Il manque des informations qui ne sont ajoutées que lorsque le document est enregistré (ex : protection par mot de passe).

Un message vous en informe au moment de la demande de rapport.

Styles de cellules (Classeur / Styles de cellule)

La colonne Utilisé indique :

• O si le style est réellement utilisé pour mettre en forme une cellule ;

• (parent de Xxxx) si le style n’est lui-même pas utilisé mais est parent d’un style utilisé, dont le nom Xxxx est indiqué ;

• (FC) si le style n’est utilisé que pour un formatage conditionnel. Vous trouverez plus de détails dans la feuille concernée ;

• N si le style n’est utilisé ni directement ni indirectement.

Polices utilisées (Classeur / Polices utilisées)

Colonne Origine :

• Style : la police est utilisée dans un style ;

• Style (FC) : la police n’est utilisée que via un formatage conditionnel

• Formatage : la police est utilisée dans une mise en forme manuelle.

Tables dynamiques (Feuille XXX / Tables dynamiques)

Les données sur ces tables figurent sur deux lignes. En première ligne : la plage de sortie (celle qui se trouve sur la feuille courante), les champs de ligne et les champs de page. En seconde ligne : la plage d’entrée (éventuellement sur une autre feuille), les champs de colonne et les champs de données.

Formats conditionnels (Feuille XXX / Formats conditionnels)

Lorsque un style référencé dans une mise en forme conditionnelle n’existe pas ou plus, le nom du style est suivi d’un astérisque *.

Objets OLE (Feuille XXX / Objets OLE)

Lorsque un objet a été baptisé par l’utilisateur, ce nom figure dans la colonne Nom.

Lorsque l’objet n’a pas été explicitement nommé, il porte un nom interne attribué par LibreOffice à la création. Ce nom figure entre crochets [ ].

Les modèles de rapports

Présentation générale

TheCAT s’appuie sur un modèle de rapport pour générer le document final. La modification de l’aspect ou du contenu de ce dernier repose donc sur la fourniture d’un modèle adapté.

Le modèle de rapport a été conçu pour être modifié facilement. Il y a cependant quelques éléments à connaître en matière de contenu et en termes de mise en forme.

• Avant tout travail sur le modèle et pour un meilleur contrôle, je conseille d’activer le mode Affichage des marques de formatage du traitement de textes.

Contenu des modèles de rapports

Le contenu textuel du document est totalement modifiable directement. Remplacez le texte existant par votre nouvelle version et c’est fait. Vous pouvez également insérer du texte de votre cru à votre modèle, sous réserve de lire ce qui suit.

Trois remarques cependant, à propos des tableaux et à propos des autres contenus libres.

Les informations sur les feuilles

Le modèle comporte une section dédiée (section modèle) dans laquelle se trouvent les éléments.

Ne supprimez pas et ne renommez pas cette section, faute de quoi les données des feuilles ne seraient pas retranscrites.

Les autres modifications sont décrites ci-dessous.

Les tableaux

Les tableaux sont le point d’insertion de l’information dans le rapport.

• Par conséquent ne les supprimez pas et ne les renommez pas !

Vous pouvez librement modifier les titres des colonnes ou des lignes voire l’organisation des cellules. Dans ce dernier cas, veillez à insérer les identificateurs correspondants pour que les données soient correctement insérées.

Attention lors de la modification de textes dans les tableaux : il ne doit pas y avoir collision avec des identificateurs !

Ajouter des commentaires ou notes dans les chapitres

Vous pouvez librement ajouter des commentaires aux différents chapitres consacrés au document, au classeur ou au détail des feuilles.

• Veillez cependant, à ne pas insérer de texte en fin de document.

Mise en forme des modèles

L’ensemble des mises en forme s’appuie lourdement sur l’existence de styles, y compris pour les tableaux. La modification des mises en forme doit donc être réalisée sur ces styles.

Créer un rapport personnalisé

Cette opération permet d’ajouter un logo, une raison sociale, de modifier certaines énonciations, d’ajuster l’aspect à une charte graphique, etc.

1. Partez d’un modèle existant : sélectionnez-le puis Enregistrer. Le fichier .ott est prêt à être modifié.

2. Après mise à jour, réimportez-le (sous un nouveau nom pour ne pas perdre l’existant) par Ajouter.

• Avant de procéder, veuillez lire ce qui précède.

Localisation de TheCAT

TheCAT est développé en anglais mais l’interface est conçue pour s’ajuster automatiquement à l’environnement localisé de LibreOffice. Actuellement il n’y a que deux « locales » prises en charge : l’anglais comme langue par défaut et le français, ma langue maternelle.

La localisation est permise à partir de fichiers PO https://www.gnu.org/software/gettext/manual/html_node/PO-Files.html) (pour l’interface), d’un modèle de rapport (au moins) et d’un fichier d’aide en HTML (pour l’aide). Par conséquent, le support de nouvelles langues est facilité.

Les fichiers PO sont stockés dans le répertoire po de l’extension. Les modèles personnalisés des rapports sont enregistrés dans le dossier templates/custom de l’extension. Les fichiers HTML d’aide le sont dans le répertoire help. Le fichier localisé est automatiquement sélectionné pour correspondre à la locale. En cas d’absence, c’est la locale en (anglais) qui est choisie par défaut.

Créer un nouveau fichier PO

1. Ouvrez le modèle .pot fourni (fichier en.pot).

2. Éditez-le au moyen de n’importe quel éditeur de texte et remplissez les chaînes msgstr (ne touchez pas aux msgid !).

3. Enregistrez-le comme fichier xx.po, où xx correspond au code de la langue à deux caractères (es : espagnol, de : allemand, etc.)

4. Copiez-le dans le sous-répertoire po et c’est tout. Au prochain démarrage, l’interface devrait être traduite en utilisant vos chaînes.

N’oubliez pas d’envoyer à l’auteur un exemplaire du fichier PO. Vous recevrez crédit dans cette page d’aide.

Créer un nouveau fichier d’aide

1. Ouvrez la version anglaise du fichier HTML d’aide (TheCAT_help_en.html).

2. Traduisez-le dans la langue de votre choix.

3. Nommez-le en conséquence : TheCAT_help_xx.html, où xx correspond au code de la langue à deux caractères (es : espagnol, it : italien, etc.)

4. Déposez-le dans répertoire help de l’extension et c’est tout. Au prochain démarrage, l’aide devrait être traduite en utilisant votre fichier.

N’oubliez pas d’envoyer à l’auteur un exemplaire du fichier HTML. Vous recevrez crédit dans cette page d’aide.

Localiser un modèle de rapport

Dans ce cas, vous allez modifier les contenus du document pour l’adapter à votre langue préférée.

Vous trouverez tous les détails au chapitre Contenu des modèles de rapports.

Crédits

Auteur

TheCAT est développé par Jean-Francois Nifenecker, Bordeaux (France)

jean-francois.nifenecker@laposte.net

Tous mes remerciements aux testeurs, en particulier à Michel Rudelle pour ses analyses très poussées et ses nombreuses suggestions.

Icônes

L’icône de TheCAT et l’icône du bouton de barre d’outils sont de freepik (https://www.freepik.com/) et ont été trouvées sur https://www.flaticon.com/. Elles sont librement réutilisables.

Traductions

(aucune actuellement)

Historique

Licence