Skip to content
GeoViewer 5

AddDataFromUrl

AddDataFromUrl

Nom fonctionnel: Ajout depuis une URL

À quoi sert ce widget ?

Ajoute un service distant à partir de son URL (WMS, WMTS, ArcGIS, etc.) avec validation minimale.

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

  • Champ URL et détection du type de service cartographique.
  • Options de sélection de couche/sous-couche pour les services complexes.
  • Messages de validation réseau, CORS et compatibilité.

Parcours utilisateur (le plus courant)

  • Collez l’URL du service puis lancez la détection.
  • Sélectionnez les couches utiles si plusieurs niveaux sont disponibles.
  • Validez l’ajout puis contrôlez l’affichage sur la carte.

Exemples concrets

  • Ajouter un service métier depuis le catalogue pour une analyse ponctuelle.
  • Importer un fichier utilisateur pour contextualiser une intervention terrain.
  • Précharger des données récurrentes via des presets pour gagner du temps.

Configuration (aperçu)

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

Exemple avancé

{
    "widgetId": "add-data-from-url-advanced",
    "widgetClass": "AddDataFromUrl",
    "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-from-url-01.png: widget ouvert avec configuration standard.
  • (Capture à ajouter) /assets/screenshots/TODO/add-data-from-url-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