AdvancedSearch
AdvancedSearch
Nom fonctionnel: Recherche métier avancée
À quoi sert ce widget ?
Fournit une recherche métier structurée (parcelle, route, segmentation, coordonnées) selon vos flux opérationnels.
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
- Onglets de recherche avancée (parcelle, coordonnées, segmentation, etc.).
- Formulaires orientés métier avec contrôles de validité.
- Navigation entre résultats et recentrage cartographique.
Parcours utilisateur (le plus courant)
- Lancez la recherche, puis sélectionnez un résultat pertinent.
- Contrôlez la mise en évidence et le zoom automatique sur l’objet.
- Réitérez avec un autre critère sans quitter la carte.
Exemples concrets
- Rechercher une entité cadastrale avec critères précis.
- Localiser une infrastructure via identifiant métier.
- Passer rapidement de la recherche au diagnostic cartographique.
Configuration (aperçu)
| Option | Type | Défaut | Description |
|---|---|---|---|
widgetId | string | - | Identifiant unique de l’instance AdvancedSearch. |
active | boolean | false | Active l’ouverture du widget au démarrage. |
inToolbar | boolean ou objet ou string | selon widget | Définit si le widget est visible dans une toolbar, et sous quelle forme. |
container | string ou objet | selon widget | Choisit 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
- Référence technique du widget: Référence technique du widget
- Schéma principal:
schemas/advancedSearchFullConfigSchema - API technique du widget:
types/AdvancedSearchFullConfig - Code source (déclaration):
packages/common/src/lib/widgets/advanced-search/advanced-search.declaration.ts - Code source (config):
packages/common/src/lib/widgets/advanced-search/advanced-search.config.ts
Exemple minimal (copier-coller)
{ "widgetId": "advanced-search", "widgetClass": "AdvancedSearch", "active": false, "inToolbar": true, "config": {}}Exemple avancé
{ "widgetId": "advanced-search-advanced", "widgetClass": "AdvancedSearch", "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ôme | Vé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/advanced-search-01.png: widget ouvert avec configuration standard. - (Capture à ajouter)
/assets/screenshots/TODO/advanced-search-02.png: interaction principale et résultat attendu.
Liens PDF source
US021 - Outil de recherche cadas_156a6e7ad6714a0f80ef2926473c911b-120226-0858-116.pdf