Widget Filtrer les groupes

Le widget Group Filter (Filtrer les groupes) permet d'appliquer un filtre à la carte en fonction d'une ou plusieurs couches de la carte. Un jeu de couches est groupé en un jeu de filtres logique. Chaque jeu peut correspondre à une valeur prédéfinie pour faciliter l'interaction de l'utilisateur. Ce widget présente deux modes : le mode normal, qui permet de créer des filtres complexes pendant l’exécution, et le mode simple, qui permet l’application d’un seul filtre.

Configurer le widget Group Filter (Filtrer les groupes)

Ce widget peut être configuré pour s’ouvrir automatiquement au démarrage d’une application. Cliquez sur le bouton Do not open this widget when the app starts (Ne pas ouvrir ce widget au démarrage de l’application) du widget pour activer l’option d’ouverture automatique du widget. (Pour les widgets que vous devez ajouter à l’application au préalable, vous pouvez définir ce paramètre après avoir configuré le widget.)

Les étapes suivantes expliquent comment créer un jeu de filtres. Répétez la procédure pour définir plusieurs jeux de filtres.

1. Survolez le widget avec le curseur et cliquez sur le bouton Configure this widget (Configurer ce widget) pour ouvrir la fenêtre de configuration.

   Remarque :

   Si vous devez ajouter le widget à l’application au préalable, cliquez sur un espace réservé de widget dans l’onglet Widget (Widget). Dans la fenêtre Choose Widget (Choisir un widget) qui s’ouvre, sélectionnez le widget et cliquez sur OK (OK).

2. Vous pouvez cliquer sur Change widget icon (Modifier l’icône du widget) pour remplacer l’icône par défaut de ce widget.
   Une fenêtre d'exploration de fichiers s'ouvre, qui vous permet de choisir un fichier d'image local à utiliser comme icône du widget.

   La configuration affiche un groupe prêt à être modifié.

3. Définissez un Nom de l’ensemble des filtres.

   Ce nom désigne le jeu de filtres proposé à la sélection de l’utilisateur final. En option, vous pouvez ajouter une description pour expliquer aux utilisateurs ce que ce groupe va filtrer.

4. Vous pouvez également utiliser Preset Operator (Opérateur prédéfini) et Preset Value (Valeur prédéfinie) afin de définir une valeur pour ce filtre de sorte que les utilisateurs n’aient pas besoin d’indiquer ces critères lors de l’exécution. Pour l'option Preset Value (Valeur prédéfinie), vous pouvez saisir une valeur ou cliquer sur le bouton de recherche pour sélectionner une valeur dans la couche existante.
5. Si vous filtrez différents champs de la même couche, vous pouvez contrôler la manière dont ces champs sont joints en choisissant de mettre en correspondance tout ou parties des expressions à l’aide du paramètre When a layer is listed more than once (Lorsqu’une couche est répertoriée plusieurs fois).
6. Pour effectuer une recherche en tenant compte de la casse, cochez la case pour ne renvoyer que les entités dont les valeurs d’attribut correspondent exactement à la recherche en entrée avec des caractères en majuscule et en minuscule.
7. Dans la table fournie qui affiche les couches dans le filtre défini (y compris un filtre renseigné par défaut avec une couche aléatoire de votre carte), choisissez la couche et le champ auxquels vous souhaitez appliquer un filtre.
8. Sélectionnez le bouton Use Value (Utiliser une valeur) ; il permet d’indiquer si une liste déroulante de valeurs apparaît pour que l’utilisateur recherche une valeur. Si cette option n’est pas sélectionnée, une zone de texte simple apparaît à la place.

   Remarque :

   Ce bouton est facultatif.

9. Pour ajouter une autre couche à ce jeu de filtres, cliquez sur le bouton Ajouter une couche.
10. Pour ajouter un autre jeu de filtres, cliquez sur le bouton Add a New Group (Ajouter un nouveau groupe). Vous créez ainsi un autre groupe de jeux de filtres. Si cela est nécessaire, répétez les étapes 3 à 7.
11. Spécifiez le texte d’en-tête personnalisé à l’aide de la zone de texte Provide text to display above filter selection (Indiquer le texte à afficher au-dessus de la sélection des filtres).
12. Les six cases à cocher suivantes déterminent le comportement du widget :
    • L’option Start in Simple View (Commencer dans la vue simple) détermine l’apparence du widget. Si vous cochez cette case, vous supprimez la liste déroulante des opérateurs et le bouton Add Criteria (Ajouter un critère) de l’interface, qui est de ce fait simplifiée.
    • L'option Masquer les options de widget détermine si une icône doit représenter les paramètres supplémentaires du widget. Parmi ces paramètres, on compte l'enregistrement et le chargement de filtres définis, leur ajout à une définition de filtre dans la carte, le cas échéant, et la conservation du filtre après la fermeture du widget.
    • Si un filtre prédéfini est déjà appliqué à la carte web, Append any/all expressions to existing map filter (Ajouter des/toutes les expressions au filtre de carte existant) permet d’ajouter les filtres créés dans ce widget au filtre de carte web existant. Ce paramètre conserve les filtres entre plusieurs groupes. S’il n’est pas activé, le widget remplace le filtre de carte web.
      • L’utilisation de any (tout) est additive. Le filtre configuré est ajouté au filtre de carte web.
      • L’utilisation de all (tous) est exclusive. N’affiche que les entités qui satisfont aux exigences du filtre configuré et du filtre de carte web.
    • Zoom permet de zoomer sur l'étendue des données filtrées dans la carte. Par défaut, la carte conserve son étendue actuelle.
    • L’option Persist After Widget is Closed (Conserver après la fermeture du widget) permet de conserver le filtre une fois le widget fermé.

    • Hide the header and filter selection if only 1 group is configured (Masquer l’en-tête et filtrer la sélection si un seul groupe est configuré) permet de masquer l’en-tête et le menu déroulant si un seul groupe est configuré.

