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