Documentation

This document in english.

L’utilisation de ce logiciel vous soumet à nos Conditions d’Utilisation et à notre Politique de Protection des Données.

version 1.3.0

Introduction:

gContactOOo fait partie d’une Suite d’extensions LibreOffice et/ou OpenOffice permettant de vous offrir des services inovants dans ces suites bureautique.

Cette extension vous donne l’accès, dans LibreOffice, à vos contacts Google (les contacts de votre téléphone Android).
Elle utilise l’API Google People pour synchroniser vos Contacts Google distant dans une base de données locale HsqlDB 2.7.4.
Cette extension est vu par LibreOffice comme un pilote de base de données répondant à l’URL: sdbc:address:google:*.

Etant un logiciel libre je vous encourage:

• A dupliquer son code source.
• A apporter des modifications, des corrections, des améliorations.
• D’ouvrir un dysfonctionnement si nécessaire.

Bref, à participer au developpement de cette extension.
Car c’est ensemble que nous pouvons rendre le Logiciel Libre plus intelligent.

---

Prérequis:

L’extension gContactOOo utilise l’extension OAuth2OOo pour fonctionner.
Elle doit donc répondre aux prérequis de l’extension OAuth2OOo.

L’extension gContactOOo utilise l’extension jdbcDriverOOo pour fonctionner.
Elle doit donc répondre aux prérequis de l’extension jdbcDriverOOo.
De plus, gContactOOo nécessite que l’extension jdbcDriverOOo soit configurée pour fournir com.sun.star.sdb comme niveau d’API, qui est la configuration par défaut.

---

Installation:

Il semble important que le fichier n’ait pas été renommé lors de son téléchargement.
Si nécessaire, renommez-le avant de l’installer.

• Installer l’extension OAuth2OOo.oxt

  Vous devez installer cette extension, si elle n’est pas déjà installée.

• Installer l’extension jdbcDriverOOo.oxt

  Vous devez installer cette extension, si elle n’est pas déjà installée.

• Installer l’extension gContactOOo.oxt

Redémarrez LibreOffice après l’installation.
Attention, redémarrer LibreOffice peut ne pas suffire.

• Sous Windows pour vous assurer que LibreOffice redémarre correctement, utilisez le Gestionnaire de tâche de Windows pour vérifier qu’aucun service LibreOffice n’est visible après l’arrêt de LibreOffice (et tuez-le si ç’est le cas).
• Sous Linux ou macOS vous pouvez également vous assurer que LibreOffice redémarre correctement, en le lançant depuis un terminal avec la commande soffice et en utilisant la combinaison de touches Ctrl + C si après l’arrêt de LibreOffice, le terminal n’est pas actif (pas d’invité de commande).

Après avoir redémarré LibreOffice, vous pouvez vous assurer que l’extension et son pilote sont correctement installés en vérifiant que le pilote io.github.prrvchr.gContactOOo.Driver est répertorié dans le Pool de Connexions, accessible via le menu: Outils -> Options -> LibreOffice Base -> Connexions. Il n’est pas nécessaire d’activer le pool de connexions.

Si le pilote n’est pas répertorié, la raison de l’échec du chargement du pilote peut être trouvée dans la journalisation de l’extension. Cette journalisation est accessible via le menu: Outils -> Options -> LibreOffice Base -> Contacts Google -> Options de journalisation.
La journalisation gContactLog doit d’abord être activée, puis LibreOffice redémarré pour obtenir le message d’erreur dans le journal.

---

Utilisation:

Dans LibreOffice / OpenOffice aller à: Fichier -> Assistants -> Source de données des adresses…

L’Assistant source de données du carnet d’adresses s’ouvre.

À l’étape: 1.Type de carnet d’adresses:

• Sélectionner: Autre source de données externes.
• Cliquez sur le bouton: Suivant.

À l’étape: 2.Paramètres de Connexion:

• Cliquez sur le bouton: Paramètres.

Un nouvel assistant s’ouvre. Propriétés de la source de données.

A l’étape: 1.Propriétés avancées.
Dans Type de base de données:

