Plugin QGIS : LizPack Publisher

LizPack Publisher est une extension de QGIS Desktop qui relie QGIS à vos instances. Sans quitter QGIS, vous parcourez les fichiers d'une instance, ouvrez un projet qui s'y trouve, publiez le projet ouvert sur votre portail et travaillez dans la base PostgreSQL/PostGIS de l'instance.

Sa fenêtre compte cinq onglets.

En bas de la fenêtre, le Journal note chaque opération. Il se déplie d'un clic sur son titre, et de lui-même en cas d'erreur. Son bouton Copier place tout le journal dans le presse-papiers : c'est ce qu'il faut joindre à une demande au support.

LizPack Publisher est publié dans le dépôt officiel des extensions QGIS. Il s'installe et se met à jour depuis QGIS, comme toute autre extension.

1. Dans QGIS, ouvrez le menu Extensions, puis Installer/Gérer les extensions.
2. Dans l'onglet Toutes, cherchez LizPack.
3. Sélectionnez LizPack Publisher et lancez l'installation.
4. Ouvrez le plugin par son icône dans la barre d'outils Internet, ou par le menu Internet, sous-menu LizPack.

Il faut QGIS 3.16 au minimum. Le plugin n'ajoute aucune bibliothèque à votre installation de QGIS.

La page Plugins QGIS de la Marketplace présente le plugin, mais son bouton affiche Bientôt disponible : aucun fichier ne s'y télécharge. Passez par QGIS.

Le plugin utilise les identifiants de votre espace client : votre adresse e-mail et votre mot de passe. La connexion se fait en deux temps, dans l'onglet Connexion.

1. Saisissez votre e-mail et votre mot de passe, puis cliquez sur Se connecter. Cochez Se souvenir de mes identifiants pour ne plus les saisir : le mot de passe est confié au magasin d'authentification de QGIS, qui le chiffre.
2. Choisissez une instance dans la liste. Chacune affiche son état, par exemple En cours ou Arrêtée.
3. Cliquez sur Connecter à l'instance. La mention Instance connectée confirme la connexion, et l'onglet Projets affiche les fichiers de l'instance.

Seule une instance démarrée accepte la connexion : une instance Arrêtée se démarre d'abord depuis Instances, une instance suspendue pour abonnement se débloque en renouvelant l'abonnement. Une instance Suspendue (quota) reste joignable pour libérer de la place dans sa base, mais la publication, les envois de fichiers et les imports sont refusés.

Une fois connecté, et si votre plan donne accès à la base, le plugin ajoute à QGIS une connexion PostgreSQL au nom de LizPack suivi du nom de l'instance. Elle apparaît dans l'explorateur de QGIS après un clic droit sur PostgreSQL, puis Rafraîchir. Déconnexion la retire.

Les identifiants de la base, le quota et vos permissions sont lus à la connexion. Après un changement fait dans l'espace client, le bouton Rafraichir les relit sans vous déconnecter.

Les instances d'une équipe

Si vous êtes membre d'une équipe, une liste Espace apparaît au-dessus des instances : Mon compte, puis chaque propriétaire qui vous a invité, avec votre rôle. Vous y travaillez avec les droits qu'il vous a donnés. Sans le droit Gérer les fichiers, l'onglet Projets n'affiche aucun fichier et l'onglet Upload reste grisé ; l'onglet PostGIS reste disponible.

L'onglet Projets s'ouvre sur le Gestionnaire de fichiers : l'arborescence de l'instance, la même que celle de son gestionnaire de fichiers dans l'espace client. Un double-clic entre dans un dossier, ← Retour remonte d'un niveau.

Sous la liste, des icônes agissent dans le dossier affiché ; leur nom apparaît au survol : Nouveau dossier, Uploader des fichiers ici, Uploader un dossier ici, Supprimer la sélection, Renommer. Le clic droit propose les mêmes gestes, plus Copier et Couper, puis Coller ou Déplacer ici dans le dossier d'arrivée. Ctrl+clic sélectionne plusieurs éléments ; la suppression demande toujours confirmation.

Ouvrir un projet dans QGIS

Sélectionnez un fichier .qgs ou .qgz et cliquez sur Ouvrir, ou double-cliquez dessus. Le plugin demande où l'enregistrer sur votre poste, puis rapatrie tout le dossier du projet, sous-dossiers compris, pour que ses chemins relatifs restent valides. QGIS ouvre ensuite le projet, et ce dossier devient votre répertoire de travail.

