Skip to content
GeoViewer 5

GlobalSearch

GlobalSearch

Nom fonctionnel: Recherche transversale

À quoi sert ce widget ?

Centralise les recherches transversales pour retrouver rapidement un lieu, un objet ou une couche.

Conseil: un viewer “trop outillé” devient vite bruyant. Activez ce widget uniquement s’il sert un parcours utilisateur clair.

Quand l’activer

  • Quand l’utilisateur doit trouver une information spatiale en peu d’étapes.
  • Quand plusieurs sources de recherche doivent être regroupées dans un seul point d’entrée.
  • Quand les critères métier doivent guider la recherche.

En clair

  • Côté utilisateur: La recherche devient plus fiable et plus rapide pour les équipes opérationnelles.
  • Côté intégration: Contrôlez les services de recherche actifs et les performances des appels multi-sources.

Prise en main

Accéder au widget

  • Activez le widget depuis la barre d’outils ou le champ de recherche principal.
  • Assurez-vous que les services de recherche sont disponibles.

Le configurer sans se tromper

  • Saisissez un critère métier (adresse, parcelle, route, objet, etc.).
  • Affinez la recherche si plusieurs groupes de résultats apparaissent.

Ce que l’utilisateur voit

  • Champ de recherche central “Que cherchez-vous ?”.
  • Groupes de résultats: lieux, coordonnées, parcelles, routes, couches, objets.
  • Historique de recherche selon configuration.

Parcours utilisateur (le plus courant)

  • Saisissez au moins 2 caractères pour déclencher la recherche.
  • Choisissez un résultat dans le groupe pertinent.
  • La carte zoome, se centre et met l’objet en surbrillance.

Exemples concrets

  • Retrouver rapidement une adresse terrain et recentrer la carte.
  • Localiser une parcelle à partir de sa capakey.
  • Trouver une couche du catalogue depuis une recherche transversale.

Configuration (aperçu)

OptionTypeDéfautDescription
widgetIdstring-Identifiant unique de l’instance GlobalSearch.
activebooleanfalseActive l’ouverture du widget au démarrage.
inToolbarboolean ou objet ou stringselon widgetDéfinit si le widget est visible dans une toolbar, et sous quelle forme.
containerstring ou objetselon widgetChoisit le conteneur de rendu (drawer, dialog, floating, toolbar-tabs, hidden).

Pour le détail complet (et toujours à jour), utilisez la référence technique et le schéma ci-dessous.

Liens techniques et code

Exemple minimal (copier-coller)

{
    "widgetId": "global-search",
    "widgetClass": "GlobalSearch",
    "active": false,
    "inToolbar": true,
    "config": {}
}

Exemple avancé

{
    "widgetId": "global-search-advanced",
    "widgetClass": "GlobalSearch",
    "active": true,
    "handleOpenAtStartup": false,
    "inToolbar": {
        "type": "button",
        "toolbarId": "default-toolbar",
        "order": 10
    },
    "onActivate": {
        "deactivate": {
            "classes": []
        }
    },
    "config": {}
}

Points d’attention

  • Des critères trop courts produisent souvent des résultats bruités.
  • Sans source configurée, certains groupes restent vides par conception.
  • Le format de coordonnées doit être cohérent avec la projection attendue.

Dépannage

SymptômeVérification rapide
Aucun résultat ne remonte.Vérifiez les sources actives et la connectivité des services.
Le clic sur un résultat ne centre pas la carte.Contrôlez la géométrie retournée et la projection.

FAQ

Peut-on personnaliser les sources interrogées ?

Oui, via la configuration du widget et du contexte.

L’historique est-il conservé ?

Oui pour les flux qui activent explicitement cet historique.

Captures à ajouter

  • (Capture à ajouter) /assets/screenshots/TODO/global-search-01.png: widget ouvert avec configuration standard.
  • (Capture à ajouter) /assets/screenshots/TODO/global-search-02.png: interaction principale et résultat attendu.

Liens PDF source

  • Recherche transversale_90fe7fc0defc422b8d1526d99dc22a64-120226-0848-34.pdf
  • US009 - Recherche transversale_40e32128ea7e468e8fe0f9ef5aed7957-120226-0856-84.pdf
  • US009a - Historique de recherche_2929a517cccc40f581ec3d24bca56813-120226-0859-140.pdf

Aller plus loin