Appboard/2.4/builder/widgets/tile map/registering tilesets

Revision as of 07:05, 3 October 2013 by imported>Jason.nicholls (→‎Registry Format)


The Tile Map widget supports the use of multiple base-layer tilesets and overlay tilesets, but in order to make use of these they must be registered for AppBoard to know about them.

The focus of this page is to document the tile registry for cases where an existing tileset is available remotely. For cases where the intention is to generate your own tileset and/or have AppBoard serve this up locally then refer back to the main Tile Map page for more information.

AppBoard maintains the tile registry in the following directory: [INSTALL_HOME]]/server/webapps/enportal/WEB-INF/xmlroot/appboard/config/tileregistry. All csv files in this directory are loaded and by default the following files are included with the install:

  • default.csv: contains the set of default base-layer tilesets
  • overlays.csv: contains the set of default overlay tilesets
Template-warning.png
The default files should not be modified as they are replaced on upgrade.


The process of registering tilesets is to create a new registry csv file with the correct fields and values, place this into the tile registry directory, and as a best practice ensure this file is included in backup archives (see Backup & Recovery).


Registry Format

This table describes the csv format as used by the tile registry. All fields are required and errors may result in failure to process the entire registry. A good idea is to also look at the default system registry files as examples.

Pos Field Type Description
1 id string
2 name string
3 source string
4 minZoom integer
5 maxZoom integer
6 initialZoom integer
7 initialLatitude float
8 initialLongitude float
9 copyright string
10 isOverlay boolean
11 initialAlpha float (0 to 1)