Skip to content
GeoViewer 5

AddDataFromFile

AddDataFromFile

Nom fonctionnel: Ajout depuis un fichier

À quoi sert ce widget ?

Importe des fichiers géographiques utilisateur pour les exploiter immédiatement dans le viewer.

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

  • Sélecteur de fichier local et validation de format.
  • Gestion des projections et options d’import.
  • Retour utilisateur en cas de fichier invalide ou partiellement lisible.

Parcours utilisateur (le plus courant)

  • Importez un fichier depuis votre poste puis confirmez les paramètres de lecture.
  • Vérifiez le placement de la couche dans le TOC après import.
  • Ajustez style et visibilité avant de partager l’analyse.

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 AddDataFromFile.
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-file",
    "widgetClass": "AddDataFromFile",
    "active": false,
    "inToolbar": true,
    "config": {}
}

Exemple avancé

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