Utiliser le widget Group Filter (Filtrer les groupes)

1. Cliquez sur le widget Group Filter (Filtrer les groupes) pour afficher une sélection de jeux de filtres prédéfinis.

   

   Deux listes apparaissent sous la ligne de séparation : opérateurs et valeurs. Dans l'exemple, la carte est filtrée pour afficher uniquement les réclamations concernant les véhicules abandonnés.

   Remarque :

   Selon la configuration des couches dans le widget, vous verrez une liste de valeurs (similaire à celle de cet exemple), une zone de texte dans laquelle l’utilisateur peut saisir des données ou un sélecteur de dates.

2. Cliquez sur le bouton Apply (Appliquer) pour appliquer le filtre à la carte.

   Vous pouvez éventuellement appliquer des filtres en ajoutant des paramètres d’URL à l’URL de l’application. L’URL doit se présenter au format suivant (remplacez les variables entre crochets par les valeurs décrites dans la liste ci-après) :

   https://<l’URL de votre portail>/apps/webappviewer/index.html?id=<ID élément>&groupfilter={"<Nom de l'ensemble des filtres>":["<valeur>","<valeur>",...]}

   • Item ID (ID d’élément) : identifiant unique de l’application.
   • Filter Set Name (Nom de l'ensemble des filtres) : nom défini pour le groupe de filtres. Cette valeur respecte la casse.
   • Valeur : valeur utilisée pour effectuer le filtrage. Pour filtrer par domaines, utilisez le code de domaine.

   Par exemple, pour appliquer le filtre illustré dans l’image précédente, utilisez une URL similaire à celle de l’exemple suivant :

   https://<your portal URL>/apps/webappviewer/index.html?id=6815e148ff1c4aee8dc7159816380a4d&groupfilter={"Group A":["Abandoned Motor Vehicle"]}

   Remarque :

   Si le widget Group Filter (Filtrer les groupes) n’est pas configuré pour s’ouvrir automatiquement au démarrage de l’application, le filtre défini dans l’URL ne s’applique pas tant que vous n’avez pas ouvert le widget.

3. Cliquez sur Reset (Réinitialiser) pour supprimer le filtre et restaurer la carte à son état initial. (Par défaut, la fermeture du widget supprime également le filtre.)
4. Le widget vous permet d’ajouter des critères de filtre supplémentaires au moment de l’exécution. Cliquez sur Add Criteria (Ajouter un critère) pour ajouter une autre clause. Vous remarquerez que les deux critères sont reliés par une conjonction. Vous pouvez les joindre à l’aide de l’opérateur OR ou AND.

   

   Pour utiliser les paramètres d’URL pour appliquer le filtre illustré dans cet exemple, votre URL doit ressembler à celle de l’exemple suivant :

   https://<your portal URL>/apps/webappviewer/index.html?id=6815e148ff1c4aee8dc7159816380a4d&groupfilter={"Group A":["Abandoned Motor Vehicle","Auto Theft"]}

5. Le widget propose une option d'enregistrement de ces paramètres de critères définis pour une utilisation ultérieure. Cliquez sur le bouton des paramètres pour accéder au volet d’options.

   

   1. Cliquez sur Save (Enregistrer) pour enregistrer les critères définis en local dans un fichier texte JSON.
   2. Cliquez sur Upload a Saved File (Charger un fichier enregistré) pour charger un fichier déjà enregistré et restaurer tous les critères définis dans le fichier.
   3. Si vous devez utiliser la carte filtrée dans d’autres widgets, cochez la case Persist After Widget is Closed (Conserver après la fermeture du widget). Sinon, lorsque vous fermez le widget, tous les filtres sont supprimés et l'état initial de la carte est restauré.