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. Vous pouvez appliquer des filtres à plusieurs couches avec des filtres de groupe. 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 modifier la visibilité des entités dans tous les widgets qui utilisent la même couche dans votre application.
• Vous voulez filtrer des entités sur plusieurs sources de données en fonction d’une valeur commune.

Remarques sur l’utilisation

Le widget Filtre nécessite qu’une source de données soit définie pour chaque filtre que vous possédiez. Vous pouvez définir des actions pour qu’un widget Filtre interagisse avec d’autres widgets (par exemple, zoomer sur l’entité sélectionnée sur une carte dans un widget Carte). 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 vraie pour afficher les données.

Paramètres

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

• New filter (Nouveau filtre) : créez un filtre unique en sélectionnant une source de données et en ajoutant des expressions. Le volet Create new filter (Créer un nouveau filtre) qui s’ouvre inclut les paramètres suivants :
  • Data (Données) : sélectionnez les données à filtrer. Vous ne pouvez sélectionner qu’une source de données par filtre. Les filtres prennent en charge les couches d’entités, les couches d’entités contenues dans les cartes Web sélectionnées, les visualisations de données et les URL de service d’entités. Si des visualisations de données sont associées à une source de données, elles peuvent être sélectionnées dans la liste déroulante.
  • Label (Étiquette) : indiquez un nom significatif pour le filtre de groupe. Par défaut, il s’agit du nom de la source de données.
  • Icon (Icône) : sélectionnez une icône pour chaque filtre. Vous pouvez sélectionner des icônes dans les bibliothèques General (Général) et Arrows (Flèches) ou ajouter votre propre icône à partir d’un fichier. Cliquez sur le bouton Delete (Supprimer) pour supprimer les icônes importées inutilisées.

    Remarque :

    Vous pouvez télécharger les formats d’image suivants : PNG, GIF, JPG, JPEG et BMP. Pour préserver une performance optimale, une limite de taille à 10 Mo est appliquée.

  • 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.

      Remarque :

      Si un widget de filtre est imbriqué dans un contrôleur de widgets, le filtre n’est pas automatiquement appliqué aux données tant que le volet du widget est ouvert (manuellement ou via une configuration d’ouverture dans les paramètres du contrôleur de widgets).

    • Collapse filter details (if any) automatically (Réduire les détails de filtre (le cas échéant) automatiquement) : activez ce paramètre pour réduire par défaut les volets de 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. Ce paramètre est utile pour économiser de l’espace si vous disposez d’un grand nombre de filtres.
• New group (Nouveau groupe) : cliquez sur le bouton New group (Nouveau groupe) , puis sur New group (Nouveau groupe) pour créer un filtre de groupe. Le volet Create new group (Créer un nouveau groupe) qui s’ouvre inclut les paramètres suivants :
  • Data (Données) : sélectionnez les données à filtrer. Vous pouvez sélectionner plusieurs sources de données. Les filtres de groupe prennent en charge les couches d’entités, les couches d’entités contenues dans les cartes Web sélectionnées, les visualisations de données et les URL de service d’entités. Si des visualisations de données sont associées à une source de données, elles peuvent être sélectionnées dans la liste déroulante. Les sources de données en sortie ne sont pas prises en charge.
  • Label (Étiquette) : indiquez un nom significatif pour le filtre de groupe. Lorsque vous ajoutez un filtre de groupe, son étiquette suit par défaut une règle de numérotation continue.
  • Icon (Icône) : sélectionnez une icône pour le filtre de groupe. Vous pouvez sélectionner des icônes dans les bibliothèques General (Général) et Arrows (Flèches) ou ajouter votre propre icône à partir d’un fichier. Cliquez sur le bouton Delete (Supprimer) pour supprimer les icônes importées inutilisées.

    Remarque :

    Vous pouvez télécharger les formats d’image suivants : PNG, GIF, JPG, JPEG et BMP. Pour préserver une performance optimale, une limite de taille à 10 Mo est appliquée pour chaque chargement.

  • SQL Expressions (Expressions SQL) : créez des expressions SQL pour spécifier les critères de filtre. Le générateur d’expressions SQL du groupe offre plusieurs options permettant de créer des requêtes complexes et interactives.
  • Options : vous pouvez activer les options suivantes pour chaque filtre de groupe :
    • Apply this filter automatically (Appliquer ce filtre automatiquement) : activez ce paramètre pour appliquer automatiquement le filtre aux données lorsque l’utilisateur ouvre l’application.
    • Collapse filter details (if any) automatically (Réduire les détails de filtre (le cas échéant) automatiquement) : activez ce paramètre pour réduire par défaut les volets de 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. Ce paramètre est utile pour économiser de l’espace si vous disposez d’un grand nombre de filtres.
