Appboard/2.4/builder/widgets/tile map/registering tilesets: Difference between revisions

imported>Jason.nicholls
No edit summary
imported>Jason.nicholls
Line 17: Line 17:


== Registry Format ==
== Registry Format ==
This table describes the <tt>csv</tt> 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.


{|class='wikitable'
{|class='wikitable'
!Pos
!Field
!Field
!Type
!Description
!Description
|-
|1
|id
|
|
|-
|2
|name
|
|
|-
|3
|source
|
|
|-
|4
|minZoom
|
|
|-
|5
|maxZoom
|
|
|-
|6
|initialZoom
|
|
|-
|7
|initialLatitude
|
|
|-
|8
|initialLongitude
|
|
|-
|9
|copyright
|
|
|-
|10
|isOverlay
|
|
|-
|11
|initialAlpha
|
|
|}
|}

Revision as of 07:03, 3 October 2013


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
2 name
3 source
4 minZoom
5 maxZoom
6 initialZoom
7 initialLatitude
8 initialLongitude
9 copyright
10 isOverlay
11 initialAlpha