Objectif

Utiliser la même bibliothèque graphique que celle de QGIS : Qt.

Avantages

• mutualisation partielle du travail d’interface graphique
• le packaging actuel (pyinstaller) fonctionne aussi
• bcp d’exemples disponibles en ligne
• cohérence entre produits (plugin Isogeo pour QGIS)
• logiciel graphique pour création de l’interface graphique (Qt Designer)

Inconvénients

• repartir 'from scratch'
• packaging en exécutable à vérifier

Étapes

• concevoir la structure de l'interface via Qt Designer (fichiers *.ui) @vblanlot
• finaliser l'interface via Qt Designer et directement via PyQt5 @Guts
• générer l'interface en Python
• "brancher" les éléments d'interface aux fonctions Python

Dans l'onglet Paramètres, ajouter un bouton qui ouvre le dossier de sortie dans l'explorateur de fichiers (comportement par défaut dans les versions < 2).

Log AMP :

log_IsogeoToOffice.log

Reproduire

1. Régler le pare-feu / proxy pour bloquer les appels à l'API Isogeo
2. Lancer l'application isogeo2office.exe

==> l'application plante immédiatement après la tentative d'authentification.

Pour reproduire :

1. Ouvrir l'application
2. Aller dans le menu "Paramétres"
3. Changer les paramètres d'authentification
4. Importer le fichier json
5. L'explorateur Windows s'ouvre sur votre dossier "Téléchargement" mais aucun fichier ne s'affiche
6. Dans la liste des formats de fichiers recherchés sélectionner "JSON Files" au lieu de "Standard Credentials Files"
7. Le fichier s'affiche

Pour reproduire :

1. Ouvrir l'application
2. Aller dans le menu "Paramètres > Ressources"
3. Réinitialiser les paramètres
4. Une fenêtre s'ouvre
5. Fermer la fenêtre
6. L'application se ferme

Proposition : ajouter un bouton "annuler" qui ferme la fenêtre sans ferme l'appli

Pour reproduire :

1. lancer l'application
2. changer des paramètres (formats d'export, etc.)
3. fermer l'application => les paramètres sont sauvegardés (cf close_event)
4. relancer l'application : les paramètres ne sont pas chargés

cf #32 (comment)

Texte actuel

en anglais

• Completely free to access generic Open Data
• Completely free to work with 20 of your geographic data and services (Isogeo account required)
• Ask for our annual plans to work with your whole geographic data and services !

en français

• Gratuit pour accéder à un ensemble générique de données ouvertes
• Gratuit pour accéder jusqu'à 20 données et services géographiques à documenter soi-même sur Isogeo
• Des abonnements pour accéder à l'ensemble des données et services de son organisme... et d'autres aussi !

Question

Ce texte ne semble pas/plus très adapté, non ?

Pour reproduire

1. Ouvrir l'application
2. Dans l'onglet paramètres, changer le dossier de destination des exports
3. Exporter
4. Aller dans le dossier indiqué, il est vide
5. Aller dans le dossier par défaut ...isogeo2office\output l'export y est stocké

Dans le cadre du développement d'Isogeo On-Premises, l'API aura une URL/IP différente de celle de la plateforme cloud. Il faut donc prévoir de :

1. charger les paramètres directement à partir du fichier client_secrets.json
2. gérer les URLs de l'API de manière dynamique dans le code (aujourd'hui en dur)

Pour reproduire :

1. lancer l'application dans une nouvelle installation
2. cliquer sur le bouton "Choisir" dans l'onglet Paramètres

Repéré par @SimonSAMPERE

Pour reproduire, sélectionner au moins 2 formats d'export et lancer l'export.
La barre est à 100% dès lors que l'export du premier format est terminé.

Pour reproduire :

1. Ouvrir le dossier de l'application
2. Aller dans le dossier _templates
3. Ouvrir le fichier template_isogeo
4. Sélectionner la vignette
5. Ouvrir les options de disposition
6. Constater que la vignette est disposée au dessus du texte

Proposition : alignée sur le texte

template_Isogeo.docx
test_val__Ateliers utilisateurs Isogeo - Cartothèque - Plugin QGIS_438df.docx

Pour faciliter la prise en main de l'utilisateur

Le SDK Python a été refondu (refactored), il s'agit d'utiliser la dernière version dans Isogeo to Office pour profiter des dernières nouveautés.

Voir capture

Pour reproduire :

1. Ouvrir l'application
2. Aller dans le menu "Paramétres"
3. Changer les paramètres d'authentification
4. Importer le fichier client_secret.json
5. L'explorateur Windows s'ouvre sur votre dossier "Téléchargement" mais aucun fichier ne s'affiche
6. Dans la liste des formats de fichiers recherchés sélectionner "JSON Files" au lieu de "Standard Credentials Files"
7. Le fichier s'affiche
8. Selectionner le fichier
9. Valider
10. La fenêtre Windows se ferme puis se ré-ouvre
11. Refermer la fenêtre, enfin vous pouvez sauvegarder vos nouveaux paramètres d'authentification