• Lorsque vous ajoutez plusieurs filtres ou groupes, 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 n’importe quel critère de filtre peut être vérifié. Vous pouvez également faire glisser les filtres et les groupes pour changer leur ordre.
• Vous pouvez utiliser les boutons Duplicate (Dupliquer) et Remove (Supprimer) qui apparaissent en regard de chaque filtre et groupe pour les dupliquer et les supprimer.
• Arrangement style (Style de disposition) : sélectionnez Vertical, Horizontal ou Icon (Icône) pour personnaliser le style souhaité des filtres pour un widget.
• Activation style (Style d’activation) : sélectionnez Toggle switch (Commutateur) ou Button (Bouton) comme style pour activer ou désactiver chaque filtre. (Le style par défaut est Toggle switch (Commutateur).)
  • Exclude activation styles for single clause (Exclure les styles d’activation pour une clause unique) : si une seule clause demande des valeurs (ou affiche une étiquette) dans chaque filtre, cette option permet d’exclure les styles d’activation (ainsi que l’étiquette et l’icône), d’afficher directement le contenu de la clause et de l’appliquer automatiquement.
• Advanced tools (Outils avancés) - Configurez des outils avancés.
  • Reset all filters (Réinitialiser tous les filtres) - Incluez un bouton permettant aux utilisateurs de réinitialiser tous les filtres à leur état configuré initial.

    Conseil :

    L’outil de filtre Widget de liste fournit un bouton de réinitialisation par défaut.

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 parties 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. Consultez la liste complète des opérateurs pris en charge pour chaque type de champ.
• Value (Valeur) : saisissez ou sélectionnez une valeur pour compléter la clause. Cliquez sur le bouton Select source type (Sélectionner un type de source) pour sélectionner une valeur, telle que saisie utilisateur, champ, unique, unique prédéfinie, multiple et multiple (prédéfinie).

Remarque :

Si vous connectez le filtre à une source de données en sortie, vous ne pouvez pas choisir ses valeurs dans les paramètres (excepté pour les valeurs codées). En effet, la liste des valeurs est générée de façon dynamique au moment de l’exécution après la création des données en sortie par le widget source. C’est la raison pour laquelle la case Ask for values (Demander des valeurs) est cochée par défaut et que seules des valeurs prédéfinies peuvent être saisies.

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 n’est pas disponible pour les couches hébergées).
• No user input (Pas de saisie utilisateur) : par défaut, la clause ne demande pas la saisie de valeurs par les utilisateurs. Vous pouvez sélectionner l’option Display label (Afficher l’étiquette) pour montrer uniquement les étiquettes par défaut ou personnalisées aux utilisateurs.
• Ask for values (Demander des valeurs) : autorise les utilisateurs à spécifier des entrées personnalisées et à modifier les filtres lors de l’exécution. Vous pouvez effectuer les opérations suivantes :
  • Sélectionner un style d’entrée (si plusieurs styles sont disponibles en fonction du type de source de valeur sélectionné).
  • Personnaliser l’étiquette.
  • Personnaliser la position de l’étiquette. Vous pouvez sélectionner wrap in different line (renvoyer sur une autre ligne) ou in the same line with input (sur la même ligne que l’entrée).
  • Donner une astuce ou une instruction aux utilisateurs.
  • Sélectionner des critères pour la liste de valeurs que les utilisateurs voient dans les options de filtrage (s’appliquent uniquement aux types de source unique et de source multiple). 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.

    Remarque :

    Les valeurs prédéfinies vous permettent d’appliquer un filtre en fonction d’une ou de plusieurs valeurs que vous choisissez dans une liste statique ou que vous saisissez directement. Par défaut, l’option Ask for values (Demander des valeurs) est sélectionnée et la liste est définie pour afficher les valeurs en fonction des expressions précédentes. Vous pouvez également faire glisser les valeurs pour les déplacer et changer leur ordre.

