Démarrage rapide

Il s’agit d’un guide de démarrage rapide pour vous aider à publier votre premier jeu de données sur Lizmap avec quelques connaissances.

Installation de l’extension Lizmap sur QGIS bureautique

Pour publier un projet QGIS dans Lizmap Web Client, vous avez besoin d’un fichier de configuration Lizmap, avec l’extension .qgs.cfg. Ce fichier est automatiquement généré par l’extension Lizmap de QGIS bureautique.

  1. Menu ‣ Extensions ‣ Installateur d’extensions python

  2. Rechercher Lizmap

  3. Cliquer sur l’extension

  4. Cliquer sur le bouton Installer

  5. Il se trouve ensuite dans le menu Internet et la barre de menu Internet

  6. Cliquer sur le bouton Lizmap Logo Lizmap

  7. Suivre l’assistant pour ajouter le premier serveur

Installation de l'extension Lizmap dans le gestionnaire des extensions de QGIS

Préparer l’organisation des fichiers

Lizmap Web Client doit avoir la même architecture de fichiers et de répertoires sur le serveur que sur votre ordinateur local.

Astuce

Il est important de garder à l’esprit que le serveur QGIS ouvrira votre projet avec les mêmes chemins de fichiers que sur votre QGIS bureautique. Toutes vos données doivent se trouver dans un dossier qui peut être transféré.

Astuce

custom_repository est un dossier représentant un thème commun. Le dossier contiendra un ou plusieurs projets QGIS, appartenant à ce thème. Le nom du thème affiché sur l’interface web sera configuré plus tard. Vous devez utiliser un nom « machine ».

Vous êtes libre de renommer ce dossier avec un nom différent, représentant votre propre thème.

Dans ce dossier, nous stockerons tous les projets liés à Urbanisme et aménagement du territoire au cours de ce tutoriel.

Nous allons créer une structure de dossiers pour faciliter le transfert sur le serveur par la suite :

  1. Sur votre ordinateur, créez un dossier local lizmap.

  2. Créer dans le dossier lizmap un dossier media.

  3. Créer dans le dossier lizmap un dossier custom_repository.

  4. Créer dans le dossier lizmap/custom_repository un dossier media.

  5. Créer dans le dossier lizmap/custom_repository un dossier data.

  6. Copier dans le dossier lizmap/custom_repository/data les données géographiques à publier (FlatGeoBuf, GeoJSON, SHP, autres fichiers)

Vous devriez avoir cette arborescence sur votre ordinateur :

lizmap/
+- media/
+- custom_repository/
   +- media/
   +- data/
      +- geo-data.fgb
      +- your-geo-data.shp
      +- your-geo-data.shx
      +- your-geo-data.dbf
      +- your-geo-data.prj

Astuce

Vous pouvez changer les noms de ces répertoires sauf pour media, qui est un mot-clé spécial pour Lizmap. Lisez plus tard le chapitre sur Média.

Préparation du projet QGIS

  1. Dans QGIS bureautique, chargez les données du dossier lizmap/custom_repository/data

  2. Sauvegardez le projet QGIS dans lizmap/custom_repository avec l’extension .qgs. Par exemple mon-premier-lizmap.qgs.

  3. Préparer le rendu des données :

    • ordre des couches

    • groupes dans la légende

    • symbologie

    • étiquettes, etc.

  4. Dans Propriétés du projet ‣ QGIS Server ‣ Capacité des services, remplissez quelques métadonnées :

    • Titre, le titre principal qui sera affiché dans la page d’accueil. Utilisez un titre humain avec des espaces et des accents.

    • Résumé, un paragraphe complet pour la description. Le HTML est pris en charge.

    • Mot-clés, quelques mots-clés séparés par une virgule. Ils seront utilisés par la barre de recherche.

Vous devriez avoir cette arborescence sur votre ordinateur :

lizmap/
+- media/
+- custom_repository/
   +- media/
   +- data/
      +- your-geo-data.shp
      +- your-geo-data.shx
      +- your-geo-data.dbf
      +- your-geo-data.prj
      +- other-geo-data.fgb
   +- my-first-lizmap.qgs
   +- my-first-lizmap.qgs.cfg
L'arborescence des fichiers dans ce tutoriel

Générer le fichier de configuration de Lizmap

  1. Cliquer sur le bouton Lizmap Logo Lizmap

  2. Cliquez sur l’onglet Couches.

  3. Pour chaque couche :

    1. Définissez un titre humain personnalisé pour votre couche, qui sera affiché dans la légende.

    2. Par défaut, les couches sont publiés mais ne sont pas visibles dans Lizmap Web Client lorsque nous ouvrons le projet en ligne. Cliquez sur Coché pour rendre la couche visible par défaut.

  4. Cliquez sur Ok