• Sélectionner: Contacts Google.
• Cliquez sur le bouton: Suivant.

A l’étape: 2.Paramètres de connexion.
Dans Général: Entrer ici la chaîne de connexion spécifique au SGDB / pilote.

• Mettre votre compte Google (ie: votre_compte@gmail.com)
• Cliquez sur le bouton: Tester la connexion.

Après avoir autorisé l’application OAuth2OOo à accéder à vos contacts, normalement vous devez voir s’afficher: Test de connexion: Connexion établie.

Si la connexion a été etablie, vous pouvez terminer cet assistant avec le bouton Terminer.

A l’étape: 3.Sélection de table.
Si votre source de données comporte plusieurs tables, il vous sera demandé de sélectionner la table principale.
Dans ce cas sélectionnez la table: Tous mes contacts. Si nécessaire et avant toute connexion il est possible de renommer le nom de la table principale dans: Outils -> Options -> Internet -> gContactOOo -> Nom de la table principale.

A l’étape: 4.Assignation de champ.
Si nécessaire il est possible de renommer les noms des colonnes de la source de données à l’aide du bouton: Assignation de champ.
Veuillez poursuivre cet assistant par le bouton: Suivant.

A l’étape: 5.Titre de la source de données.

Il faut créer un fichier odb. Pour cela vous devez:

• Décocher la case: Intégrer cette définition du carnet d’adresses dans le document actuel.
• Nommer le fichier odb dans le champ: Emplacement.

Il faut également rendre accessible ce fichier odb. Pour cela vous devez:

• Cocher la case: Rendre ce carnet d’adresses accessible à tous les modules de LibreOffice
• Nommer le carnet d’adresses dans le champ: Nom du carnet d’adresses.

Maintenant à vous d’en profiter…

---

Comment créer l’extension:

Normalement, l’extension est créée avec Eclipse pour Java et LOEclipse. Pour contourner Eclipse, j’ai modifié LOEclipse afin de permettre la création de l’extension avec Apache Ant.
Pour créer l’extension gContactOOo avec l’aide d’Apache Ant, vous devez:

• Installer le SDK Java version 8 ou supérieure.
• Installer Apache Ant version 1.10.0 ou supérieure.
• Installer LibreOffice et son SDK version 7.x ou supérieure.
• Cloner le dépôt gContactOOo sur GitHub dans un dossier.
• Depuis ce dossier, accédez au répertoire: source/gContactOOo/
• Dans ce répertoire, modifiez le fichier build.properties afin que les propriétés office.install.dir et sdk.dir pointent vers les dossiers d’installation de LibreOffice et de son SDK, respectivement.
• Lancez la création de l’archive avec la commande: ant
• Vous trouverez l’archive générée dans le sous-dossier: dist/

---

A été testé avec:

• LibreOffice 7.3.7.2 - Lubuntu 22.04 - Python version 3.10.12 - OpenJDK-11-JRE (amd64)

• LibreOffice 7.5.4.2(x86) - Windows 10 - Python version 3.8.16 - Adoptium JDK Hotspot 11.0.19 (under Lubuntu 22.04 / VirtualBox 6.1.38)

• LibreOffice 7.4.3.2(x64) - Windows 10(x64) - Python version 3.8.15 - Adoptium JDK Hotspot 11.0.17 (x64) (under Lubuntu 22.04 / VirtualBox 6.1.38)

• LibreOffice 24.8.0.3 (X86_64) - Windows 10(x64) - Python version 3.9.19 (sous Lubuntu 22.04 / VirtualBox 6.1.38)

• Ne fonctionne pas avec OpenOffice sous Windows voir dysfonctionnement 128569. N’ayant aucune solution, je vous encourrage d’installer LibreOffice.

Je vous encourage en cas de problème
de créer un dysfonctionnement
J’essaierai de le résoudre

---

Historique:

Introduction:

Cette extension a été écrite afin de rendre utilisables dans un logiciel libre (LibreOffice ou OpenOffice) vos données personnelles (votre carnet d’adresses) stockées dans votre téléphone Android.

