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. Pour utiliser une source de localisateur, ajoutez un service de localisateur. Vous pouvez utiliser les localisateurs spécifiés dans les paramètres de votre organisation ou ajoutés par vous dans le volet Select utility (Sélectionner un service). 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.

Si vous configurez plusieurs sources de recherche, les utilisateurs peuvent, lors de l’exécution, utiliser le menu déroulant pour activer et désactiver des sources individuelles, ou se servir de la case à cocher All (Toutes) pour activer ou désactiver toutes les sources.

Avec les sources de localisateur, vous pouvez saisir les types suivants de termes de recherche :

• Place-names (Noms de lieux)
• Points of interest (Points d’intérêt)
• Adresses
• coordonnées UTM
• Coordonnées dans un système de coordonnées que vous spécifiez avec un identifiant connu (WKID).

  Le format correspondant est x,y : WKID. Par exemple, -13046165.52, 4036389.847: 102100

Si vous connectez un widget Search (Rechercher) et un widget Map (Carte) à la même couche d’entités et que vous activez l’option Show pop-up upon feature selection (Afficher la fenêtre contextuelle lors de la sélection d’une entité) dans les paramètres du widget Map (Carte), des fenêtres contextuelles apparaissent lorsque vous sélectionnez des enregistrements dans les résultats de recherche.

Méthodes de recherche

Le widget Search (Rechercher) emploie différentes méthodes pour générer les suggestions et les résultats de recherche.

Le widget utilise la recherche de texte intégral afin de générer des suggestions de recherche pour les sources de couche. La recherche de texte intégral est une méthode de recherche efficace qui utilise des index de champ de texte intégral pour diviser les enregistrements en unités plus petites, telles que des mots individuels. Prenons l’exemple d’une couche des localisations des bureaux de poste aux États-Unis qui comporte un champ contenant les noms de chacune de ces localisations. L’index fractionne le nom Highland Station Baltimore Post Office en cinq mots pouvant faire l’objet d’une recherche individuelle : Highland, Station, Baltimore, Post et Office. Si vous saisissez une expression de recherche combinant ces mots (ou uniquement une partie d’entre eux), comme Baltimore Office, Highland Baltimore ou Stat Balt Office, ce bureau de poste apparaît dans les suggestions de recherche.

Les index de champ de texte intégral sont automatiquement générés pour les couches d’entités hébergées lorsque vous les sélectionnez en tant que champs de recherche pour le widget Search (Rechercher), List (Liste) ou Table si vous possédez la couche d’entités hébergée ou si vous êtes administrateur de l’organisation. Vous pouvez également ajouter manuellement des index aux champs d’attribut sur la page des détails de l’élément de la couche. Dans le cas de couches dépourvues d’index et que vous n’êtes pas autorisé à modifier, le widget Search (Rechercher) trouve les suggestions à l’aide de START WITH abc%, c’est-à-dire qu’il recherche les enregistrements qui commencent par l’expression de recherche. Cette méthode de recherche est moins efficace.

Pour obtenir les résultats de recherche, le widget utilise CONTAIN %abc%, ce qui signifie que l’expression de recherche peut se trouver n’importe où dans l’enregistrement. Vous pouvez ainsi rechercher alt pour obtenir les résultats de recherche Baltimore, Salt Lake City et Alton.

Attention :

La recherche de texte intégral est une nouvelle fonctionnalité de la version d’octobre 2023 de Experience Builder et est une modification importante. Avant cette version, le widget utilisait CONTAIN %abc% pour générer les suggestions et les résultats. À la différence des requêtes CONTAIN %abc%, la recherche de texte intégral ne peut pas trouver les expressions situées au milieu des mots. Dans l’exemple ci-dessus, la recherche de altimor ou de ighlan ne renvoie pas le bureau de poste attendu dans les suggestions de recherche. En savoir plus sur la recherche d’entités dans les cartes et les applications.

Paramètres

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

