diff --git a/doc/source/administrator/flux.md b/doc/source/administrator/flux.md deleted file mode 100644 index 584873582f576a298a651f2d0c5db5aa94db4109..0000000000000000000000000000000000000000 --- a/doc/source/administrator/flux.md +++ /dev/null @@ -1,47 +0,0 @@ -# Comment publier un flux WMS ou WFS - -Les flux WMS ou WFS permettent de rendre vos données cartographiques disponibles via un flux qui peut être utilisé dans différents logiciels comme QGIS. - -## Création d'un flux - -Pour créer un flux dans vMap2, naviguez vers Flux et publications puis flux. - -Assurez-vous de choisir un système de coordonnées identique à celui utilisé pour vos publications afin d'éviter des problèmes de re-projection. - -Après la création du flux, il est nécessaire de l'associer à des publications qui contiendront les données disponibles à travers ce flux. - -Après avoir ajouté vos publications, vous pouvez générer votre flux, ce qui produira une URL. - -***Notes:** _Si vous ajoutez une publication à un flux déjà généré, il est nécessaire de régénérer le flux pour que la nouvelle publication soit incluse._ - -## Création d'une publication - -La création d'une publication suit le même processus que la création d'une couche. - -Accédez à 'Sources de données' -> 'Postgresql', puis sélectionnez la table ou la vue qui servira de source pour votre publication. - -De manière similaire à la création d'une couche, vous procéderez ensuite à la création de la publication. - - - -Comme pour une couche, il est possible de définir la symbologie de votre publication en éditant sa symbologie. - -Enfin, vous pouvez accéder à toutes les publications déjà créées en naviguant dans le menu 'Flux et publications' -> 'Publications'. - -## Restreindre l'accès aux données du flux - -Comme décrit dans la section sur la gestion des droits utilisateurs, la visibilité des données dépend des droits accordés aux utilisateurs. - -Le même principe s'applique aux flux. Si l'utilisateur qui génère le flux possède les droits nécessaires pour accéder aux données des tables ou vues source des publications, il pourra alors visualiser les données cartographiques sans problème à travers le flux. - -Considérons deux scénarios distincts impliquant deux utilisateurs : Utilisateur_A et Utilisateur_B. - -Dans le premier scénario, l'Utilisateur_A crée une publication mais ne dispose pas des droits suffisants pour lire les données de la table ou vue qui est la source de sa publication. Si l'Utilisateur_B, qui utilise cette publication dans son flux, a les droits nécessaires pour accéder aux données de la source, alors les données cartographiques seront visibles dans son flux malgré les restrictions de l'Utilisateur_A. - -Dans le deuxième scénario, l'Utilisateur_A crée une publication et dispose des droits nécessaires pour lire les données de la source. Cependant, si l'Utilisateur_B, qui ajoute cette publication à son flux, ne possède pas les droits sur la source de la publication, il ne pourra pas visualiser les données cartographiques dans son flux, malgré les droits de l'Utilisateur_A. - -En résumé, la capacité à visualiser les données cartographiques dans un flux dépend directement des droits de l'utilisateur qui génère le flux, indépendamment des droits de celui qui a créé la publication originale. - -***Bonus** : Lorsque vous générez un flux, un fichier mapfile est créé et peut être modifié directement sur le serveur de vMap. Toutefois, lors de la régénération du flux, ce fichier mapfile sera remplacé par une nouvelle version. - -Pour accéder à ce mapfile, rendez-vous dans le dossier d'installation de vMap, puis suivez le chemin : vas/var/mapserver/wms_public. \ No newline at end of file diff --git a/doc/source/administrator/flux/flux.md b/doc/source/administrator/flux/flux.md new file mode 100644 index 0000000000000000000000000000000000000000..8399d930b2be3a794da910af19d0bc5012596a85 --- /dev/null +++ b/doc/source/administrator/flux/flux.md @@ -0,0 +1,71 @@ +# Publication d'un jeu de données sous forme de flux (WMS, WFS) + +La publication d'un jeu de données sous forme de flux, permet à l'administrateur de rendre disponible la données à partir d'un URL. Publiée et disponible sur le web, la donnée peut ainsi être exploitée par l'intermédiaire de logiciels tiers (exemple : Qgis) + +L'application vMap permet de publier des données sous forme de flux WMS et WFS. La documentation suivante détaille les différentes étapes pour publier une données sous forme de flux depuis vMap. + +## Etapes nécessaires à la publication d'un jeu de données + +La publication d'un jeu de données sous forme de flux WMS ou WFS dans vMap demande de réaliser 3 étapes : + 1- La mise en place de publication + 2- La création d'un flux + 3- L'association des publications à un flux. + +Ces trois étapes sont détaillées ci-dessous. + +```{Note} +Les étapes 1 et 2 peuvent être réalisées dans le sens inverse. +``` + + +## Création d'une publication + +La création d'une publication suit le même processus que la création d'une couche. + +Depuis le mode `Sources de données` de l'application, accéder à la données à publier (table, vue, vue matérialisée) en se déplaçant dans l'arborescence `PostgreSQL` de l'arbre. Cliquer droit sur la roue crantée à droite de `Publication` et `Ajouter une publication Postgres`. + + + +De la même manière que pour une couche, l'interface de vMap propose dans un premier temps définir certaines informations importantes de la publication (identifiant, champ géométrique, le système de coordonnées de la données source...), puis, une fois la publication créée, d'éditer sa symbologie depuis un studio entièrement en no-code. + + + + +Toutes les publications créées dans vMap peuvent être consultées et modifiées depuis le mode `Flux et publication` > `Publication` de l'application. + +## Création d'un flux + +Pour créer un flux dans vMap2, ajouter un nouveau flux depuis le mode `Flux et publication` > `flux` de l'application. + +A l'instar de la création d'une carte, l'application demande plusieurs paramètres importants : +- un nom +- De définir si le flux généré est de type WMS ou WFS. + +Une fois le flux créé, il n'est pas encore possible de générer l'URL de ce dernier tant qu'aucune publication ne lui a été associé (cf point suivant). + +## Association des publications à un flux. + +Une fois la création du flux réalisé, l'application permet à l'administrateur de lui associer des publications. +De la même manière comme pour une carte, vMap demande à l'administrateur de choisir quelles publications il souhaite rendre disponible dans son flux. + +Pour ce faire, se rendre dans la section `Publication`, `Ajouter une publication` et sélectionner les publications dans la liste des publications disponible. + +Lorsque la ou ou les premières publications sont ajoutées au flux, l'application permet de le générer (générer l'URL). + +Une fois l'URL générée, l'application permet d'obtenir le GetCapabilities du flux ainsi que le lien complet de l'URL qui peut être utilisées dans différents logiciels. + +```{Note} +L'ajout ou la suppression d'une publication d'un flux demande de relancer la génération du flux afin que le contenu de ce dernier soit actualisé. +``` + +## Accessibilité des données disponibles depuis un flux. + +Les données disponibles depuis les publications présentes dans un flux dépendent des droits de l'administrateur qui a généré le flux (cliqué sur le bouton `Générer le flux`). Cela signifie que bien qu'une publication soit présente dans un flux, si l'administrateur n'a pas les droits d'accès à la donnée, cette dernière ne sera pas disponible pour l'utilisateur final qui va l'utiliser. + +Explication : Considérons deux scénarii distincts impliquant deux utilisateurs : Utilisateur_A et Utilisateur_B. + +Scenario 1 : L'Utilisateur_A crée une publication mais ne dispose pas des droits suffisants pour lire les données de la table qui est la source de sa publication. L'utilisateur_B qui utilisera la publication (la couche) présente dans le flux ne verra aucune donnée. + +Scenario 2 : L'Utilisateur_A crée une publication et dispose de droits pour lire les données de la table qui est la source de sa publication. L'utilisateur_B qui utilisera la publication (la couche) présente dans le flux visualisera l'ensemble des données. + +En résumé, la capacité à visualiser les données cartographiques et attributaires d'une publication d'un flux dépend directement des droits de l'utilisateur qui génère le flux. \ No newline at end of file diff --git a/doc/source/administrator/index.rst b/doc/source/administrator/index.rst index 9f2904403cb81220d6864bf30a3655010a0d3c3b..186b69b3e4b5798543ca8568de5339f68adf014a 100644 --- a/doc/source/administrator/index.rst +++ b/doc/source/administrator/index.rst @@ -16,4 +16,4 @@ Il est conseillé aux administrateurs de consulter en premier la `Documentation api/api.rst journaux.md cadastre/index.rst - flux.md + flux/flux.md diff --git a/doc/source/images/administrator/flux/creation_flux.png b/doc/source/images/administrator/flux/creation_flux.png new file mode 100644 index 0000000000000000000000000000000000000000..09592864b9cd2edac02a6511319d04c93bb17ac8 Binary files /dev/null and b/doc/source/images/administrator/flux/creation_flux.png differ diff --git a/doc/source/images/administrator/flux/creation_publication.png b/doc/source/images/administrator/flux/creation_publication.png new file mode 100644 index 0000000000000000000000000000000000000000..3143a0ba2d69ff348857699738281582b3f08fae Binary files /dev/null and b/doc/source/images/administrator/flux/creation_publication.png differ diff --git a/doc/source/images/administrator/flux/flux_url_getcapabilities.png b/doc/source/images/administrator/flux/flux_url_getcapabilities.png new file mode 100644 index 0000000000000000000000000000000000000000..85eacc2635a8da2f97b1fc1ad48fd1c4b39aedfd Binary files /dev/null and b/doc/source/images/administrator/flux/flux_url_getcapabilities.png differ diff --git a/doc/source/images/administrator/flux/generation_flux.png b/doc/source/images/administrator/flux/generation_flux.png new file mode 100644 index 0000000000000000000000000000000000000000..4b2d1b8ed5d3368e337860539fa66c546c5064b1 Binary files /dev/null and b/doc/source/images/administrator/flux/generation_flux.png differ diff --git a/doc/source/images/administrator/flux/symbologie_publication.png b/doc/source/images/administrator/flux/symbologie_publication.png new file mode 100644 index 0000000000000000000000000000000000000000..9483e42fe8253b8dbbf13a78e05852191b787141 Binary files /dev/null and b/doc/source/images/administrator/flux/symbologie_publication.png differ