Création de cartes géographiques

Modifié par jhurst le 2021/11/15 09:22

Ce document décrit la création de cartes géographiques.

Préambule

Ce document présente les informations nécessaires à la création de cartes supplémentaires.

Un ensemble de fichiers est fourni pour permettre la création de ces cartes :

  • map_name_helper_v6.xlsm
  • mapchart1-template-dashboard_canvas.html
  • mapchart1-template-dashboard_svg.svg
  • mapchart1-template-dashboard_vml.html
  • vectortool.jar
  • convert_maps_dbf.bat
  • convert_maps.bat

Ces fichiers se trouvent dans le répertoire <DD Install>/add-ons/custommap.

Le nom des cartes doit être en minuscule.

Si vous souhaitez importer vos cartes depuis GIS, un fichier importfromgis.jar peut également vous être fourni (contactez nous par email à support@digdash.com).

Importation de cartes depuis GIS

Vous pouvez importer vos cartes existantes (fichiers shp) à l'aide de la commande

java -jar importfromgis.jar -i inputfile.shp -o output.svg

Remplacer inputfile.shp par le nom de votre fichier shp et output.svg par le nom de votre fichier svg de sortie.

Attention : vous devez placer votre fichier inputfile.shx dans le même répertoire que inputfile.shp

Configuration des cartes

Nous recommandons l'utilisation du fichier map_name_helper_v6.xlsm.

Insérez les différents éléments de votre carte dans la feuille src (un élément par ligne, écrasez la première ligne du fichier)

La première colonne doit contenir l'id de l'élément (l'id doit être préfixé avec le code pays comme FR pour France).

La seconde colonne doit contenir le nom de l 'élément provenant de votre fichier dbf.

Modifier le fichier de définition des cartes

Éditez le fichier <DD Install>\apache-tomcat\webapps\ddenterpriseapi\WEB-INF\classes\resources\config\mapworld-data.xml

Ajoutez le contenu de la feuille maplist.xml du fichier map_name_helper_v6.xlsm dans mapworld-data.xml.

Attention : Attachez vos sections <item...> au bon parent

Format de la section « item » :

  • id : (obligatoire) id utilisé dans la carte SVG.
  • names : (optionnel) nom du fichier (.properties) contenant les traductions ou variantes pour cet id.
  • map : (optionnel) « no » lorsque l'élément ne peut pas être exploré.

Créez vos fichiers de correspondances d'id

Ce fichier optionnel permettra de trouver les différentes correspondances entre l'id utilisé dans les cartes et vos membres racines dans la dimension géographique.

Copiez le contenu de la feuille -names.js obtenu dans le fichier map_name_helper_v6.xlsm dans un fichier intitulé <id_carte>-l1-names.js .

Ce fichier doit être copié dans 3 dossiers différents :

  • <DD Install>\apache-tomcat\webapps\ddenterpriseapi\staticwebcontent\charts\template\
     scripts\mapnames\
  • <DD Install>\apache-tomcat\webapps\digdash_dashboard\staticwebcontent\charts\template\
     scripts\mapnames\
  • <DD Install>\apache-tomcat\webapps\ddenterpriseapi\WEB-INF\classes\resources
     \charts\template\scripts\mapnames

Pour chacun de ces 3 dossiers, placez la carte dans le sous répertoire correspondant à la carte parent.

Créez vos fichiers de traductions

Ce fichier optionnel permettra de trouver les différentes traductions pour les zones affichées sur la carte.

Copier le contenu de la feuille .properties obtenu dans le fichier map_name_helper_v6.xlsm à l'emplacement suivant :

<DD Install>\apache-tomcat\webapps\ddenterpriseapi\WEB-INF\classes\messages\<parentmap_or_specific>.properties

Attention : Vérifiez le nom du fichier parent  .properties  dans mapworld-data.xml.
Ajoutez vos propres fichiers .properties ou le parent pourra être écrasé lors de la prochaine mise à jour du produit.

Génération des fichiers graphiques des cartes

Programme requis :

  • vectortool.jar  (fourni par DigDash , nécessite une jre)

Fichiers requis :

  • mapchart1-template-dashboard_canvas.html
  • mapchart1-template-dashboard_svg.svg
  • mapchart1-template-dashboard_vml.html

Scripts requis :

  • convert_maps_dbf.bat : Des fichiers .dbf, comprenant le com des composants des cartes sont souvent fournis avec les Shapefile. L'utilisation du script convert_maps_dbf.bat vous permet d'associer les Ids des dbf aux formes SVG dans l'ordre.
  • Ou convert_map.bat : si vous n'utilisez pas de fichiers dbf

Changez les variables dans le fichier script selon vos paramètres.

Exécutez le script convert_maps_dbf.bat ou convert_maps.bat.

Déploiement des cartes

Copiez le contenu du dossier output généré à l'étape III dans :

  • <DD Install>\apache-tomcat\webapps\ddenterpriseapi\staticwebcontent\charts\template\
  • <DD Install>\apache-tomcat\webapps\digdash_dashboard\staticwebcontent\charts\template\
  • <DD Install>\apache-tomcat\webapps\ddenterpriseapi\WEB-INF\classes\resources\charts\template\