Merge branch '1339-documentation-generer-un-flux-wms-ou-wfs'

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

@@ -18,3 +18,4 @@ Il est conseillé aux administrateurs de consulter en premier la `Documentation
    api/api.rst
    journaux.md
    cadastre/index.rst
+   flux/flux.md