Configurer la recherche dans les applications

Remarque :

ArcGIS Configurable Apps sera obsolète en 2025. Pour en savoir plus sur l’obsolescence de ArcGIS Configurable Apps et savoir comment migrer vos applications configurables vers ArcGIS Instant Apps, lisez l’article de blog ArcGIS intitulé ArcGIS Configurable Apps Roadmap for Retirement.

La plupart des modèles ArcGIS Configurable Apps offrent la possibilité de rechercher des localisations et des entités sur la carte. Un widget de recherche intégré dans l'interface utilisateur de l'application permet à un utilisateur de saisir des termes de recherche. Si la recherche a été configurée sur la carte web, les applications configurables utilisent cette configuration une fois qu'elle est activée dans l'application.

Vous pouvez également configurer la recherche dans une application à l'aide de l'onglet Rechercher du volet de configuration de l'application, quelles que soient les propriétés de recherche définies au niveau de la carte web. Les sections ci-dessous expliquent comment configurer la recherche dans les applications.

Paramètres de configuration

Configurable Apps prend en charge les mêmes types de sources de recherche que celles prises en charge dans les cartes Web (par exemple, les localisateurs et les couches d’entités pouvant faire l’objet d’une recherche). Les applications qui prennent en charge la recherche possèdent un onglet Rechercher dans le volet de configuration où toutes les sources de recherche sont répertoriées. Chaque source de recherche peut être activée ou désactivée dans l'application à partir de cette liste. Vous pouvez configurer les paramètres de chaque source de recherche en cliquant sur Modifier en regard de la source dans la liste.

Les paramètres des sources de recherche suivants peuvent être configurés :

• Nom : attribuez un nom personnalisé à la source de recherche.
• Espace réservé : spécifiez le texte prédéfini qui apparaît dans la zone de recherche avant la saisie d'une valeur à rechercher. Considérez-le comme une astuce textuelle.
• Contraindre la recherche dans la carte : cochez cette case pour trouver uniquement les entités comprises dans l'étendue de la carte. Il s'agit de l'étendue enregistrée au niveau de la carte web.
• Activer les suggestions : si vous cochez cette case, les résultats potentiels apparaissent dans un menu déroulant lors de la saisie d'une valeur de recherche.
• Nombre maximal de suggestions : si les suggestions sont activées, choisissez le nombre maximum de suggestions qui seront proposées à la fois.
• Afficher les suggestions : pour les couches pouvant faire l'objet d'une recherche, vous pouvez indiquer la manière dont les suggestions apparaissent aux utilisateurs de l'application. Vous pouvez afficher les suggestions en tant que valeur d'un champ spécifié ou personnaliser l'affichage en ajoutant du texte et des valeurs de champ ensemble.
• Correspondance parfaite : cochez cette case pour limiter les résultats de recherche uniquement aux résultats qui correspondent exactement à la valeur saisie dans la zone de recherche.

Les sections qui suivent expliquent comment configurer les sources de recherche de façon à personnaliser la recherche pour votre application.

Activer un localisateur en tant que source de recherche

Tous les localisateurs établis spécifiés dans les paramètres de l’organisation apparaissent dans la liste des sources de recherche et se comportent dans l’application comme dans une carte Web ou dans Map Viewer ou Map Viewer Classic.

Procédez comme suit pour activer un localisateur en tant que source de recherche :

1. Le cas échéant, cochez la case Activer un outil de recherche en haut de l'onglet Rechercher.
2. Cochez la case en regard du localisateur à activer.
3. Vous pouvez également cliquer sur Edit (Modifier) en regard du localisateur pour configurer des paramètres supplémentaires. Cliquez sur Enregistrer lorsque vous avez terminé.

Activer une couche d’entités pouvant faire l’objet d'une recherche en tant que source de recherche

Si une couche d'entités pouvant faire l'objet d'une recherche est détectée sur la carte web, elle apparaît dans la liste des sources de recherche, identifiée par son nom.

Procédez comme suit pour activer une couche d'entités pouvant faire l'objet d'une recherche en tant que source de recherche :

1. Le cas échéant, cochez la case Activer un outil de recherche en haut de l'onglet Rechercher.
2. Cochez la case en regard de la couche d'entités pouvant faire l'objet d'une recherche que vous voulez activer.
3. Cliquez sur Modifier en regard du nom de la couche et choisissez un champ de recherche dans la liste Champs de recherche.

   Remarque :

   Vous devez déclarer un champ de recherche pour que la recherche par couche d'entités fonctionne.

4. Cliquez sur Save (Enregistrer).

Activer plusieurs sources de recherche

Vous pouvez activer plusieurs sources de recherche dans une seule application. Ceci est utile lorsque les utilisateurs de l’application risquent de devoir effectuer des recherches dans plusieurs sources d’informations pour utiliser l’application. N'oubliez pas l'objectif de l'application et n'activez pas de sources de recherche qui n'ont pas trait à cet objectif, car ceci risque d'entraîner une certaine confusion chez l'utilisateur final. Par exemple, si l’objectif de l’application est de localiser et de mettre à jour les états des tâches de la maintenance des passages pour piétons dans une localité, il n’est pas utile d’activer un localisateur mondial, car ceci peut éloigner l’utilisateur final de l’étendue de la localité où se situent toutes les entités de maintenance des passages pour piétons.

