Skip to content

AddDataPopulars

AddDataPopulars

Nom fonctionnel: Données populaires

À quoi sert ce widget ?

Propose un accès rapide aux couches les plus utilisées dans votre contexte métier.

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élection des couches populaires préparées par contexte.
  • Actions d’ajout en un clic pour les jeux de données récurrents.
  • Retour immédiat sur la disponibilité des couches proposées.

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

  • Démarrer rapidement une carte avec le socle de données attendu.
  • Réduire le nombre de clics pour les usages quotidiens.
  • Standardiser les couches affichées entre équipes.

Configuration (aperçu)

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

Exemple avancé

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