• New search source (Nouvelle source de recherche)  : ajoutez des sources pour rechercher un contenu. 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) - Connectez un service de distribution de localisateur. Le volet Select utility (Sélectionner un service) affiche les localisateurs spécifiés dans les paramètres de votre organisation ou ajoutés par vous dans le volet Utility service (Service réseau).
  • 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) - Vous pouvez définir les options supplémentaires suivantes :
    • Select searching fields (Sélectionner les champs de recherche) (sources de couche uniquement) - Sélectionnez un ou plusieurs champs à rechercher dans la couche.
    • Exact match (Correspondance parfaite) (sources de couche uniquement) - 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.
    • Hint (Astuce) - 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.
• Enable filtering for layer source search (Activer le filtrage pour la recherche de sources de couche) – Si ce paramètre est activé, lorsque l’utilisateur effectue une recherche, le widget filtre les sources de couche connectées en fonction des critères de recherche.
• General search options (Options de recherche générales) : vous pouvez définir les options de recherche générales suivantes :
  • 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) - Ajoutez un lien pour ouvrir une page, une fenêtre ou une vue de section spécifique dans votre application ou faites défiler l’écran jusqu’à un bloc spécifique ou jusqu’au haut de la page pour afficher les résultats pertinents de la recherche dans un widget correspondant. Ce paramètre apparaît lorsque Result panel (Volet des résultats) est désactivé.
  • Style : sélectionnez un style d’interface pour le volet des résultats, qui peut être Classic (Classique) ou Compact. Compact présente un bouton de réduction plus petit qui apparaît au bas du volet.
• Arrangement style (Style de disposition ) – Choisissez une interface utilisateur pour le widget : Square (Carré), Curve (Courbe) ou Linear (Linéaire).

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

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

Paramètres URL

Les sous-sections ci-après décrivent les paramètres d’URL liés à la recherche. Vous pouvez utiliser les paramètres sous Manage URL status (Gérer le statut de l’URL) pour faire en sorte que ces paramètres apparaissent dans l’URL lorsque l’utilisateur effectue une recherche. Les paramètres du widget Search (Rechercher) suivent les marques de hachage (#).

Afficher l’entrée de recherche

Le paramètre searchText montre quel texte l’utilisateur a saisi pour effectuer la recherche. Voici un exemple d’URL avec le paramètre searchText :

https://experience.arcgis.com/experience/<AppId>#<searchWidgetID>=search_status:%7B"searchText"%3A"<text>"%7D

Afficher la source de recherche

Lorsque l’utilisateur effectue une recherche à l’aide de seulement une partie des sources de recherche disponibles, un des deux paramètres suivants apparaissent dans l’URL :

• Si au moins une source de recherche est décochée dans le menu déroulant du widget lors de l’exécution, le paramètre serviceEnabledList apparaît et définit les sources de recherche qui sont cochées. Ce paramètre est masqué lorsque toutes les sources de recherche sont cochées. Voici un exemple d’URL codée :

  https://experience.arcgis.com/experience/<AppId>#<searchWidgetID>=search_status:%7B"serviceEnabledList"%3A%5B"<SourceID1>"%2C"<SourceID2>"%5D%7D

• Si l’utilisateur clique sur une suggestion pour appliquer une recherche, le paramètre "status":{"configId":"<SourceID>"} apparaît et définit la source de recherche unique utilisée dans la recherche actuelle. L’entrée de recherche et la source de recherche apparaissent toutes deux dans l’URL. Voici un exemple d’URL codée :

  https://experience.arcgis.com/experience/<AppId>#<searchWidgetID>=search_status:%7B"searchText"%3A"<text>"%2C"status"%3A%7B"configId"%3A"<SourceID>"%7D%7D

Si l’utilisateur clique sur une suggestion de recherche provenant d’une source du localisateur, l’URL affiche le paramètre magicKey associé à la suggestion. magicKey est un ID unique qui lie une suggestion à une adresse ou un lieu. Voici un exemple de propriétés et de paramètres de recherche écrits au format JSON :

{
	"searchText": "<text>",
	"status":{
		"configId": "<SourceID>",
		"magicKey": "<key>"
	}
}

Voici un exemple des mêmes propriétés et paramètres, écrits dans une URL codée :

https://experience.arcgis.com/experience/<AppId>#<searchWidgetID>=search_status:%7B"searchText"%3A"<text>"%2C"status"%3A%7B"configId"%3A"<SourceID>"%2C"magicKey"%3A"<key>"%7D%7D