Skip to content
GeoViewer 5

AddDataCatalog

AddDataCatalog

Nom fonctionnel: Catalogue de données

À quoi sert ce widget ?

Connecte l’utilisateur au catalogue de données pour rechercher, filtrer et ajouter des services rapidement.

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

Quand l’activer

  • Quand vous devez enrichir la carte en cours de session.
  • Quand plusieurs sources de données doivent être proposées à l’utilisateur.
  • Quand vous voulez un parcours homogène pour les profils non techniques.

En clair

  • Côté utilisateur: L’utilisateur gagne du temps: il trouve ses données sans quitter l’application.
  • Côté intégration: Vérifiez la qualité des services (CORS, projection, disponibilité) avant mise en production.

Prise en main

Accéder au widget

  • Ouvrez le widget depuis la barre d’outils ou le conteneur configuré.
  • Vérifiez que la carte est chargée avant de lancer un ajout de données.

Le configurer sans se tromper

  • Choisissez la source de données (catalogue, URL, fichier ou preset selon le widget).
  • Renseignez les paramètres minimums puis validez l’ajout.

Ce que l’utilisateur voit

  • Recherche dans le catalogue avec filtres thématiques.
  • Liste de résultats avec métadonnées utiles (source, type, description).
  • Action d’ajout direct vers la carte.

Parcours utilisateur (le plus courant)

  • Sélectionnez une source, recherchez ou parcourez les résultats.
  • Ajoutez une couche, puis vérifiez sa présence dans la table des contenus.
  • Ajustez ensuite visibilité, ordre et opacité dans le TOC.

Exemples concrets

  • Permettre à l’utilisateur de trouver une donnée sans connaître son URL.
  • Réduire les erreurs de saisie en privilégiant des sources référencées.
  • Faciliter l’onboarding des nouveaux utilisateurs métier.

Configuration (aperçu)

OptionTypeDéfautDescription
widgetIdstring-Identifiant unique de l’instance AddDataCatalog.
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": "add-data-catalog",
    "widgetClass": "AddDataCatalog",
    "active": false,
    "inToolbar": true,
    "config": {}
}

Exemple avancé

{
    "widgetId": "add-data-catalog-advanced",
    "widgetClass": "AddDataCatalog",
    "active": true,
    "handleOpenAtStartup": false,
    "inToolbar": {
        "type": "button",
        "toolbarId": "default-toolbar",
        "order": 10
    },
    "onActivate": {
        "deactivate": {
            "classes": []
        }
    },
    "config": {}
}

Points d’attention

  • Une URL affichable dans le navigateur n’est pas toujours exploitable côté service carto.
  • Sans projection cohérente, la couche peut être chargée mais non visible.
  • Les droits API limitent parfois la liste des données affichées.

Dépannage

SymptômeVérification rapide
La couche ne s’ajoute pas.Vérifiez l’URL, le type de service et l’accessibilité réseau.
La couche est ajoutée mais invisible.Vérifiez l’emprise, la projection et l’échelle de visibilité.

FAQ

Peut-on restreindre les options proposées ?

Oui. Affichez uniquement les sous-widgets utiles pour votre contexte métier.

Les couches ajoutées sont-elles visibles dans le TOC ?

Oui, si la couche est valide et acceptée par la configuration runtime.

Captures à ajouter

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

Liens PDF source

  • Aucun PDF de référence détecté automatiquement pour ce widget.

Aller plus loin