Language	Title	Date
en	-	-
fr	-	-
es	-	-

Wiki source code of Création de cartes géographiques

Last modified by Aurelie Bertrand on 2025/02/07 10:22

version	line-number	content
4.2	1	This document provides the information necessary to create additional maps in DigDash Enterprise.
	2
1.1	3	{{ddtoc/}}
	4
4.2	5	A set of files is provided by DigDash to allow the creation of these cards:
1.1	6
	7	* map_name_helper_v6.xlsm
	8	* mapchart1-template-dashboard_canvas.html
	9	* mapchart1-template-dashboard_svg.svg
	10	* mapchart1-template-dashboard_vml.html
	11	* vectortool.jar
	12	* convert_maps_dbf.bat
	13	* convert_maps.bat
	14
4.2	15	These files are located in the add-ons / custommap directory.
1.1	16
4.2	17	If you wish to import your maps from GIS, an importfromgis.jar file can also be provided to you (contact us by email at [[support@digdash.com>>path:mailto:support@digdash.com]] ).
3.1	18
4.2	19	*
1.1	20
4.2	21	= Importing Maps from GIS =
1.1	22
4.2	23	You can import your existing maps (shp files) using the command
1.1	24
	25	java -jar importfromgis.jar -i inputfile.shp -o output.svg
	26
4.2	27	Replace inputfile.shp with the name of your shp file and output.svg with the name of your output svg file.
1.1	28
	29	(% class="box warningmessage" %)
	30	(((
4.2	31	//Warning: you must place your inputfile.shx file in the same directory as inputfile.shp//
1.1	32	)))
	33
4.2	34	= card configuration =
1.1	35
4.2	36	We recommend using the map_name_helper_v6.xlsm file .
1.1	37
4.2	38	Insert the different elements of your card in the src sheet (one element per line, overwrite the 1st line of the file)
1.1	39
4.2	40	The 1st column must contain the element's id (the id must be prefixed with the country code like FR for France.)
1.1	41
4.2	42	The second column should contain the name of the element from your dbf file.
1.1	43
4.2	44	== Modifying the card definition file ==
1.1	45
4.2	46	Edit the apache-tomcat \ webapps \ ddenterpriseapi \ WEB-INF \ classes \ resources \ config \ mapworld-data.xml file
1.1	47
4.2	48	Add the contents of the sheet maplist.xml file map_name_helper_v6.xlsm in MapWorld-data.xml .
1.1	49
4.2	50	Attention: Attach your <item ...> sections to the correct parent.
1.1	51
4.2	52	Format of the “item” section:
1.1	53
4.2	54	* id: (required) id used in the SVG card.
	55	* names: (optional) name of the file (.properties) containing the translations or variants for this id.
	56	* map: (optional) "no" when the element cannot be explored.
1.1	57
4.2	58	== Create your ID mapping files ==
1.1	59
4.2	60	This optional file will allow you to find the different correspondences between the id used in the maps and your root members in the geographic dimension.
1.1	61
4.2	62	Copy the content of the -names.js sheet obtained in the map_name_helper_v6.xlsm file into a file called <id_carte> -l1-names, js .
1.1	63
4.2	64	This file must be copied in 3 different folders:
1.1	65
4.2	66	* apache-tomcat\webapps\ddenterpriseapi\staticwebcontent\charts\template\
1.1	67	scripts\mapnames\
4.2	68	* apache-tomcat\webapps\digdash_dashboard\staticwebcontent\charts\template\
1.1	69	scripts\mapnames\
4.2	70	* apache-tomcat\webapps\ddenterpriseapi\WEB-INF\classes\resources
1.1	71	\charts\template\scripts\mapnames
	72
4.2	73	For each of these 3 folders, place the card in the sub-directory corresponding to the parent card.
1.1	74
4.2	75	== Create your translation files ==
1.1	76
4.2	77	This optional file will allow you to find the different translations for the areas displayed on the map.
1.1	78
4.2	79	Copy the content of the .properties sheet obtained in the map_name_helper_v6.xlsm file to the following location:
1.1	80
4.2	81	apache-tomcat\webapps\ddenterpriseapi\WEB-INF\classes\messages\<parentmap_or_specific>.properties
1.1	82
4.2	83	Warning :
1.1	84
	85	(% class="box warningmessage" %)
	86	(((
4.2	87	* Check the name of the parent .properties file in mapworld-data.xml .
	88	* Add your own .properties files or the parent may be overwritten during the next product update.
1.1	89	)))
	90
4.2	91	= Generation of map graphics files =
1.1	92
4.2	93	Program required:
1.1	94
4.2	95	* vectortool.jar (provided by DigDash, requires a jre)
1.1	96
4.2	97	Required files:
1.1	98
	99	* mapchart1-template-dashboard_canvas.html
	100	* mapchart1-template-dashboard_svg.svg
	101	* mapchart1-template-dashboard_vml.html
	102
4.2	103	Scripts required:
1.1	104
4.2	105	* convert_maps_dbf.bat: .dbf files, including the com of card components are often provided with Shapefiles. Using the convert_maps_dbf.bat script allows you to associate the Ids of dbf to SVG forms in order.
1.1	106
4.2	107	* //Or// convert_map.bat: if you are not using dbf files
1.1	108
4.2	109	Change the variables in the script file according to your settings.
1.1	110
4.2	111	Run the convert_maps_dbf.bat or convert_maps.bat script.
1.1	112
4.2	113	= Deployment of CARDS =
1.1	114
4.2	115	Copy the content of the output folder generated in step III in:
1.1	116
4.2	117	* apache-tomcat\webapps\ddenterpriseapi\staticwebcontent\charts\template\
	118	* apache-tomcat\webapps\digdash_dashboard\staticwebcontent\charts\template\
	119	* apache-tomcat\webapps\ddenterpriseapi\WEB-INF\classes\resources\charts\template\
	120
	121

Wiki source code of Création de cartes géographiques

Sommaire