|
Assumed that you were able to install and run ALOV map client/server demo.
Entering the admin zone
Using your browser go to : http://yourhost:port/[installation_dir]/pump
Enter the default values username = Administrator and password = masterkey
To change username and password go in the installation folder, find the dir WEB_INF/mapserv-home. Open the file mapserv.xml and change the login parameters:
<![CDATA[
<master user="username" password="your_password" ip="*"/>
]]>
You may prevent entering the admin zone from other computers by setting the ip attribute.
The asterisk joker means that the connection may be performed from any ip address.
If attribute "ip" is omitted you may only connect yourself from the local host.
Setting up the Clearinhouse database
You may either use the demo Clearinhouse database or create your own new database.
Click "Location" to define the connection to the database. Leave field "XML file"
empty and specify database parameters. Set "Type" to "SQL database".
In case you work with new database you need to create a new set of tables.
Click on the red-coloured link "New Clearinghouse Database".
A link "JDBC drivers" will appears just after you create Clearinhouse database.
Click this link and verify/change the names of the JDBC drivers which are set up on your system.
Now you may upload your GIS data (Shapefile or Mif) to SQL server. Click "Upload shapefile"
- Browse the data source: pair of files shp+dbf or mif+dbf
- Define connection parameters for destination SQL database
- Define name of table in destination SQL database
- You may leave "Unique key field" empty. In this case a new INTEGER field will be created in the database table.
Its name will be [table_name]_ID
- In case you leave the list of uploaded fields empty all fields from dBase
file will be uploaded to the server side
After a successful upload you will be offered to register this dataset.
If you accept this offer many fields in the registration form will be filled already.
But you may register this dataset later.
Dataset registration
The mandatory elements in registration form are marked with asterisks.
Fill in the descriptive data for identification of dataset.
Vector datasets
Fill in the connection parameters. The set of connection parameters are dataset-specific.
File-based datasets Shape/MIF files. To describe the connection you should define
the URL of this file. You can define the relative path. The absolute URL will be based on Servlet URL.
<![CDATA[
url=http://somehost/mapfiles/cities.shp
url=MyFiles/cities.shp
]]>
Dataset in SQL database. You have to define three parameters:
url - a database url of the form jdbc:subprotocol:subname
user - the database user on whose behalf the connection is being made.
password - the user's password.
It is recommended to use user with readonly rights.
URL examples
<![CDATA[
Interbase
jdbc:interbase://xyz.com/sm/base/sm.gdb
MySQL
url=jdbc:mysql://qwerty.edu/base/mapbase
Some ODBC
url=jdbc:odbc:MyDSN
]]>
Define other dataset parameters
- Table name - table name in SQL database
- Key field - field with unique values in SQL table
- Description field for description/notes of feature. This field is used for tips and this is the search field by default.
- List of fields to be downloaded - comma separated names of fields to be downloaded from SQL database table. This list MUST contain all fields which are used in renderers on client side
- X/Y coordinates field. If you already have an table in SQL database with fields that contain lat/long coordinates you may register this dataset directly (without uploading of shapefile)
- To define web links see Web Links
Raster datasets
Image registration values are the transformation parameters to map raster images. They are similar to ESRI world file parameters.
MrSID image server You have to define a URL of appropriated server partially:
<![CDATA[
url = [MrSID script URL]?client=[client name]&image=[MrSID image file name]
]]>
Image width and height are number of pixels in the X(longitude) and Y(latitude) directions in original MrSID image
OGC WMS Like for previous server type you have to define a URL partially:
<![CDATA[
url = [WMS script URL]?[query]
]]>
You should define the following parameters in [query] part of URL:
request=GetMap
srs=EPSG%3A4326
version=1.1.0
format=image/jpeg OR image/gif
exceptions=application/vnd.ogc.se_inimage
bgcolor= <hexadecimal colour value>
Image width and height are maximum width and height of WMS returning image
Layers is a list of comma separated names of layers to be obtained from WMS
Styles is a list of comma separated names of styles to be used for WMS
After registration you may map the registered dataset immediately.
As soon as you register several datasets you may click on link "Search"
and get list of registered datasets. Mark the desired datasets in column "map",
click the "Map marked datasets" button and obtain a map with project file generated on fly.
Download the generated project and use it as template for your further development.
| 