Avec l’extension eMailerOOo, elle peut être la source de données pour des publipostages par courriel (email), à vos correspondants contenus dans votre téléphone.

Elle vous donnera accès à un système d’information que seules les grandes entreprises sont capables, aujourd’hui, de mettre en œuvre.

Ce qui a été fait pour la version 0.0.5:

• Intégration et utilisation de la nouvelle version de Hsqldb 2.5.1.

• Ecriture d’une nouvelle interface Replicator, lancé en arrière-plan (python Thread) responsable de:

  • Effectuer les procédures nécessaires lors de la création d’un nouvel utilisateur (Pull initial).

• Ecriture d’une nouvelle interface DataBase, responsable de tous les appels à la base de données.

• Beaucoup d’autres correctifs…

Ce qui a été fait pour la version 0.0.6:

• Le pilote a un nouveau nom: Contacts Google

• Le pilote est maintenant enregistré pour un nouveau protocole: sdbc:address:google:votre_compte@gmail.com

• L’extension jdbcDriverOOo fournit désormais le pilote nécessaire pour accéder à la base de données HsqlDB utilisée par gContactOOo.

• Modification du Replicator afin de:

  • Ouvrir et fermer la base de données à chaque réplication.
  • Se mettre en attente après la dernière fermeture du carnet d’adresses.
  • Se décharger lors de la fermeture de LibreOffice / OpenOffice.

• Possibilité d’ouvrir la base de données HsqlDB locale par: Outils -> Options -> Internet -> gContactOOo -> Voir la base de données

• Beaucoup d’autres correctifs…

Ce qui a été fait pour la version 1.0.1:

• L’absence ou l’obsolescence des extensions OAuth2OOo et/ou jdbcDriverOOo nécessaires au bon fonctionnement de gContactOOo affiche désormais un message d’erreur.

• Encore plein d’autres choses…

Ce qui a été fait pour la version 1.0.2:

• Prise en charge de la version 1.2.0 de l’extension OAuth2OOo. Les versions précédentes ne fonctionneront pas avec l’extension OAuth2OOo 1.2.0 ou ultérieure.

Ce qui a été fait pour la version 1.0.3:

• Prise en charge de la version 1.2.1 de l’extension OAuth2OOo. Les versions précédentes ne fonctionneront pas avec l’extension OAuth2OOo 1.2.1 ou ultérieure.

Ce qui a été fait pour la version 1.1.0:

• Tous les paquets Python nécessaires à l’extension sont désormais enregistrés dans un fichier requirements.txt suivant la PEP 508.
• Désormais si vous n’êtes pas sous Windows alors les paquets Python nécessaires à l’extension peuvent être facilement installés avec la commande:
  pip install requirements.txt
• Modification de la section Prérequis.

Ce qui a été fait pour la version 1.1.1:

• Utilisation du package Python dateutil pour convertir les chaînes d’horodatage en UNO DateTime.
• De nombreuses autres corrections…

Ce qui a été fait pour la version 1.1.2:

• Intégration d’un correctif pour contourner le dysfonctionnement #159988.

Ce qui a été fait pour la version 1.1.3:

• La création de la base de données, lors de la première connexion, utilise l’API UNO proposée par l’extension jdbcDriverOOo depuis la version 1.3.2. Cela permet d’enregistrer toutes les informations nécessaires à la création de la base de données dans 9 tables texte qui sont en fait 9 fichiers csv.
• L’extension vous demandera d’installer les extensions OAuth2OOo et jdbcDriverOOo en version respectivement 1.3.4 et 1.3.2 minimum.
• De nombreuses corrections.

Ce qui a été fait pour la version 1.1.4:

