Principes
Le plugin QGIS AsgardMenu s’adresse à tous les utilisateurs de QGIS. Il met à disposition le patrimoine de données en base PostgreSQL sous la forme d’un menu à la structure personnalisable, qui pourra notamment reprendre l’arborescence de la nomenclature nationale des schémas[1]. Il montre uniquement les tables et vues que l’utilisateur est habilité à consulter.
AsgardMenu (© République Française, 2020-2021) est publié sous licence GNU General Public Licence v3.0 sur le Dépôt interministériel des plugins QGIS.
Développement : Alain Ferraton (MTE-MCTRCT-Mer/SG/SNUM/MSP/DS/GSG), avec l'appui de Leslie Lemaire (MTE-MCTRCT-Mer/SG/SNUM/UNI/DRC).
Origine⚓
Le plugin QGIS AsgardMenu est dérivé du plugin MenuBuilder développé initialement par la société Oslandia pour la DREAL Auvergne-Rhône-Alpes et disponible sur le dépôt du MTE.
Connexions PostgreSQL⚓
AsgardMenu exploite les connexions PostgreSQL 
de QGIS. Chaque connexion fait référence de façon explicite en configuration de base ou implicite dans une configuration d'authentification à une base cible et un nom d'utilisateur.
Le nom d'utilisateur doit être un rôle de connexion[2] déclaré dans la base cible.
Pour plus d'information sur les connexions vers les bases de données sous QGIS on pourra se reporter à la documentation de QGIS.
Pour plus d'information sur les rôles de connexions on pourra se reporter à la documentation de PostgreSQL.
AsgardMenu construit un menu qui donne accès aux ressources (tables, vues) basé sur une ou plusieurs connexions et pour lesquelles le (ou les) rôle(s) de connexion dispose(nt) au moins d'un accès en lecture. Les ressources doivent être localisées dans des schémas référencés[3] par ASGARD.
Attention :
AsgardMenu affiche toutes les connexions prédéfinies dans la session de QGIS, mais seules les bases utilisant l’extension PostgreSQL ASGARD avec une version minimum sont utilisables. Une tentative d'utiliser une base non « asgardisée » générera un message d'erreur :
Il est également nécessaire que l'extension PostGIS soit installée sur la base.
Privilèges requis⚓
Pour son bon fonctionnement, AsgardMenu doit pouvoir accéder à la vue asgardmenu_metadata du schéma z_asgard via la connexion de l'utilisateur.
Cette condition sera remplie si le rôle de connexion utilisé est membre, directement ou par héritage, du rôle de groupe[4] g_consult ou de l'éventuel rôle désigné comme lecteur[5] pour le schéma z_asgard.
À défaut, un message préviendra l'utilisateur que la connexion considérée n'est pas utilisable par AsgardMenu.
Utilisation de l’arborescence Niveau1/Niveau2⚓
Les menus générés exploitent l’arborescence définie par les champs niv1 et niv2 de la table de gestion[6] d'ASGARD s'ils sont renseignés (non NULL).
Pour mémoire niv1 (niveau1) est le premier niveau de l’arborescence des schémas (forme littérale) et niv2 (niveau2) est le second niveau (forme littérale).
Ces champs peuvent être modifiés (sous condition de droits) avec le plugin AsgardManager :
Les schémas utilisant les niveaux d’arborescence apparaissent donc dans le rendu du menu sous forme arborescente sur deux niveaux. Ceci permet en particulier de reproduire la nomenclature nationale des schémas[1].
Exemple :
Avec les valeurs de niv1 et niv2 pré-renseignées pour tous les schémas de la nomenclature nationale, le schéma c_agri_agroalimentaire n'apparaît donc pas sous ce nom, mais sous une forme arborescente plus lisible Agriculture > Agro-alimentaire.
Utilisation du « bloc »⚓
Les schémas peuvent appartenir à un bloc fonctionnel[7] dont la liste est reproduite ci-dessous :
Consultation |
| Bloc respectant la nomenclature issue du Groupe de travail PostGIS Les schémas ventilés dans chacun des blocs seront préfixés de la lettre plus d’un underscore ex : pour le bloc « Consultation » : le schéma « travaux » sera renommé « c_travaux » Particularités : Pour le bloc « Autres », les schémas ne seront pas préfixés. Pour le bloc « Corbeille », les schémas conservent leur pré fixage |
Données travail |
| |
Géostandards |
| |
Données thématiques |
| |
Référentiels |
| |
Données confidentielles |
| |
Données extérieures |
| |
Administration |
| |
Autres |
| |
Corbeille |
| Bloc des schémas mis à la corbeille qui peuvent être restaurés |
Schémas externes à ASGARD |
| Liste des schémas externes à ASGARD |
On peut choisir de faire apparaître ou non le niveau « bloc » dans la génération du menu.