Stocker vos projets QGIS et autres fichiers

Afin que votre instance Lizmap puisse accéder à vos projets QGIS, vous avez accès à un espace de stockage sur nos serveurs pour y déposer vos fichiers.

Vous accédez à cet espace de stockage via le protocol FTP. Il comprend plusieurs répertoires prédéfinis :

Déposer des fichiers via FTP

Nous conseillons client FTP WinSCP pour Windows ou FileZilla si vous utilisez un autre système d’exploitation que vous pouvez télécharger sur leurs sites officiels :

Vous trouverez un petit guide pour renseigner et utiliser un client FTP :

Paramétrage de votre client FTP :

  • TLS est activé sur nos serveurs FTP, donc utilisez une connection FTP explicite sur TLS. L’échange de donnée est ainsi chiffré. Choisissez bien une connexion explicite plutôt que implicite car cette dernière impose d’utiliser des ports réseaux qui ne sont pas ouvert sur nos serveurs.

  • Le protocole SFTP n’est pas pris en charge.

  • Configurer une authentification avec le login et mot de passe que l’on vous a fourni.

  • Mode de transfert passif, actif ou automatique.

Si vous avez des difficultés pour vous connecter, et si vous êtes sur un réseau filtré, derrière un proxy ou un pare-feux, vous devez vérifier que ce dernier soit bien configuré.

En effet, FTP possède deux modes de transferts, passif ou actif, qui nécessitent une configuration particulière de votre pare-feux :

  • Le mode actif nécessite que le port 21 soit ouvert en sortie (vers l’extérieur), et que le port 20 soit ouvert en entrée.

  • Le mode passif nécessite que les ports 21, et 5700 à 5900 soient ouverts en sortie. C’est en général le mode le plus approprié et accepté par les pare-feux, le port 20 étant rarement ouvert.

Dans votre logiciel FTP, il faut donc choisir l’un des deux modes en fonction des ports ouverts. Si vous ne savez pas, essayez le choix « automatique », si il existe. Le logiciel essaiera les deux méthodes.

Stockage des projets QGIS

Vous devez organiser vos fichiers en suivant les recommandations de la documentation Lizmap, à savoir que dans le répertoire QGIS, vous devez avoir un ou plusieurs répertoires où doivent être stockés les fichiers qgs et qgs.cfg, ainsi que les différents fichiers attenants (sources de données, fichiers geojson, css etc..).

Exemple d’arborescence dans votre espace de stockage :

qgis/
   rep1/
     projet1.qgs
     projet1.qgs.cfg
     projet2.qgs
     projet2.qgs.cfg
   rep2/
     projet3.qgs
     projet3.qgs.cfg

Utilisation de fichiers SVG dans vos projets QGIS

Il est possible d’utiliser des images au format SVG dans vos projets QGIS. Pour cela il existe plusieurs techniques avec des avantages/inconvénients.

Certaines techniques fonctionnent parfaitement dans certains contextes de QGIS, mais, de temps en temps, QGIS serveur peut avoir un bug pour rendre graphiquement un SVG dans certain contexte : carte, légende de la carte principale, légende ou logo dans une mise en page.

La technique du dossier centralisé est à privilégier uniquement si les techniques précédentes ne conviennent pas.

1. SVG embarqué

Il est possible d’utiliser de mettre un SVG embarqué. C’est très simple et rapide d’utilisation mais le fichier est embarqué dans le projet en lui même.

2. Fichier dans le dossier “media”

  1. Stockez vos fichiers dans un sous-dossier du répertoire media (que vous devez créer manuellement, suivant la documentation Lizmap). Le nommage du sous-dossier est libre.

  2. Dans QGIS, utiliser le fichier qui est dans ce sous-dossier de media

  3. Assurez vous de bien envoyer l’arborescence des fichiers sur votre serveur

Astuce

Uniquement pour du debug, dans le fichier QGIS, il doit y avoir un chemin relatif depuis le projet concernant l’utilisation de l’image, contenant media/.

3. Dossier centralisé de SVG

QGIS permet de définir un dossier centralisé au niveau global de QGIS permettant d’avoir un « librairie » qui centralise les SVG. Cette manière est plus complète mais nécessite une mise en place du dossier en local sur QGIS bureautique.

Sur notre hébergement, vous avez un dossier pouvant contenir des SVG pour chaque instance Lizmap. Vous trouverez ce dossier dans :file:qgis/resources/, puis il s’agit du dossier commençant par svg_.

Exemple : :file:qgis/resources/svg_1234. Le suffixe 1234 est aléatoire et unique pour chaque instance.

Avertissement

Vous ne devez pas ni changer ce nom, ni supprimer le répertoire.

Pour pouvoir utiliser des SVG dans vos projets avec ce dossier, il va falloir créer ce dossier centralisé en local sur votre votre QGIS bureautique.

Prenons comme exemple un dossier dont le nom est svg_1234 :

  1. Récupérer une première fois via FTP le répertoire resources et son contenu, en particulier le répertoire commençant par svg_. Mettre ce répertoire resources au même niveau que les autres répertoires de projets pour avoir la même arborescence que celle du serveur.

  2. Dans QGIS, aller dans Préférences ‣ Options ‣ Système, et ajouter le dossier resources comme dossier de SVG. Attention, ne pas ajouter l’un des sous répertoires de resources, mais bien le répertoire resources lui même.

  3. Stockez vos fichiers SVG dans ce répertoire resources/svg_1234

  4. Dans le projet QGIS, au niveau de la configuration de la symbologie des couches, utilisez les SVG de resources/svg_1234. Puis enregistrer le projet.

  5. Envoyer vos projets et le contenu de resources/svg_1234 sur votre serveur Lizmap via FTP. Vous devriez pouvoir voir vos SVG dans vos cartes dans Lizmap.

Astuce

Uniquement pour du debug, si cela ne semble pas fonctionner, vous pouvez vérifier le contenu fichier QGIS. Si vous ouvrez le projet QGIS dans un éditeur de texte, vous devriez trouver des lignes comme <Option type="QString" value="svg_1234/image.svg" name="name"/>. La valeur de value doit commencer par svg_1234/.