Pour activer plusieurs sources de recherche, procédez comme suit :

1. Le cas échéant, cochez la case Activer un outil de recherche en haut de l'onglet Rechercher.
2. Cochez les cases en regard des sources de recherche à activer.
3. Cliquez sur Modifier en regard de chaque source pour confirmer ou configurer les paramètres requis.
4. Cliquez sur Save (Enregistrer).
5. Sur l'onglet Rechercher, procédez de l'une des manières suivantes :
   • Si vous souhaitez privilégier une des sources de recherche et la définir par défaut, sélectionnez-la dans le menu déroulant Sélectionner la source par défaut. L'utilisateur de l'application pourra choisir parmi les autres sources de recherche dans l'application.
   • Si vous souhaitez que, par défaut, l'application réalise une recherche dans toutes les sources en même temps, cochez la case Rechercher dans toutes les sources et sélectionnez Tout dans le menu déroulant Sélectionner la source par défaut.

   Toutes les sources pour lesquelles des suggestions sont configurées apparaissent dans le menu déroulant si des résultats potentiels sont trouvés en fonction du terme de recherche entrée.

Activer la recherche avec plusieurs champs

Il est possible de parcourir plusieurs champs au sein d'une source de recherche. Vous pouvez, par exemple, autoriser les utilisateurs de votre application à trouver une entité en fonction de différents types d’informations, comme rechercher une entité de parcelle en fonction de son numéro d’ID ou du nom de son propriétaire.

Pour activer la recherche avec plusieurs champs, procédez comme suit :

1. Le cas échéant, cochez la case Activer un outil de recherche en haut de l'onglet Rechercher.
2. Cliquez sur Modifier en regard de la source de recherche dans la liste.
3. Dans la liste Search Fields (Champs de recherche), cliquez sur un des champs et appuyez sur la touche Ctrl tout en cliquant sur les autres champs que vous voulez activer pour la recherche.
4. Cliquez sur Save (Enregistrer).

Lorsque vous configurez une recherche avec plusieurs champs, il est recommandé de configurer également les suggestions et de personnaliser un modèle de suggestion, comme expliqué dans les sections suivantes.

Configurer les suggestions

Si vous activez les suggestions pour votre application, les résultats potentiels apparaissent dans le menu déroulant de recherche pour que les utilisateurs puissent les choisir lorsqu'ils entrent une valeur de recherche. Les suggestions sont utiles lorsque l'utilisateur connaît une partie, mais pas l'intégralité, d'un terme de recherche exact. Elles sont également utiles pour permettre aux utilisateurs de l'application de choisir plus rapidement le résultat approprié dans une liste après avoir saisi quelques caractères clés. Les suggestions sont également recommandées lorsque plusieurs champs de recherche ont été configurés pour une source de recherche.

Pour configurer les suggestions, procédez comme suit :

1. Le cas échéant, cochez la case Activer un outil de recherche en haut de l'onglet Rechercher.
2. Cliquez sur Modifier en regard de la source de recherche dans la liste.
3. Cochez la case Activer les suggestions.
4. Dans le menu déroulant Nombre maximal de suggestions, choisissez le nombre maximal de suggestions voulu à afficher simultanément.
5. Pour les couches d'entités pouvant faire l'objet d'une recherche, procédez comme suit :
   1. Choisissez Champ ou Modèle.
   2. Configurez les paramètres supplémentaires en fonction de vos besoins.
6. Cliquez sur Save (Enregistrer).

Créer des modèles de suggestions

Lorsque vous configurez la recherche sur une couche pouvant faire l'objet d'une recherche, vous pouvez utiliser un modèle de suggestion pour afficher plusieurs champs dans une suggestion ou lorsque vous voulez personnaliser l'apparence des suggestions dans le menu déroulant de recherche de l'application.

Pour configurer un modèle de suggestion, procédez comme suit :

1. Le cas échéant, cochez la case Activer un outil de recherche en haut de l'onglet Rechercher.
2. Cliquez sur Modifier en regard de la couche pouvant faire l'objet d'une recherche dans la liste.
3. Cochez la case Activer les suggestions.
4. Cliquez sur Modèle et saisissez votre modèle de suggestion.

   La syntaxe de base est ${fieldname}, où vous remplacez fieldname par le nom du champ dont la valeur va s'afficher. Par exemple, pour créer une chaîne de suggestion qui allie une valeur de champ de type d'arbre et une valeur de champ de nom de parc, vous pouvez utiliser la syntaxe suivante :

   Tree Type: ${treeType}, Park: ${parkName}

   Cette chaîne permet de présenter une suggestion comme celle-ci aux utilisateurs de l'application :

   Tree Type: Dogwood, Park: Eastland Community Park

5. Cliquez sur Save (Enregistrer).