WebSphere Dashboard Framework: Creating custom maps

If your project requires a map that is not included with the default WebSphere Dashboard Framework maps, you can use IBM ILOG JViews Maps to modify a default style. This article describes two methods for customizing maps:

• Using ILOG JViews Maps to work with layers to create custom maps.
• Using ILOG JViews Maps to create a map file and edit it in a text editor.

Customizing and converting maps to .shp files

WebSphere Dashboard Framework leverages ESRI Shapefile (.shp) files to render maps. Such map files are available from a variety of sources, including those on the Internet, but be sure to adhere to copyright and download requirements if you use them. To avoid any legal questions concerning the use of third-party maps, you can create your own maps from the world map and United States map provided with WebSphere Dashboard Framework instead. The ILOG JViews Maps builder tool also gives you the ability to convert other maps to the .shp format from other well known formats, such as TIGER/Line, MapInfo Interchange Format, GTOP30-DEM, GeoTIFF, DTED, and so on.

Customizing a map using ILOG JViews Maps
This example shows you how to create a new single-country map from the world map that ships with WebSphere Dashboard Framework.

1. Open ILOG JViews Maps - Map Builder.
2. Click File -> New Map.
3. Click File -> Add Map Data to add the world map.
4. Navigate to the WebContent\solutions\dashboard\chartstyles folder in your WebSphere Dashboard Framework workspace project folder. Select the world map and click Open.
   
5. Save the map with a new name in the chartstyles folder. Save the file in .ivl format, which saves the map as plain text.
   
6. In the Map Layers tab, double-click the layer ESRI/Shape to see the layers in this map.
   The default world map has one layer called "ESRI/Shape."
7. Right-click ESRI/Shape and click Create Filtered Layer.
   
   This option allows you to create children layers (for example, layers by continent or country). Using the ILOG JViews Maps builder tool, you can create a map with units as small as a single country from the world map and a state from the United States map. The option Create Simplified Layers creates layers that produce a smaller file size.
   
8. Select the criteria for the filtered layer. For this example, select "CONTINENT," Equals," "South America."
9. Save the file.
10. Click File -> Export to export the new map file.
11. In Limits, input proper Lon & Lat, so that only the required map part is exported. Otherwise, the result map may result into a small map, with a lot of white space around it.
12. Click File -
     
    Export.
13. Select Export to Shape.
14. Click Setting to select the folder you want this result map be saved to.
15. Click Export to save the .shp file with the name and location you chose.

You can now use the resulting .shp file in a Dashboard Framework application.

Using ILOG JViews Maps and a text editor to customize maps
If you are unable to do the customizing you want to do with layers in the Map Builder tool, follow these steps to create a map file in ILOG JViews Maps and then use a text editor to change specific values in the map.

1. Open ILOG JViews Maps - Map Builder.
2. Click File -> New Map.
3. Click File -> Add Map Data to add the map you want to customize.
4. Save the file in .ivl format, which saves the map as plain text.
5. Open the .ivl file in a text editor.
6. Make the changes you want to make and save the file.
7. Open the JVIews Maps Map builder and click File -> Open Prepared Map to open the .ivl file you edited.
8. Click File -> Export.
9. Select Export to Shape.
10. Click Setting to select the folder you want this result map be saved to.
11. Click Export to save the .shp file with the name and location you chose.

You can now use the resulting .shp file in a Dashboard Framework application.