Widget Rechercher

Le widget Search (Rechercher) permet de configurer un outil de recherche pour trouver des entités, des enregistrements ou des localisations en fonction de couches et de localisateurs spécifiques, et de définir le mode d’affichage des résultats de recherche. Si vous ajoutez plusieurs sources de recherche au widget, les utilisateurs peuvent choisir celles dans lesquelles effectuer la recherche. L’exécution de la recherche à l’aide d’une source de la couche affectant les données de votre application, les autres widgets qui utilisent la même couche sont filtrés pour afficher le résultat de la recherche correspondant. Si vous voulez que les résultats de recherche soient sélectionnés, vous pouvez définir une action. Pour que le widget sélectionne des entités sans filtrer les données, créez une vue de données pour la source de données que vous pouvez utiliser comme source de la couche. L’exécution d’une recherche à l’aide d’une source du localisateur génère une source de données en sortie que d’autres widgets peuvent utiliser.

Pour effectuer une recherche, les utilisateurs saisissent un mot ou une expression dans la zone de recherche et appuient sur Entrée, cliquent sur le bouton de recherche, ou choisissent un élément dans une liste de suggestions qui apparaissent en fonction des enregistrements correspondants. (La liste des suggestions affichant chaque valeur correspondante sous forme d’élément, si un enregistrement contient deux champs qui correspondent à l’expression de recherche, cet enregistrement apparaît comme deux suggestions.) Les utilisateurs peuvent utiliser les touches Flèche haut et Flèche bas pour parcourir la liste de suggestions. Cliquez sur une suggestion pour remplacer l’expression de recherche par le contenu provenant de l’élément suggéré et appliquer la recherche à l’aide de la nouvelle valeur, afin de renvoyer les données correspondantes dans un volet de résultats. Pour rationaliser ce processus, vous pouvez activer un paramètre qui permet de sélectionner automatiquement le premier résultat de recherche. Vous pouvez également configurer le widget pour ouvrir une autre page dans votre application afin d’afficher le résultat dans un autre widget.

Exemples

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

• Vous pouvez configurer une option de recherche dans votre application qui offre davantage de flexibilité que l’outil de recherche inclus dans les widgets Map (Carte), List (Liste) et Table. Vous pouvez en particulier rechercher des couches spécifiques dans des champs limités sur la carte, indiquer une astuce textuelle unique dans la zone de recherche et afficher des valeurs pour certains champs de données dans le volet des résultats.
• Vous souhaitez que les utilisateurs trouvent des informations provenant de plusieurs sources lorsqu’ils effectuent une recherche.
• Vous voulez afficher les résultats de la recherche dans d’autres widgets sur une page différente de votre application.

Remarques sur l'utilisation

Le widget Search (Rechercher) prend en charge deux types de sources de recherche : les couches et les localisateurs. Lorsque vous ajoutez un widget Search (Rechercher), les localisateurs spécifiés dans vos paramètres d’organisation sont ajoutés en tant que sources de localisateur par défaut. (Si le service ArcGIS World Geocoding Service par défaut n’apparaît pas, votre administrateur l’a peut-être retiré des paramètres de l’organisation.) Pour utiliser une autre source du localisateur, ajoutez une URL pour le service de localisateur. Pour effectuer une recherche dans des couches, sélectionnez des couches d’entités et des couches de scènes qui sont ajoutées en tant que données à votre application.

Vous pouvez définir des actions pour qu’un widget Search (Rechercher) interagisse avec d’autres widgets dans votre application (par exemple, zoomer sur le résultat sélectionné dans une carte ou afficher les résultats de la recherche (à partir d’une source du localisateur) dans une carte).

Paramètres

Le widget Search (Recherche) inclut les paramètres suivants :