Lors du lancement de l'application, vérifier si une nouvelle version est disponible en se basant sur l'API de Github : https://api.github.com/repos/isogeo/isogeo-2-office/releases?per_page=1

Comparer ensuite avec la version utilisée : https://pypi.org/project/semver/

Dans la fenetre "Isogeo - Paramètres d'authentification à l'API" le bouton "Demander un accés" ne fonctionne pas

Description fonctionnelle

Au lancement de l’application, une liste déroulante est chargée pour permettre à l’utilisateur de choisir une valeur de filtre (par exemple un mot-clé).

Limitation : contrairement aux possibilités du moteur de recherche de l’API Isogeo, il ne serait pas possible de choisir plusieurs valeurs pour le même type de filtre.

Résultat attendu

(non contractuel)

Threads are stored in an unique file and it's hard to maintain. Let's split different threads in separated files and make threads a module.

Pour reproduire :

1. Ouvrir l'application
2. Aller dans le menu "Paramètres"
3. Modifier vos préférences (dossier de destination, préfixe, etc.)
4. Réinitialiser les paramètres
5. Une fenêtre s'ouvre, cliquer sur OK
6. L'application se ferme
7. Ouvrir l'application
8. Vos préférences ne sont pas réinitialisées

Créer un script Powershell pour générer les exécutables rapidement et fluidifier les publications de version.

Utiliser Sphinx et api autodoc.

Les onglets "Progression catalogage" et "Directive Inspire" sont dans le fichier excel exporté or ces fonctionnalités sont désactivées au niveau de l'appli (voir le menu paramètres > excel)

test_val_.xlsx

Reproduire

1. Créer une nouvelle application Isogeo2office dans Manage
2. Associer l'appli à un GT
3. Exporter le ficher json de connexion
4. Ajouter un partage depuis le GT vers l'appli créée en 1. sans ajouter OpenCatalog
5. Lancer l'application isogeo2office.exe
6. Changer les paramètres de connexion à partir du json créé en 3.
7. Le fichier Json est bien chargé mais lorsqu'on clique sur Enregistrer, Isogeo2Office se ferme sans rien dire.

Si on ajoute OpenCatalog au partage, en 4. alors tout se passe bien.

Proposition

Il serait donc interessant qu'un message s'affiche à l'étape 7. prévenant qu'il faut ajouter OpenCatalog au partage pour qu'isogeo2office fonctionne correctement (même si c'est écrit dans l'aide en ligne).

Pour reproduire :

1. Ouvrir l'application
2. Aller dans le menu paramètres > paramètres d'authentification
3. Changer les paramètres d'authentification
4. L'application se ferme

Log :
log_IsogeoToOffice.log

Pour reproduire

Test réalisé avec l'application isogeo2office - démonstration
Fichier exporté ici :
isogeo2office_.xlsx

1. Ouvrir l'application
2. Exporter vos fiches de métadonnées au format Excel
3. Ouvrir le fichier Excel
4. Aller dans l'onglet "Vecteur" "Raster" "Services" ou "Ressources"
5. Aller dans la colonne "Editer"
6. Cliquer sur le lien "Editer" APP s'ouvre sur le tableau de bord et non sur la fiche editable
7. Aller dans la colonne "Consulter"
8. Cliquer sur le lien "Version en ligne"
9. Excel indique que l'url demandée n'existe pas (404)

Le filtre par partage n'est pas lié aux autres dans l'API. Du coup, en filtrant sur un partage après des filtres précédents, la recherche semble tourner en boucle.

Constat

Actuellement, les anciens paramètres d'authentification sont conservés, surtout à des fins de test et développement.

Solution

Supprimer régulièrement les fichiers dont la date de dernière modification est antérieure à un mois.

Reproduire

1. Lancer l'application isogeo2office.exe
2. Exporter une liste de métadonnées en Excel
3. Ouvrir le fichier Excel exporté

La taille des cellules frise le ridicule. Pour la rime !

Description du besoin

Certains utilisateurs souhaitent utiliser Isogeo to Office pour sauvegarder les métadonnées mais aussi les fichiers téléversés sur Isogeo (cf. doc fonctionnelle).

Comportement attendu

Une nouvelle option d'export apparaît dans l'interface. Si elle est sélectionnée, les ressources téléversées sont téléchargées et stockées dans le dossier de sortie.

Description fonctionnelle

Dans le modèle d’export, une nouvelle variable fait son apparition : varThumbnail. Elle est configurable comme toute autre variable sauf évidemment tout ce qui concerne la mise en forme texte (gras, italique…) dans le dossier input du dossier d’installation, une matrice de correspondance au format Excel thumbnails.xlsx a 2 colonnes :

