Installation de l’extension Apache SIS pour OpenOffice / LibreOffice

Pré-requis

Cette extension requiert OpenOffice ou LibreOffice (au choix), ainsi que Java 7 ou 8. La version actuelle de l’extension a été testée avec LibreOffice 5.3 et Java 8. Cette version ne fonctionne pas encore avec Java 9.

Configuration

Avant d’installer l’extension, il peut être utile de configurer OpenOffice ou LibreOffice afin que celui-ci sache où se trouve l’environnement d’exécution du Java (JRE). Cette configuration s’effectue en sélectionnant le menu OutilsOptions sur Linux, ou Open/LibreOfficePréférences sur MacOS. Dans la boîte de dialogue qui s’affiche, sélectionnez Java (sous OpenOffice) ou Avancé (sous LibreOffice). Si aucun environnement Java n’apparaît dans la liste, appuyez sur le bouton Ajouter et sélectionnez le répertoire où un environnement Java est installé. Une fois la liste des environnements Java apparue, sélectionnez une version 7 ou 8 du Java.

Installation

Téléchargez l’extension Apache SIS pour Open/LibreOffice et sauvegardez le fichier n’importe où sur le disque. Dans Open/LibreOffice, sélectionnez le menu OutilsGestionnaire des extensions. Appuyez sur le bouton Ajouter… et sélectionnez le fichier apache-sis.oxt qui a été téléchargé. L’installateur vous demandera d’accepter la licence Apache 2 ainsi que les conditions d’utilisation de la base de données géodésiques EPSG. Après installation, il peut être nécessaire de redémarrer Open/LibreOffice pour qu’elle soit prise en compte. Si un icône de démarrage rapide apparaît dans la barre des tâches, il doit être fermé lui aussi avant de relancer Open/LibreOffice.

L’extension peut être désinstallé à tout moment par ce même menu.

Résolution de problèmes

Si les formules fournit par l’extension Apache SIS ne produit que le résultat #VALEUR!, alors il est possible qu’une erreur survienne lors de l’exécution. Plus de détails peuvent être obtenus en ouvrant le fichier jre/lib/logging.properties avec un quelconque éditeur de texte, et en remplaçant la ligne suivante :

handlers= java.util.logging.ConsoleHandler

par

handlers= java.util.logging.ConsoleHandler, java.util.logging.FileHandler

Par défaut (il est possible de paramétrer plus finement), un fichier avec l’extension .log sera créé dans le répertoire de l’utilisateur. Ce fichier au format XML contient des informations sur le déroulement de l’exécution du programme Java. Les enregistrements dans le journal org.apache.sis.openoffice contiennent des informations se rapportant plus spécifiquement au pont Apache SIS ↔ Open/LibreOffice. L’élément Message contient quelques détails sur la cause de l’erreur. Si vous souhaitez demander de l’aide sur la liste des utilisateurs de Apache SIS, les messages enregistrés dans ce journal peuvent être utiles.