A côté de my-first-lizmap.qgs, vous devez maintenant trouver un nouveau fichier my-first-lizmap.qgs.cfg.

Envoyez vos fichiers sur votre serveur Lizmap

Lorsque votre carte est prête, vous devez envoyer tous les fichiers et dossiers sur le serveur.

Astuce

Avec l’aide de votre administrateur système ou du fournisseur de l’instance Lizmap, vous devez vérifier :

  • comment transférer des fichiers sur le serveur

  • le dossier sur le serveur utilisé pour héberger les répertoires Lizmap.

Exemple d’une instance hébergée sur Lizmap Cloud Logo Lizmap Cloud, vous devriez avoir cette arborescence sur le serveur, dans le dossier qgis :

cog/
qgis/
+- media/
+- custom_repository/
   +- media/
   +- data/
      +- your-geo-data.shp
      +- your-geo-data.shx
      +- your-geo-data.dbf
      +- your-geo-data.prj
      +- other-geo-data.fgb
   +- my-first-lizmap.qgs
   +- my-first-lizmap.qgs.cfg
web/

Permettre à votre dossier d’être publié en ligne

Par défaut, le dossier nouvellement créé custom_repository situé sur le serveur n’est pas publié publiquement sur la page d’accueil de Lizmap.

Vous devez activer le dossier distant, pour qu’il soit reconnu comme un répertoire Lizmap.

  1. Accédez à l’interface d’administration de Lizmap dans votre navigateur web

  2. Cliquez sur Gestion des cartes et ensuite sur Ajouter un répertoire

  3. Remplir le formulaire :

    1. Remplissez le Chemin vers le répertoire local avec le chemin vers custom_repository.

      • Soit il peut s’agir d’un menu déroulant si un dossier racine est configuré par l’administrateur (solution recommandée)

      • Il peut également s’agir d’une entrée de texte. Vous devez indiquer un chemin absolu vers le dossier

    2. Mettre à jour le Nom affiché avec le nom à afficher sur la page de d’accueil, par exemple Urbanisme et aménagement, les accents et les espaces étant recommandés.

    3. Mettre à jour le ID si besoin, c’est un identifiant interne pour Lizmap. Il est principalement visible dans l’URL du projet. Cet identifiant ne peut pas être modifié ultérieurement.

    4. Cliquez sur les cases de permission que vous souhaitez modifier. Pour les débutants, nous vous suggérons de laisser celles qui sont cochées par défaut.

    5. Cliquez sur Enregistrer

Votre dossier custom_repository devrait maintenant être reconnu comme un répertoire Lizmap valide.

Visitez votre page d’accueil et vous devriez voir votre projet et vous pouvez maintenant afficher le projet QGIS en ligne.

Bien joué.

Astuce

Le dossier custom_repository peut contenir autant de projet QGIS que vous le souhaitez avec leur fichier .qgs.cfg correspondant. Tous les projets seront listés horizontalement sur la page d’accueil.

Astuce

Si vous créez un autre dossier à côté de custom_repository, comme foret avec un nom publié Sylviculture, votre dossier sera listé verticalement.

Astuce

Dans votre page d’administration, visitez la page Projets QGIS pour avoir une vue d’ensemble de tous vos répertoires Lizmap et des métadonnées sur les projets QGIS.

Aller plus loin

C’est la fin de ce guide de démarrage rapide, nous vous encourageons à lire plus en détail la documentation sur d’autres sujets, tels que :

Example des répertoires Lizmap

Pour comprendre comment les projets sont listés verticalement et horizontalement, jetons un œil sur le site web de démonstration.

Si vous regardez attentivement, vous pouvez voir qu’il y a des répertoires Lizmap tels que :

  • Features contient par exemple :

    • Cats : cats.qgs et cats.qgs.cfg

    • Landuse : landuse.qgs et landuse.qgs.cfg

    • Action and SQL : action.qgs et action.qgs.cfg

  • Modules :

    • PgMetadata

    • PgRouting

Il est important de noter qu’un répertoire Lizmap peut contenir un ou plusieurs fichiers QGS.

  • Les projets QGIS, dans un même dossier, sont affichés horizontalement.

  • Les répertoires sont affichés verticalement sur la page d’accueil.

Un sous-ensemble de l'arborescence des fichiers sur https://demo.lizmap.com