|Documentation

Gestion des fichiers

Le gestionnaire de fichiers

Chaque instance a son espace de fichiers : vos projets QGIS, leur configuration Lizmap et les données qu'ils utilisent. Le gestionnaire de fichiers le montre dans le navigateur. Ouvrez-le depuis la fiche de l'instance, sur la page Instances, avec le bouton Fichiers.

Le gestionnaire de fichiers : en haut, le chemin du dossier ouvert (ici Racine), la recherche et l'espace occupé ; dessous, la barre d'actions ; puis le contenu, avec une case et un menu par ligne. La taille d'un dossier est celle de son contenu.

En haut : Retour au dossier parent et le chemin du dossier ; à droite, Filtrer ce dossier…, Rafraîchir, le passage de la Vue liste à la Vue grille et la place utilisée par votre compte. Dessous, la barre d'actions reste toujours affichée : Envoyer et Nouveau dossier, puis, pour la sélection, son nombre, Télécharger, Renommer et Supprimer, grisés tant que rien n'est sélectionné. Les trois points, Plus d'actions, proposent Ouvrir, Copier, Couper, Coller, Vers la base pour un GeoPackage et Valider le projet. Un projet QGIS sélectionné ajoute à la barre Ouvrir la carte, qui ouvre sa carte Lizmap dans un nouvel onglet, et Valider le projet ; l'icône d'un projet publié ouvre aussi sa carte d'un clic. Sécurité, à côté de la recherche, règle les protections de l'instance : Protection contre la suppression et Protéger les projets QGIS.

Double-cliquez sur un dossier pour l'ouvrir, sur un fichier pour le télécharger. Le chemin ramène d'un clic à n'importe quel dossier parent. La case d'une ligne la sélectionne ; celle de l'en-tête sélectionne tout. Les trois points au bout d'une ligne, le clic droit ou un appui long sur écran tactile ouvrent le menu de ses actions ; Rafraîchir relit le dossier, par exemple après un dépôt fait depuis QGIS.

Envoyer des fichiers

  1. Ouvrez le dossier de destination.
  2. Cliquez sur Envoyer, ou choisissez Envoyer des fichiers dans le menu du clic droit. La fenêtre Envoyer s'ouvre.
  3. Envoyer un dossier envoie un dossier entier, sous-dossiers compris ; Envoyer des fichiers envoie un ou plusieurs fichiers.

Si un élément du même nom existe déjà, la fenêtre Fichiers existants vous demande s'il faut le remplacer. La fenêtre de suivi montre ensuite l'envoi, le traitement par le serveur, puis le résultat. Les fichiers refusés y sont listés avec leur motif : voir ce qui est refusé.

Un envoi plus court

  • Un fichier déjà à jour sur l'instance, de même taille et pas modifié depuis, n'est pas renvoyé : renvoyer le dossier d'un projet où seul le projet a changé ne prend que quelques secondes.
  • Un GeoPackage modifié n'envoie que les parties qui ont changé : corriger quelques entités d'un fichier de 300 Mo n'envoie que quelques Mo.
  • GeoPackage, Shapefile et CSV sont compressés pendant l'envoi : deux à trois fois moins de données sur votre connexion.
  • Une coupure de connexion ne fait pas tout recommencer : l'envoi reprend de lui-même. Si la page a été fermée, renvoyez les mêmes fichiers : ce qui était déjà arrivé n'est pas renvoyé.
  • Vous pouvez quitter le gestionnaire pendant un envoi : il continue, et un indicateur en bas de l'écran suit sa progression. Ne fermez pas l'onglet avant la fin.

Depuis un lien

Pour un gros fichier, sur une connexion lente, déposez-le d'abord sur Google Drive ou Dropbox, partagez-le publiquement, puis collez son lien dans Depuis un lien, au bas de la fenêtre Envoyer, et cliquez sur Importer. Le serveur de votre instance télécharge lui-même le fichier, bien plus vite que votre connexion ne l'enverrait. Un dossier Google Drive partagé s'importe tout entier, sous-dossiers compris ; une adresse directe de fichier convient aussi. Selon l'instance, cette option peut ne pas être proposée.

Un projet QGIS ne s'importe pas depuis un lien : il doit être vérifié à l'envoi. Dans un dossier importé, les projets sont laissés de côté et listés à la fin : envoyez-les ensuite avec Envoyer des fichiers, ou depuis QGIS avec l'extension. Ils ne pèsent que quelques Ko.

Le stockage

Le bas de la page indique le nombre d'éléments du dossier ; en haut, à côté de la recherche, s'affiche votre stockage utilisé, rapporté à la limite de votre plan. Un envoi qui ne tient pas dans la place restante est refusé avant de commencer, et une fenêtre propose de passer à un plan supérieur. Quand votre quota est dépassé, le gestionnaire reste ouvert pour faire de la place, mais les envois sont bloqués : voir les quotas.

Un membre de votre équipe n'ouvre le gestionnaire que s'il a la permission Gérer les fichiers.

Copier, déplacer, renommer, supprimer

Cliquez sur un élément, ou cochez sa case, pour le sélectionner. Ctrl, ou Cmd sur Mac, ajoute un élément à la sélection ; Maj sélectionne une plage. Les actions portent sur toute la sélection.