• isogeo_id : identifiant unique de la métadonnée Isogeo
• img_abs_path : chemin absolu vers l’image à insérer

Lors du traitement, l’application obtient la correspondance et insère l’image en lieu et place de la variable dédiée. Si aucune image ne correspond ou n’est accessible mais que la variable est présente dans le modèle, le logo Isogeo est ajouté.

Le dimensionnement de l’image n’est pas automatique. Charge à l’utilisateur d’adapter l’image ou le cadre dans le modèle.

Résultat
(non contractuel)

Réalisation

• mettre à jour le modèle d'export en Word pour ajouter la balise de vignette
• créer un modèle de tableau de correspondance et l'inclure dans le packaging
• ajouter une option permettant de générer le tableau à partir des métadonnées partagées à l'application
• ajouter une fonction d'import du tableur qui vérifie la structure et le contenu (identifiants, chemins accessibles...)
• lire le fichier, établir la correspondance avec chaque métadonnée et ajouter un attribut thumbnail_local à la structure du json de la métadonnée
• dans le module d'export en Word, si cet attribut existe alors on ajoute l'image liée

Remarques :

• Si aucune image n'est affectée à la métadonnée, le logo Isogeo est appliqué.
• Pour ne pas inclure d'image dans l'export, modifier le modèle.

Le package isogeo-pysdk doit être utilisé dans sa dernière version.

Pour reproduire, sélectionner un filtre :

• la recherche se lance,
• les filtres sont bien mis à jour,
• le nombre de résultats aussi

... mais :

• les filtres ne sont pas affichés
• sélectionner un autre filtre annule le premier
• cliquer sur le bouton exporter ne tient pas compte des filtres

Besoin

Pour certains besoins, notamment de sauvegarde (voir #48), il serait plus pratique de pouvoir utiliser les fonctions d'export en ligne de commande.

Comportement attendu

A DECRIRE

A partir d'un fichier Excel dont la structure est définie, générer un fichier XML ISO19139 pour importer facilement le travail de catalogage.

Fonctionnement simple :

1. Dans IsogeoToOffice : exporter en tableau Excel (fonctionnalité existante)
2. Dans Excel : manipuler le tableur et remplir les champs manquants
3. Dans IsogeoToOffice : charger le fichier Excel rempli et générer les fichiers XML à partir de ce qui est indiqué dans le fichier Excel chargé
4. Importer les fichiers XML dans Isogeo (cf. import par lot)

Appliquer la méthode des QThreads ( #21 ) sur les requêtes de recherche à l'API Isogeo. Cela permettra de figer l'interface graphique.

Pour reproduire :

1. Ouvrir l'application
2. Aller dans le menu "Paramétres"
3. Changer les paramètres d'authentification
4. Sauvegarder
5. D’après le nombre de résultats, les filtres et les informations affichées dans les paramètres d'authentification (non de l'application et partage), le changement des clés ne semble pas être pris en compte.
6. Fermer et ré-ouvrir l'appli, c'est tout bon

Sur les modules d'export principalement :

• Word
• Excel
• XML

Les utilitaires liés :

• formatage des objets
• nettoyage des balises
• contrôleurs des champs de saisie

Dans l'onglet Paramètres, une case à cocher permet de demander à ce que le dossier de sortie soit automatiquement ouvert à la fin des exports (comportement par défaut dans les versions < 2).

Utiliser QSystemTrayIcon.

Ressources :

• doc : http://pyqt.sourceforge.net/Docs/PyQt5/api/qsystemtrayicon.html
• exemple : https: // evileg.com/en/post/68/

Export capacity has been moved into an independent Python package: https://pypi.org/project/isogeo-export-xl/.

Let's use it and clean the older source code.

Dans l'onglet "Paramètres" le bouton de signalement d'une anomalie n'affiche pas d'info-bulle

Dans le cadre de la refonte en Qt (cf. #19 et #20), utiliser les QThreads. Gains attendus :

• éviter que l'interface ne soit figée durant les traitements,
• permettre de gérer la barre de progression et la barre de statut sans bloquer le traitement en cours,
• stabiliser l'application (un plantage d'un traitement n'impacte pas l'application),
• performances (parallélisation)

Tâches concernées :

• mise à jour des paramètres de l'application (dans l'onglet des préférences)
• export en Excel
• export en Word
• export en XML

Ressources :

• doc officielle
• exemple basique
• SO

Pour reproduire:

• supprimer les QSettings correspondant à l'application 'Isogeo', 'IsogeoToOffice'
• supprimer tous les fichiers dans le sous-dossier _auth

Relancer l'application.

Contournement en attendant la correction : il suffit de déposer le fichier d'authentification livré avec l'application directement dans le sous-dossier _auth.

Intégrer https://github.com/Guts/isogeo-notifier