• Mise à jour du paquet Python python-dateutil vers la version 2.9.0.post0.
• Mise à jour du paquet Python decorator vers la version 5.1.1.
• Mise à jour du paquet Python ijson vers la version 3.3.0.
• Mise à jour du paquet Python packaging vers la version 24.1.
• Mise à jour du paquet Python setuptools vers la version 72.1.0 afin de répondre à l’alerte de sécurité Dependabot.
• Mise à jour du paquet Python validators vers la version 0.33.0.
• L’extension vous demandera d’installer les extensions OAuth2OOo et jdbcDriverOOo en version respectivement 1.3.6 et 1.4.2 minimum.

Ce qui a été fait pour la version 1.1.5:

• Mise à jour du paquet Python setuptools vers la version 73.0.1.
• L’extension vous demandera d’installer les extensions OAuth2OOo et jdbcDriverOOo en version respectivement 1.3.7 et 1.4.5 minimum.
• Les modifications apportées aux options de l’extension, qui nécessitent un redémarrage de LibreOffice, entraîneront l’affichage d’un message.
• Support de LibreOffice version 24.8.x.

Ce qui a été fait pour la version 1.1.6:

• L’extension vous demandera d’installer les extensions OAuth2OOo et jdbcDriverOOo en version respectivement 1.3.8 et 1.4.6 minimum.
• Modification des options de l’extension accessibles via : Outils -> Options… -> Internet -> gContactOOo afin de respecter la nouvelle charte graphique.

Ce qui a été fait pour la version 1.2.0:

• L’extension vous demandera d’installer les extensions OAuth2OOo et jdbcDriverOOo en version respectivement 1.4.0 et 1.4.6 minimum.
• Il est possible de construire l’archive de l’extension (ie: le fichier oxt) avec l’utilitaire Apache Ant et le fichier script build.xml.
• L’extension refusera de s’installer sous OpenOffice quelle que soit la version ou LibreOffice autre que 7.x ou supérieur.
• Ajout des fichiers binaires nécessaires aux bibliothèques Python pour fonctionner sous Linux et LibreOffice 24.8 (ie: Python 3.9).

Ce qui a été fait pour la version 1.2.1:

• Mise à jour du paquet Python packaging vers la version 24.2.
• Mise à jour du paquet Python setuptools vers la version 75.8.0.
• Mise à jour du paquet Python six vers la version 1.17.0.
• Mise à jour du paquet Python validators vers la version 0.34.0.
• Support de Python version 3.13.

Ce qui a été fait pour la version 1.3.0:

• Mise à jour du paquet Python packaging vers la version 25.0.
• Rétrogradage du paquet Python setuptools vers la version 75.3.2, afin d’assurer la prise en charge de Python 3.8.
• Déploiement de l’enregistrement passif permettant une installation beaucoup plus rapide des extensions et de différencier les services UNO enregistrés de ceux fournis par une implémentation Java ou Python. Cet enregistrement passif est assuré par l’extension LOEclipse via les PR#152 et PR#157.
• Modification de LOEclipse pour prendre en charge le nouveau format de fichier rdb produit par l’utilitaire de compilation unoidl-write. Les fichiers idl ont été mis à jour pour prendre en charge les deux outils de compilation disponibles: idlc et unoidl-write.
• Il est désormais possible de créer le fichier oxt de l’extension gContactOOo uniquement avec Apache Ant et une copie du dépôt GitHub. La section Comment créer l’extension a été ajoutée à la documentation.
• Implémentation de PEP 570 dans la journalisation pour prendre en charge les arguments multiples uniques.
• Toute erreur survenant lors du chargement du pilote sera consignée dans le journal de l’extension si la journalisation a été préalablement activé. Cela facilite l’identification des problèmes d’installation sous Windows.
• Pour garantir la création correcte de la base de données gContactOOo, il sera vérifié que l’extension jdbcDriverOOo a com.sun.star.sdb comme niveau d’API.
• Nécessite l’extension jdbcDriverOOo en version 1.5.0 minimum.
• Nécessite l’extension OAuth2OOo en version 1.5.0 minimum.

Que reste-t-il à faire pour la version 1.3.0:

• Rendre le carnet d’adresses modifiable localement avec la réplication des modifications.

• Ajouter de nouvelles langues pour l’internationalisation…

• Tout ce qui est bienvenu…