Modifié par jhurst le 2024/04/02 14:25
Masquer les derniers auteurs
jhurst 1.1 1 Création de cartes géographiques
2
3 {{ddtoc/}}
4
5 ----
6
7 = Préambule =
8
9 Ce document présente les informations nécessaires à la création de cartes supplémentaires.
10
11 Un ensemble de fichiers est fourni pour permettre la création de ces cartes :
12
13 * map_name_helper_v6.xlsm
14 * mapchart1-template-dashboard_canvas.html
15 * mapchart1-template-dashboard_svg.svg
16 * mapchart1-template-dashboard_vml.html
17 * vectortool.jar
18 * convert_maps_dbf.bat
19 * convert_maps.bat
20
21 Ces fichiers se trouvent dans le répertoire **<DD Install>**/add-ons/custommap.
22
23 Si vous souhaitez importer vos cartes depuis GIS, un fichier importfromgis.jar peut également vous être fourni (contactez nous par email à [[support@digdash.com>>path:mailto:support@digdash.com]]).
24
25 = Importation de cartes depuis GIS =
26
27 Vous pouvez importer vos cartes existantes (fichiers shp) à l'aide de la commande
28
29 {{code language="bash"}}
30 java -jar importfromgis.jar -i inputfile.shp -o output.svg
31 {{/code}}
32
33 Remplacer **inputfile.shp** par le nom de votre fichier shp et **output.svg** par le nom de votre fichier svg de sortie.
34
35 (% class="box warningmessage" %)
36 (((
37 //Attention : vous devez placer votre fichier inputfile.shx dans le même répertoire que inputfile.shp//
38 )))
39
40 = Configuration des cartes =
41
42 Nous recommandons l'utilisation du fichier **map_name_helper_v6.xlsm**.
43
44 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)
45
46 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).
47
48 La seconde colonne doit contenir le nom de l 'élément provenant de votre fichier dbf.
49
50 == Modifier le fichier de définition des cartes ==
51
52 Éditez le fichier **<DD Install>\apache-tomcat\webapps\ddenterpriseapi\WEB-INF\classes\resources\config\mapworld-data.xml**
53
54 Ajoutez le contenu de la feuille **maplist.xml **du fichier** map_name_helper_v6.xlsm **dans** mapworld-data.xml**.
55
56 (% class="box warningmessage" %)
57 (((
58 //Attention : Attachez vos sections// **<item...>** //au bon parent//
59 )))
60
61 Format de la section « item » :
62
63 * id : (obligatoire) id utilisé dans la carte SVG.
64 * names : (optionnel) nom du fichier (.properties) contenant les traductions ou variantes pour cet id.
65 * map : (optionnel) « no » lorsque l'élément ne peut pas être exploré.
66
67 == Créez vos fichiers de correspondances d'id ==
68
69 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.
70
71 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 **.
72
73 Ce fichier doit être copié dans 3 dossiers différents :
74
75 * **<DD Install>\**apache-tomcat\webapps\ddenterpriseapi\staticwebcontent\charts\template\
76 scripts\mapnames\
77 * **<DD Install>\**apache-tomcat\webapps\digdash_dashboard\staticwebcontent\charts\template\
78 scripts\mapnames\
79 * **<DD Install>\**apache-tomcat\webapps\ddenterpriseapi\WEB-INF\classes\resources
80 \charts\template\scripts\mapnames
81
82 Pour chacun de ces 3 dossiers, placez la carte dans le sous répertoire correspondant à la carte parent.
83
84 == Créez vos fichiers de traductions ==
85
86 Ce fichier optionnel permettra de trouver les différentes traductions pour les zones affichées sur la carte.
87
88 Copier le contenu de la feuille **.properties** obtenu dans le fichier **map_name_helper_v6.xlsm **à l'emplacement suivant :
89
90 **<DD Install>\**apache-tomcat\webapps\ddenterpriseapi\WEB-INF\classes\messages\<parentmap_or_specific>.properties
91
92
93 (% class="box warningmessage" %)
94 (((
95 //Attention : Vérifiez le nom du fichier parent **.properties**  dans **mapworld-data.xml**.
96 Ajoutez vos propres fichiers **.properties** ou le parent pourra être écrasé lors de la prochaine mise à jour du produit.//
97 )))
98
99 = Génération des fichiers graphiques des cartes =
100
101 Programme requis :
102
103 * vectortool.jar**  **(fourni par DigDash , nécessite une jre)
104
105 Fichiers requis :
106
107 * mapchart1-template-dashboard_canvas.html
108 * mapchart1-template-dashboard_svg.svg
109 * mapchart1-template-dashboard_vml.html
110
111 Scripts requis :
112
113 * 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.
114
115 * //Ou// convert_map.bat : si vous n'utilisez pas de fichiers dbf
116
117 Changez les variables dans le fichier script selon vos paramètres.
118
119 Exécutez le script convert_maps_dbf.bat ou convert_maps.bat.
120
121 = Déploiement des cartes =
122
123 Copiez le contenu du dossier **output** généré à l'étape III dans :
124
125 * **<DD Install>\**apache-tomcat\webapps\ddenterpriseapi\staticwebcontent\charts\template\
126 * **<DD Install>\**apache-tomcat\webapps\digdash_dashboard\staticwebcontent\charts\template\
127 * **<DD Install>\**apache-tomcat\webapps\ddenterpriseapi\WEB-INF\classes\resources\charts\template\