diff --git a/administration/guide_developpeur/filtres_couches.md b/administration/guide_developpeur/filtres_couches.md new file mode 100644 index 0000000000000000000000000000000000000000..2f03d88a0e8c2b17f8f62c26061043319d5d8673 --- /dev/null +++ b/administration/guide_developpeur/filtres_couches.md @@ -0,0 +1,54 @@ +# Filtres sur les couches + +Il est possible d'ajouter des formulaires de filtre sur les couches dans le but de visualiser certaines données uniquement. +Alors les utilisateurs du mode cartographique auront accès à un bouton faisant apparaître le formulaire de filtrage, sur la carte "Carte de France" créée par défaut lors de l'installation de l'application un filtre est mis en place à titre d'exemple. + +Sur la couche "Commune" un bouton de filtre apparaît + + + +En cliquant dessus le formulaire suivant est affiché dans une fenêtre modale + + + +L'utilisateur peut alors filtrer la couche pour afficher uniquement les communes ayant une population comprise dans la fourchette saisie par l'utilisateur, ainsi si on saisit 50000 à "Population suppérieure à" nous obtenons la carte suivante: + +<img src="../../images/filtres_couches_3.jpg" width="45%" /> <img src="../../images/filtres_couches_4.jpg" width="45%" /> + +Pour ce faire il faudra effectuer plusieurs étapes détaillées ci-dessous. + +## 1 - Écrire le filtre sur la couche Mapserver + +Après avoir saisit le filtre, vMap va ajouter aux URL permanentant de récupérer les tuiles les paramètres saisis, dans le module Mapserver il est possible de récupérer et d'utiliser ces valeurs. Bien évidemment cette opération est également fonctionnelle si vous utilisez un autre générateur de flux WMS. + +Sur le module Mapserver il faudra se rendre dans la définition de la couche pour y renseigner un filtre, nous allons détailler l'exemple des communes, mais si vous voulez plus de détails vous trouverez toute l'information disponible sur la documentation Mapserver http://mapserver.org/fr/cgi/runsub.html#filters + +Dans notre exemple voici ce qui est écrit: +``` +FILTER ([pop90] > '%pop90_sup%' and [pop90] < '%pop90_inf%') +VALIDATION + 'pop90_sup' '^[0-9]*$' + 'default_pop90_sup' '0' + 'pop90_inf' '^[0-9]*$' + 'default_pop90_inf' '100000000' +END +``` + +**Dans la balise FILTER** on écria la condition à respecter, les noms des colonnes devrons être écrites entre crochets ex: [pop90] et les noms des attributs récupérés à travers le l'URL (c'est à dire le formulaire de filtre) devront être écris entre pourcentages ex: %pop90_sup% + +**La balise VALIDATION est obligatoire** et on doit y écrire pour chaque attribut récupéré à travers l'URL (c'est à dire le formulaire de filtre) une expression régulière empéchant les personnes mal intentionnées de faire des injections SQL, dans notre exemple nous avons écrit '^[0-9]\*$' ce qui signifie autant de chiffres entre 0 et 9 que souhaité. **Pour que la carte affiche des valeurs lorsque les filtres sont vides** il faudra définir des valeurs par défaut en écrivant default_[nom de votre attribut], dans notre exemple par défaut la carte filtre les villes entre 0 et 100000000 d'habitants. + +## 2 - Mettre en place un formulaire de filtre + +Pour mettre en place le formulaire il faudra aller dans la partie **calques** et mettre Oui à "Calque filtrable (Mapserver)" + + + +Après avoir mis à jour le calque, une nouvelle section "Formulaire de filtre" va apparaître dans lequel vous pourrez mettre en place votre filtre. + + + + +# Autres exemples d'utilisation des filtres dans vMap + +Section en cours de rédaction.. diff --git a/administration/guide_developpeur/index.rst b/administration/guide_developpeur/index.rst index 60b6868369eb5236ff148a89b26e6bdb4332c56b..7a02812c71e5ca13a2b2a0be9284785631ae8a4f 100644 --- a/administration/guide_developpeur/index.rst +++ b/administration/guide_developpeur/index.rst @@ -7,4 +7,5 @@ Guide du développeur ../../../doc_module_studio/utilisation/index.rst web_services + filtres_couches exemples_objets_metier diff --git a/images/filtres_couches_1.jpg b/images/filtres_couches_1.jpg new file mode 100644 index 0000000000000000000000000000000000000000..59bac453941a3755e2595d5a2eb08338b7787ef6 Binary files /dev/null and b/images/filtres_couches_1.jpg differ diff --git a/images/filtres_couches_2.jpg b/images/filtres_couches_2.jpg new file mode 100644 index 0000000000000000000000000000000000000000..7cc2f3aa9ebb91ee2efdb0b6d3f8867d1620423f Binary files /dev/null and b/images/filtres_couches_2.jpg differ diff --git a/images/filtres_couches_3.jpg b/images/filtres_couches_3.jpg new file mode 100644 index 0000000000000000000000000000000000000000..8beb4ed64c94b35e83929e02b7227315b7918e5a Binary files /dev/null and b/images/filtres_couches_3.jpg differ diff --git a/images/filtres_couches_4.jpg b/images/filtres_couches_4.jpg new file mode 100644 index 0000000000000000000000000000000000000000..4150ad38a7d6d8d11bf93c10ad142e952fcf6e09 Binary files /dev/null and b/images/filtres_couches_4.jpg differ diff --git a/images/filtres_couches_5.jpg b/images/filtres_couches_5.jpg new file mode 100644 index 0000000000000000000000000000000000000000..00f33e273f24371f6ca37b7e5d66263cee3bb667 Binary files /dev/null and b/images/filtres_couches_5.jpg differ diff --git a/images/filtres_couches_6.jpg b/images/filtres_couches_6.jpg new file mode 100644 index 0000000000000000000000000000000000000000..370ddaecb20ac758eebcb1a954daf60d4c77d83d Binary files /dev/null and b/images/filtres_couches_6.jpg differ