Skip to content
GeoViewer 5

AddData

AddData

Nom fonctionnel: Ajout de données

1. Introduction

Si Geoviewer était un couteau suisse, AddData serait la lame “indispensable”: ajouter une couche sans sortir de la carte.

Il sert de point d’entrée unique pour:

  • chercher une donnée (recherche + filtres),
  • choisir parmi des catégories,
  • ajouter des couches “populaires”,
  • et, si vous l’autorisez, passer par des options avancées (URL / fichier).

Ce widget est particulièrement utile quand vous voulez que l’utilisateur puisse enrichir sa carte “à la demande”, sans dépendre d’un administrateur à chaque besoin.

Le parcours en 30 secondes

  1. Ouvrez AddData.
  2. Tapez 2 ou 3 mots dans “Chercher une donnée”.
  3. Affinez avec “Filtrer”, puis “Trier” (alphabétique ou vues prédéfinies).
  4. Cochez une ou plusieurs couches.
  5. Cliquez sur “Ajouter les données sélectionnées (n)”.
  6. Si besoin, utilisez “Vider” pour repartir proprement.

Astuce: le bouton “Retour” réinitialise la recherche et vous ramène à la liste.

Quand l’utiliser

  • 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: “Je trouve une couche et je l’ajoute” en quelques secondes.
  • Côté intégration: vous contrôlez le périmètre (onglets visibles, sources, comportements après ajout).

2. Premiers pas

Accéder à l’outil

  • Souvent, AddData est exposé via un bouton (toolbar ou TOC) du type “Ajouter une couche”.
  • À l’ouverture, l’utilisateur arrive sur un panneau avec recherche et onglets selon votre configuration.

Configurer le widget

  1. Décidez quels onglets sont visibles (pour éviter de donner une “boîte à outils” trop large).
  2. Décidez quoi faire après ajout:
    • fermer le panneau (closeOnMapServiceAdded),
    • ouvrir le TOC (openTocOnMapServiceAdded).
  3. Vérifiez l’UX: recherche, filtres, tri, puis ajout.

Les principaux éléments du widget

  • Champ de recherche (“Chercher une donnée”) + bouton “Retour” pour réinitialiser.
  • Menus “Filtrer” (thématiques) et “Trier” (alphabétique, vues prédéfinies).
  • Liste de résultats avec cases à cocher + action “Ajouter les données sélectionnées (n)”.
  • Actions de confort: “Vider” (désélectionner et repartir de zéro).
  • Onglets (populaires, catégories, vues prédéfinies, options avancées, catalogue… selon votre configuration).

3. Utilisation

  • L’utilisateur cherche une donnée, la sélectionne, puis confirme l’ajout.
  • Une fois la couche ajoutée, elle apparaît dans le TOC (et, selon votre config, le TOC s’ouvre automatiquement).
  • Ensuite, le parcours naturel est: visibilité, ordre, opacité, puis analyse.

4. Exemples et scénarios

  • “Socle métier”: proposer quelques couches populaires, ajout en un clic.
  • “Analyse ponctuelle”: chercher une couche, l’ajouter, puis la retirer après usage.
  • “Profil non technique”: masquer les options avancées et garder uniquement catégories + populaires.

5. Configuration de base

OptionTypeDéfautDescription
widgetIdstring-Identifiant unique de l’instance.
activebooleanfalseOuvre le widget au démarrage.
inToolbarboolean ou objet ou stringselon widgetAffichage dans une toolbar (souvent un bouton).
containerstring ou objetdialogConteneur de rendu (par défaut: dialog draggable).
config.visibleTabs.popularsbooleantrueAffiche l’onglet “Populaires”.
config.visibleTabs.categoriesbooleantrueAffiche l’onglet “Catégories”.
config.visibleTabs.predefinedViewsbooleantrueAffiche l’onglet “Vues prédéfinies”.
config.visibleTabs.advancedOptionsbooleantrueAffiche l’onglet “Options avancées” (URL/fichier).
config.visibleTabs.catalogbooleanfalseAffiche l’onglet “Catalogue”.
config.closeOnMapServiceAddedbooleantrueFerme le widget après ajout d’une couche.
config.openTocOnMapServiceAddedbooleantrueOuvre le TOC après ajout d’une couche.

6. Avancé

Recommandation: pour un public large, commencez avec peu d’onglets visibles. Vous pourrez élargir ensuite.

Les sous-widgets (pour aller plus loin)

AddData est un hub: chaque onglet correspond souvent à un sous-widget. Pour documenter un parcours “propre”, allez voir aussi:

Exemple minimal (copier-coller)

{
    "widgetId": "add-data",
    "widgetClass": "AddData",
    "active": false,
    "inToolbar": true,
    "config": {}
}

Exemple avancé

{
    "widgetId": "add-data-metier",
    "widgetClass": "AddData",
    "active": false,
    "inToolbar": { "type": "button", "toolbarId": "default-toolbar", "order": 1 },
    "config": {
        "visibleTabs": {
            "populars": true,
            "categories": true,
            "predefinedViews": true,
            "advancedOptions": false,
            "catalog": false
        },
        "closeOnMapServiceAdded": true,
        "openTocOnMapServiceAdded": true
    }
}

Points d’attention

  • “Visible” ne veut pas dire “accessible”: certaines sources peuvent être filtrées par droits ou indisponibles selon l’environnement.
  • Un service “ouvrable” dans un navigateur peut échouer côté viewer (CORS, projection, sous-couches).
  • Si vous laissez l’ajout via URL/fichier, préparez un parcours support: diagnostics et dépannage seront plus fréquents.

7. 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 (CORS).
La couche est ajoutée mais invisible.Vérifiez l’emprise, la projection et l’échelle de visibilité.
L’utilisateur “se perd” dans le widget.Réduisez visibleTabs et simplifiez les catégories.

8. FAQ

Peut-on restreindre les options proposées ?

Oui, et c’est souvent recommandé: masquez certains onglets via visibleTabs.

Quels événements sont publiés ?

AddData publie des événements de topic (ex: ajout depuis catégories, URL, fichier). Vous pouvez les écouter via l’événement DOM topic du Web Component.

9. Captures à ajouter

  • (Capture à ajouter) /assets/screenshots/TODO/add-data-01.png: panneau AddData ouvert (recherche + onglets).
  • (Capture à ajouter) /assets/screenshots/TODO/add-data-02.png: sélection + bouton “Ajouter les données sélectionnées” actif.

Liens PDF source

  • 183107703_0b5d945379e243329e7da6f4d8adda0f-120226-0856-80.pdf

Aller plus loin