Widget Filtrer

Le widget Filter (Filtrer) permet de limiter la visibilité des entités d’une ou de plusieurs couches à celles qui remplissent les critères de l’expression. Les modifications apportées à un widget Filter (Filtrer) affectant les données de votre application, les autres widgets qui utilisent les mêmes couches sont filtrés en conséquence.

Exemples

Utilisez ce widget pour prendre en charge les exigences de conception d’application, telles que les suivantes :

• Vous disposez d’un jeu de données volumineux et souhaitez proposer à différents publics des options appropriées qui leur permettront de filtrer les données en fonction de critères importants pour eux.
• Vous souhaitez autoriser les utilisateurs à modifier la visibilité des entités dans tous les widgets qui utilisent la même couche dans votre application.

Remarques sur l'utilisation

Le widget Filter (Filtrer) requiert la définition d’une source de données pour chaque filtre que vous ajoutez. Chaque filtre peut être activé ou désactivé par les utilisateurs finaux pour contrôler la visibilité des entités. Lorsque vous configurez plusieurs filtres pour ce widget, vous pouvez indiquer si tous les filtres activés ou un seul d’entre eux doivent renvoyer la valeur vrai pour afficher les données.

Paramètres

Le widget Filter (Filtrer) inclut les paramètres suivants :

• New filter (Nouveau filtre) : créez un filtre en sélectionnant une source de données et en ajoutant des expressions. Le panneau Create new filter (Créer un nouveau filtre) qui s’ouvre inclut les propriétés suivantes :
  • Data (Données) : sélectionnez les données à filtrer. Vous ne pouvez sélectionner qu’une source de données par filtre. Les couches d'entités, les couches d'entités dans des cartes Web sélectionnées et les URL de service d’entités sont prises en charge.
  • Label (Étiquette) : personnalisez le nom de chaque filtre.
  • Icon (Icône) : sélectionnez d’autres icône et couleur pour chaque filtre.
  • SQL Expressions (Expressions SQL) : créez des expressions SQL pour spécifier les critères de filtre. Le générateur d’expressions SQL offre plusieurs options permettant de créer des requêtes complexes et interactives.
  • Options (Options) : vous pouvez activer les options suivantes pour chaque filtre :
    • Apply this filter automatically (Appliquer ce filtre automatiquement) : lorsque les utilisateurs ouvrent l’application, ce filtre est déjà appliqué aux données. Ils peuvent le désactiver dans le widget.
    • Collapse filter details (if any) automatically (Réduire automatiquement les détails éventuels du filtre) : si le filtre est configuré pour demander des valeurs, les utilisateurs doivent cliquer pour développer le filtre et afficher les détails supplémentaires. (Activez cette option pour une vue claire si vous avez un grand nombre de filtres.)
• Lorsque vous ajoutez plusieurs filtres, cliquez sur AND (ET) pour indiquer que tous les critères de filtre doivent être vérifiés ou sur OR (OU) pour indiquer que tout critère de filtre peut être vérifié.

Générateur d’expressions SQL

Un filtre utilise des expressions logiques pour rechercher et afficher les entités d’une couche en fonction de valeurs attributaires dans ses données. Les expressions utilisent le format général <Nom du champ> <opérateur qui spécifie une condition> <Valeur ou Champ>. Par exemple, la valeur « Shelter capacity » est supérieure à 200.

Pour créer des expressions dans le SQL Expression Builder (Générateur d’expressions SQL), cliquez sur Add clause (Ajouter une clause) ou Add clause set (Ajouter un jeu de clauses).

L’expression de chaque clause inclut les zones de saisie suivantes :

• Field (Champ) : sélectionnez dans la source de données un champ de filtrage. Les trois types de champ sont les suivants : numérique, chaîne et date. Les icônes représentatives apparaissent en regard des noms de champ.
• Operator (Opérateur) : sélectionnez un opérateur fonctionnel pour évaluer les valeurs de données du champ sélectionné. Les opérateurs varient selon le type de champ.
• Value (Valeur) : saisissez ou sélectionnez une valeur pour compléter la clause. Cliquez sur le bouton Select a display style for source type (Sélectionner un style d'affichage pour le type de source) pour choisir un style d’affichage en fonction de la manière dont vous souhaitez sélectionner une valeur (par exemple, entrée utilisateur, champ, unique et multiple). Les styles incluent des options telles que zone de texte, liste déroulante, sélecteur de date et sélecteur de champ.

Pour chaque clause, vous pouvez définir les options supplémentaires suivantes :

• Case sensitive (Sensible à la casse) : pour satisfaire les critères de filtre, les données doivent utiliser une casse qui correspond à celle des valeurs de la clause. Cette option n’est applicable qu’aux champs de chaîne des couches non hébergées (le bouton est désactivé pour les couches hébergées).
• Ask for values (Demander des valeurs) : autorisez les utilisateurs à spécifier des entrées personnalisées et à modifier les filtres lors de l’exécution. Vous pouvez personnaliser l’étiquette, fournir une indication ou une instruction aux utilisateurs et choisir des critères pour la liste de valeurs affichée aux utilisateurs dans les options de filtre (cette dernière possibilité ne s’applique qu’aux types de source uniques et multiples). Vous pouvez afficher toutes les valeurs, filtrer les valeurs en fonction d’une expression précédente ou filtrer les valeurs en fonction de toutes les expressions.

Si vous ajoutez plusieurs clauses ou un jeu de clauses au filtre, cliquez sur AND (ET) pour indiquer que tous les critères de filtre doivent être vérifiés ou sur OR (OU) pour indiquer que tout critère de filtre peut être vérifié. Vous pouvez également configurer ce paramètre pour les clauses d’un jeu de clauses.