Les couches PostGIS du projet sont rebranchées au passage sur l'adresse de la base joignable depuis votre poste, et le mot de passe de la base est confié au magasin d'authentification de QGIS. Pour un projet placé à la racine de l'instance, ouvrir revient à télécharger toute l'instance : le plugin demande confirmation avant.

L'onglet Upload

L'onglet Upload envoie un dossier entier : choisissez-le dans Dossier local, puis cliquez sur Uploader le dossier. Il arrive toujours à la racine de l'instance, sous son propre nom. Pour le placer ailleurs, utilisez plutôt Uploader un dossier ici depuis le dossier voulu.

La publication se fait dans l'onglet Projets, bloc Publier vers Lizmap. Elle envoie le projet ouvert dans QGIS, qu'il vienne de l'instance ou de votre poste.

1. Ouvrez ou enregistrez votre projet dans QGIS. Son nom s'affiche en face de Projet actif.
2. Dans la liste des fichiers, allez dans le dossier de destination. Le champ Destination propose ce dossier suivi du nom de votre projet. Un clic sur un fichier de la liste le remplace par celui-ci.
3. Facultatif : cliquez sur Valider le projet. Le serveur examine le projet sans rien publier, et son rapport s'ouvre dans l'onglet Valider un projet.
4. Cliquez sur Publier vers Lizmap. Le plugin enregistre le projet, puis l'envoie en une seule fois.

Partent avec le projet son fichier de configuration Lizmap (.qgs.cfg) s'il est à côté, et, pour un projet .qgs, les fichiers de données qu'il désigne par un chemin relatif ; un shapefile part avec ses fichiers compagnons. Les connexions PostGIS sont réécrites vers l'adresse interne de la base de l'instance. Le portail prend la nouvelle version en compte aussitôt.

Ne partent pas : les données désignées par un chemin absolu, et les données d'un projet .qgz, qui part seul avec sa configuration. Enregistrez le projet en .qgs avec des chemins relatifs, ou envoyez ses données à part.

Les contrôles avant l'envoi

Le serveur refuse un projet dans deux cas seulement : des couches dans des projections différentes, et des connexions PostgreSQL qui ne mènent pas à la base de l'instance. Pour les projections, le plugin propose de reprojeter les couches fichier avant l'envoi ; une copie est créée à côté de chaque fichier, les originaux restent intacts. Une couche PostGIS, elle, se reprojette dans la base.

Le plugin prévient aussi à partir de trois mises en page garnies : le serveur les relit toutes à chaque ouverture du projet, quelques secondes chacune, et la carte peut ne plus se charger. Le rapport de Valider un projet classe les autres signalements par gravité ; choisissez une ligne pour lire sa conséquence et sa solution. Ils dégradent la carte sans empêcher la publication. Le même contrôle existe dans l'espace client : voir Publier un projet.

L'onglet PostGIS travaille directement dans la base PostgreSQL/PostGIS de l'instance connectée. Il demande l'accès à la base, réservé au plan Pro et au-delà ; dans le compte d'une équipe, il faut aussi le droit Voir les bases de données. Sans cet accès, l'onglet affiche PostGIS non disponible pour cette instance.

Ajouter une table comme couche

Charger les tables liste les tables et vues de la base, avec leur schéma, leur colonne géométrique et leur SRID. Double-cliquez sur une table, ou sélectionnez-la et cliquez sur Ajouter à QGIS : elle arrive dans le projet comme couche. Une table sans géométrie arrive comme table attributaire.

Importer une couche dans la base

Le bloc Importer une couche dans PostGIS copie une couche vectorielle du projet dans la base. Choisissez la Couche QGIS, vérifiez le Schéma et le nom de la Table proposés, puis cliquez sur Importer dans PostGIS. La liste des tables se recharge à la fin.

Santé de la base

Diagnostiquer la base analyse la base sans rien y écrire : index spatiaux manquants, tables sans clé primaire utilisable, statistiques périmées, polygones trop détaillés. La colonne Correction dit ce que le plugin peut faire : Automatique, Sur confirmation ou À la main.

Tout optimiser n'applique que les corrections sans risque, comme un index ou des statistiques. Celles qui modifient une table se sélectionnent dans la liste et se lancent par Optimiser la sélection, après une confirmation qui détaille leur effet. Chaque correction appliquée laisse dans le journal la commande qui la défait. Exporter enregistre le diagnostic en CSV, ou en script SQL à rejouer.