Ajout de documentation sur le filtrage des calques vMap

administration/developpement/filtres_couches.md

+# 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
+
+![](../../images/filtres_couches_1.jpg)
+
+En cliquant dessus le formulaire suivant est affiché dans une fenêtre modale
+
+![](../../images/filtres_couches_2.jpg)
+
+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:
+
+
+Sans filtre                              |  Avec filtre
+:---------------------------------------:|:---------------------------------------:
+![](../../images/filtres_couches_3.jpg)  |  ![](../../images/filtres_couches_4.jpg)
+
+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)"
+
+![](../../images/filtres_couches_5.jpg)
+
+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.
+
+![](../../images/filtres_couches_6.jpg)
+
+
+# Autres exemples d'utilisation des filtres dans vMap
+
+Section en cours de rédaction..