qgis_validation_geoplateforme

Test plugin Validation Geoplateforme

Plugin QGIS – Géoplateforme Validation

Outil QGIS pour téléverser, lancer, suivre et récupérer les résultats des validations de la Géoplateforme, avec gestion OAuth2, politiques claires d’accès aux outputs et téléchargement des logs.

---

✨ Fonctionnalités principales

• Validation depuis QGIS
  • Téléversement de couches du projet ou de fichiers (ZIP / GPKG), paramètres (SRS, normalize, max-errors, encoding, plugins, retention, champs extra), sélection d’un modèle (URL directe ou catalogue configurable).
  • Exécution asynchrone (, messages de statut, progression.
• Liste des validations
  • Filtrage, pagination, détails (status, dates, arguments…).
  • Téléchargements :
    • Outputs (rapport CSV, source.zip, normalized.zip) uniquement si statut = SUCCESS (politique stricte et homogène).
    • Logs (paginés) en .txt
  • Suppression
• Catalogue de modèles
  • Liste (Type/URL/Description), aperçu JSON distant.
• Paramètres
  • authcfg par défaut (OAuth2 depuis le Gestionnaire d’authentification QGIS).
  • URL de base de l’API.

🔐 Politique d’accès & authentification

• Outputs (CSV, source, normalized) : téléchargeables uniquement si le statut de la validation est SUCCESS.
• Logs : téléchargeables (via l’algorithme) quel que soit le statut, sous réserve d’authentification valide.
• OAuth2 : sélectionner dans l’onglet Paramètres une configuration authcfg (créée dans QGIS → Préférences > Authentification) correspondant à celle de la Géoplateforme (peut- être créée par leplugin Geoplateforme pour QGIS=)

Le plugin refuse les appels nécessitant l’auth si authcfg est vide et affiche un message explicite.

---

🛠️ Installation (dev)

QGIS 3.x recommandé (≥ 3.4 conseillé).

1. Cloner ce dépôt dans le répertoire des plugins de votre profil QGIS, par ex. :
   • Linux : ~/.local/share/QGIS/QGIS3/profiles/default/python/plugins/gpf_validation
   • Windows : %APPDATA%\QGIS\QGIS3\profiles\default\python\plugins\gpf_validation
   • macOS : ~/Library/Application Support/QGIS/QGIS3/profiles/default/python/plugins/gpf_validation
2. (Option) Redémarrer QGIS si le plugin n’apparaît pas, puis activer le plugin dans Extensions > Gérer et installer les extensions…
3. Après toute mise à jour du code, pensez à supprimer les dossiers __pycache__ du plugin puis relancer QGIS pour éviter les effets de cache Python.

---

⚙️ Configuration

1. Onglet Paramètres
   • Choisir la configuration OAuth2 (authcfg) par défaut.
   • Vérifier l’URL de base de l’API Validation (par défaut https://data.geopf.fr/validation/api).
   • CLIquer Sauvegarder les paramètres (le provider Processing est rafraîchi).
2. Onglet Catalogue (optionnel)
   • Ajouter des URLs de modèles (JSON) ; aperçu du JSON distant.

---

🚀 Utilisation

1) Lancer une validation

• Onglet Validation
  1. Choisir Source : Couches du projet ou Fichiers (ZIP/GPKG), cocher les éléments à envoyer.
  2. Sélectionner le modèle (URL directe ou entrée du Catalogue).
  3. Ajuster les paramètres (SRS, normalize, max-errors, encoding, plugins, extra, retention).
  4. Cliquer Téléverser & Lancer (asynchrone).

2) Suivre & télécharger

• Onglet Liste des validations
  1. Lister (filtres disponibles) puis sélectionner une ligne.
  2. Outputs (CSV / source / normalized) : téléchargeables uniquement si statut = SUCCESS.
     • Les champs de chemin montrent un placeholder “Suggéré : …” ; si vous laissez vide, le plugin complète automatiquement avec le chemin suggéré lors du clic.
  3. Logs : cliquer Télécharger les logs (txt) (disponibles quel que soit le statut si auth OK).
  4. Supprimer (source/normalized) si nécessaire.

Note : la case “Tout cocher / Tout décocher” (tri‑état) du volet Validation permet de basculer l’ensemble des éléments ; l’état partiel est affiché quand la sélection est mixte.

---

📄 Licence

Le plugin est distribué sous les termes de la licence GPL-3.0

---