ActionCommentCe qui se passe
CopierCopier puis Coller dans le dossier voulu, ou Ctrl+C puis Ctrl+V.Si le nom est déjà pris, la copie reçoit le suffixe - copie. La copie est refusée si elle dépasse votre stockage.
DéplacerCouper puis Coller, ou Ctrl+X puis Ctrl+V. Vous pouvez aussi glisser les éléments sur un dossier, ou sur un dossier du chemin.Si la destination contient déjà ces noms, la fenêtre Éléments existants propose Remplacer.
RenommerRenommer dans la barre d'actions ou le menu, ou F2.Un seul élément à la fois. Le nouveau nom ne doit pas être déjà pris dans le dossier.
TéléchargerTélécharger dans la barre d'actions ou le menu, ou double-clic sur un fichier.Un dossier, ou plusieurs éléments, arrivent dans une archive ZIP. Si l'instance protège ses projets QGIS, un fichier .qgs ou .qgz marqué Protégé ne se télécharge pas et reste hors de l'archive.
SupprimerSupprimer dans la barre d'actions ou le menu, ou la touche Suppr.Après confirmation, les éléments sont effacés, avec tout le contenu des dossiers.

Un projet publié tient en deux fichiers, le projet et son .qgs.cfg, qui portent le même nom. Renommer ou déplacer l'un sans l'autre retire le projet de votre portail.

Une suppression libère la place aussitôt, et votre utilisation est recalculée dans les secondes qui suivent. Si vous étiez au-delà de votre quota, vos instances redémarrent d'elles-mêmes une fois revenues sous la limite.

Une suppression est définitive : il n'y a pas de corbeille. Gardez une copie de vos projets et de vos données sur votre poste.

Ce qui est accepté, ce qui est refusé

Le gestionnaire accepte tous les types de fichiers, sauf ceux qui pourraient s'exécuter sur le serveur. Ceux-ci sont refusés, quel que soit leur contenu :

  • programmes et installateurs : .exe, .dll, .so, .msi, .deb, .rpm, .dmg ;
  • scripts et code source : .sh, .bat, .cmd, .ps1, .py, .js, .ts, .php, .rb, .pl, .java, .jar, .c, .cpp, .cs, .go, .rs, .lua, .r et les autres langages courants ;
  • scripts SQL : .sql ;
  • fichiers de configuration système : .ini, .conf, .env, .htaccess, .htpasswd.

Avant l'envoi, la fenêtre Fichiers non autorisés liste ceux qui seront écartés et propose de continuer avec les autres. Pour charger un script SQL dans la base, passez par vos propres outils : voir se connecter à la base.

Une archive ZIP n'est pas décompressée : elle est enregistrée telle quelle, et un projet qu'elle contient n'est pas publié. Envoyez plutôt le dossier du projet avec Envoyer un dossier.

Les contrôles sur les projets QGIS

Chaque projet QGIS déposé est examiné avant d'être enregistré, et deux défauts le font refuser :

  • des couches dans des systèmes de coordonnées différents : chaque couche divergente serait reprojetée à chaque affichage, pour chaque visiteur. Enregistrez vos couches dans une projection unique ; les fonds de carte ne comptent pas ;
  • des connexions PostgreSQL qui visent une autre base que celle de l'instance. Le motif du refus rappelle l'adresse, la base et le port attendus, ceux de la fiche de l'instance.

Un projet accepté peut recevoir des remarques, sur une couche qui rendra la carte lente par exemple. Elles ne bloquent rien et s'affichent dans la fenêtre de suivi.

Examiner un projet sans le publier

Valider le projet, sous Plus d'actions dans la barre d'actions, ouvre la page Validation de projet. Si le dossier affiché contient un seul projet .qgs, il est analysé aussitôt ; sinon la page vous laisse choisir. Le rapport applique les mêmes contrôles que le dépôt, classe les constats par gravité et s'exporte en CSV ou en JSON. Rien n'est écrit sur l'instance.

Organiser un projet publié

Le portail publie les projets qu'il trouve dans l'espace de fichiers de l'instance. L'organisation qui évite les surprises :

  • un dossier par projet, plutôt que tout à la racine ;
  • dans ce dossier, le projet (.qgs ou .qgz) et son .qgs.cfg, de même nom : voir les deux fichiers d'un projet ;
  • à côté, les fichiers de données du projet, dans les mêmes positions relatives que sur votre poste, pour que les chemins enregistrés dans le projet restent valables ;
  • les données volumineuses ou partagées entre projets dans la base de l'instance plutôt qu'en fichiers.

Le plus simple est d'envoyer le dossier du projet tel qu'il est sur votre poste, avec Envoyer un dossier : la structure est conservée. Un chemin qui désigne votre disque, comme C: ou /home, ne mène à rien sur le serveur ; le rapport de validation le signale. L'extension LizPack Publisher envoie aussi le projet et ses données depuis QGIS.

Passer un GeoPackage dans la base

Un GeoPackage déposé peut être chargé dans la base de l'instance. Sélectionnez-le, puis choisissez Vers la base sous Plus d'actions, les trois points de la barre d'actions, ou Transférer vers la BD dans le menu du clic droit. Ce transfert est réservé au plan Pro et au-delà.

  1. Dans la fenêtre Transférer vers la base de données, choisissez le Schéma de destination parmi ceux de l'instance.
  2. Les couches du GeoPackage sont comparées au schéma. Les nouvelles seront importées. Pour une couche déjà présente, cochez Tronquer et remplacer si ses données actuelles doivent être effacées et remplacées ; sinon elle est ignorée.
  3. Cliquez sur Transférer.

Le transfert se poursuit sur le serveur : vous pouvez fermer la fenêtre sans l'interrompre. Un message en donne le bilan : couches importées, remplacées et ignorées.