Màj doc flux et publication

Màj doc flux et publication

doc/source/administrator/flux.md

-# 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.
-
-![publicactions](../images/administrator/flux/publication.png)
-
-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

doc/source/administrator/flux/flux.md

+# 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`.
+
+![creation publication](../../images/administrator/flux/creation_publication.png)
+
+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.
+
+![symbologie publication](../../images/administrator/flux/symbologie_publication.png)
+
+
+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

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