• New search source (Nouvelle source de recherche) : vous pouvez également ajouter des sources pour rechercher un autre contenu que celui par défaut. Sélectionnez Layer source (Source de la couche) ou Locator source (Source du localisateur) et indiquez les paramètres suivants pour chaque option :
  • Data (Données) : sélectionnez la source de données pour la couche d’entités dans laquelle les utilisateurs doivent effectuer la recherche, le cas échéant. Dans les paramètres de visualisation de données, vous pouvez filtrer les données pour limiter la portée de la recherche ou trier les données pour afficher les résultats de la recherche dans un ordre particulier.
  • Locator URL (URL du localisateur) : indiquez l’URL du service de localisateur (qui commence par https://), le cas échéant. Le widget utilise automatiquement les localisateurs spécifiés dans vos paramètres d’organisation.
  • Label (Étiquette) : saisissez un nom pour la source de recherche. Ce nom apparaît dans le menu de recherche, la liste de suggestions et le volet des résultats.
  • Icon (Icône) : sélectionnez une icône pour la source. Cette icône apparaît dans la liste de suggestions et le volet des résultats de la recherche. 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.

  • Search options (Options de recherche) : personnalisez l’astuce textuelle qui apparaît dans la zone de recherche lorsque les utilisateurs choisissent d’exécuter la recherche uniquement dans cette source. Pour Layer source (Source de la couche), vous pouvez définir les options supplémentaires suivantes :
    • Select searching fields (Sélectionner les champs de recherche) : sélectionnez un ou plusieurs champs à rechercher dans la couche.
    • Exact match (Correspondance parfaite) : limitez les résultats de recherche aux seuls enregistrements qui correspondent à la phrase de recherche.
    • Display fields (Champs d’affichage) : choisissez un ou plusieurs champs à afficher dans le volet des résultats de la recherche. Vous pouvez faire glisser les champs sélectionnés pour les réorganiser.
• Options de recherche générales
  • Hint for multiple search sources (Astuce pour plusieurs sources de recherche) : personnalisez l’astuce textuelle qui apparaît dans la zone de recherche lorsque les utilisateurs choisissent d’exécuter la recherche dans plusieurs sources.
  • Search suggestion (Suggestion de recherche) : définissez le nombre maximum de suggestions qui s’affichent pour chaque source de recherche. Vous pouvez également configurer les options suivantes :
    • Use current location (Utiliser la localisation actuelle) : incluez une option de suggestion pour effectuer la recherche en fonction de la localisation actuelle de l’utilisateur.
    • Recent searches (Recherches récentes) : affichez l’historique de recherche dans la zone de suggestion en fonction du nombre maximum de recherches récentes spécifié. (Les utilisateurs peuvent effacer l’historique de recherche.)

    Conseil :

    Définissez Maximum suggestions per source (Nombre maximal de suggestions par source) sur 0 pour désactiver les suggestions de source de recherche.

• Search result (Résultat de la recherche) : choisissez d’afficher un volet des résultats de la recherche ou d’insérer un lien vers une page dans votre application pour afficher les résultats dans un autre widget.
  • Volet des résultats : affichez les résultats de recherche dans un volet qui s’ouvre sous la zone de recherche. Vous pouvez définir le nombre maximum de résultats à afficher par source de recherche et choisir de sélectionner automatiquement le premier résultat.
  • Set link (Définir un lien) : ouvrez une page spécifique dans votre application pour afficher les résultats pertinents de la recherche dans un widget correspondant.

Options d’interaction

Lorsque vous configurez des actions Messages pour le widget Search (Rechercher), vous avez le choix parmi les déclencheurs suivants selon la source de recherche.

Déclencheur	Source de la couche	Source du localisateur
Modifications de sélection d’enregistrements
Enregistrements créés
Modifications de filtrage des données

Lorsqu’il est configuré avec une source du localisateur, le widget Search (Rechercher) génère une source de données en sortie que d’autres widgets peuvent utiliser. L’interaction avec d’autres widgets utilisant la même source de données en sortie s’effectue via l’ajout d’actions. Par exemple, la carte peut afficher automatiquement les résultats de la recherche et zoomer sur les entités. Dans les paramètres du widget Search (Rechercher), dans l’onglet Action, ajoutez le déclencheur Records created (Enregistrements créés), sélectionnez la carte cible et ajoutez des actions pour Show on map (Afficher sur la carte) et Zoom to (Zoom sur).

Pour sélectionner une entité sur une carte qui correspond à un résultat de recherche sélectionné, ajoutez le déclencheur Record selection changes (Modifications de sélection d’enregistrements) pour le widget Search (Rechercher) (lorsqu’il est configuré pour utiliser le volet des résultats). Sélectionnez la structure cible, ajoutez l’action Select Data Records (Sélectionner les enregistrements de données) et configurez-la avec la couche d’entités de la carte et les champs qui associent la connexion entre le déclencheur et les données de l’action. Vous pouvez également ajouter l’action Zoom to (Zoom sur) pour zoomer dans la carte sur l’entité.

En cas de configuration avec une source de la couche, si vous voulez que la carte zoome ou se déplace sur le résultat de recherche sélectionné, ajoutez le déclencheur Data filtering changes (Modifications de filtrage des données), sélectionnez la carte cible et ajoutez les actions Pan to (Déplacer) et Zoom to (Zoom sur).

Si vous souhaitez ajuster le niveau de zoom pour l’action Zoom to (Zoom sur), basculez l’action Zoom scale (Échelle de zoom) sur Custom (Personnaliser) et indiquez l’échelle souhaitée.

Conseil :

Pour que le widget Search (Rechercher) sélectionne l’entité sur une carte sans filtrer les données, créez une vue de données pour la source de données que vous pouvez utiliser comme source de la couche.