• Duplicate (Dupliquer) : dupliquez une seule clause ou un ensemble de clauses entier et ajoutez cet élément à la fin de la file d’attente, dans SQL Expression Builder (Générateur d’expressions SQL). S’il se trouve dans un ensemble de clauses, ce bouton duplique une seule clause et l’ajoute à la fin de l’ensemble de clauses.

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.

Générateur d’expressions SQL du groupe

L’option Group SQL Expression Builder (Générateur d’expressions SQL du groupe) vous permet de créer des expressions logiques pour des filtres de groupe, qui filtrent plusieurs champs de source de données selon des valeurs communes. L’expression se compose comme suit :

• Champ principal : champ que vous utilisez pour définir l’opérateur et les valeurs pour le reste des champs dans le filtre de groupe.
• Tous les champs : tous les champs filtrés par le filtre de groupe, y compris le champ principal. Vous pouvez utiliser les listes déroulantes pour sélectionner des champs dans les sources de données connectées. Vous pouvez uniquement sélectionner des champs de même type (chaîne, date ou nombre) comme champ principal. Si vous sélectionnez plusieurs champs dans une source de données, cliquez sur AND (ET) pour indiquer que la valeur doit exister dans les deux champs ou sur OR (OU) pour indiquer qu’elle peut exister dans n’importe quel champ.
• Operator (Opérateur) : sélectionnez un opérateur fonctionnel pour évaluer les valeurs de données des champs sélectionnés. Les opérateurs varient selon le type du champ principal. Consultez la liste complète des opérateurs pris en charge pour chaque type de champ.
• Value (Valeur) : saisissez ou sélectionnez une valeur pour compléter l’expression. Cliquez sur le bouton Select source type (Sélectionner un type de source) pour sélectionner une valeur, telle que saisie utilisateur, champ, unique, unique prédéfinie, multiple et multiple (prédéfinie).

Vous pouvez configurer les options supplémentaires suivantes pour l’expression :

• Case sensitive (Sensible à la casse) : pour satisfaire les critères de filtre, les données doivent utiliser une casse qui correspond à celle de la valeur du champ principal. Cette option n’est applicable qu’aux champs de chaîne des couches non hébergées (le bouton n’est pas disponible pour les couches hébergées).
• No user input (Pas d’entrée utilisateur) : par défaut, l’expression ne demande pas la saisie de valeurs par les utilisateurs. Vous pouvez sélectionner l’option Display label (Afficher l’étiquette) pour montrer uniquement les étiquettes par défaut ou personnalisées aux utilisateurs.
• 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 effectuer les opérations suivantes :
  • Sélectionner un style d’entrée (si plusieurs styles sont disponibles en fonction du type de source de valeur sélectionné).
  • Personnaliser l’étiquette de l’expression.
  • Personnaliser la position de l’étiquette. Vous pouvez sélectionner wrap in different line (renvoyer sur une autre ligne) ou in the same line with input (sur la même ligne que l’entrée).
  • Donner une astuce ou une instruction aux utilisateurs.
  • Sélectionner des critères pour la liste de valeurs que les utilisateurs voient dans les options de filtrage (s’appliquent uniquement aux types de source unique et de source multiple).

Opérateurs

La table suivante répertorie les types de champ et les opérateurs qu’ils prennent en charge :

Opérateur	Nombre	Chaîne	Date
est
n’est pas
est au moins
est au plus
est inférieur(e) à
est supérieur(e) à
est entre
n’est pas entre
commence par
ne commence pas par
se termine par
ne se termine pas par
contient
ne contient pas
est l’un(e) des
n’est aucun(e) des
est le
n’est pas le
est dans
n’est pas dans
est avant
est après
est à cette date ou avant
est le ou après
est dans les dernier(ère)s*
n’est pas dans les dernier(ère)s*
est dans les prochain(e)s*
n’est pas dans les prochain(e)s*
est vide
n’est pas vide

*Applicable uniquement pour les services d’entités hébergés ArcGIS Online.