There are a number of steps involved in configuring mapping:
Step 1 - Create a List of Field IDs and Geographical Value Set IDs
The first step is to obtain the IDs of the fields and value sets that you want to display in Map View. You can obtain these from SuperADMIN using the following command:
<dataset_id>is the ID of the SXV4 with the geographical field.
<field>is the name of the geographical field.
For example, in the following dataset (ID: RoadSafetyData) there is a field called Accident Location that contains details of the geographical location of a road traffic accident:
As shown here, this field is a hierarchy containing four nested geographical value sets.
The format of the field ID returned in SuperADMIN is:
To configure mapping, you need the
Value Set ID
The format of the value set name returned in SuperADMIN is:
To configure mapping, you need the
In this example the value set IDs you need are therefore:
Step 2 - Create Geographic Layers in your Third Party Mapping Service
Use your third party mapping tools to create the geographical layers on the external mapping service for each of the fields you want to map.
Currently, SuperWEB2 supports ArcGIS Server 10.0 and the Web Feature Service (WFS) Interface Standard.
Step 3 - Configure the Thematic Mapping Layers in SuperADMIN
The next step is to configure a thematic mapping layer for every mappable field. This is done in SuperADMIN. You need to define:
- Some default settings. These will apply to all layers unless specifically overridden.
- A definition for each individual layer. This will define:
The layer bindings. These are the links between an SXV4 value set containing mappable items and the corresponding field in the mapping server that has the geographical shape data.
- Any default properties you want to override for this layer. Any properties you do not specifically set for a given layer will use the default value.
The easiest way to set up the thematic mapping layers is to define the settings in a text file and then import this into SuperADMIN. The following is an example that you can use as a basis for constructing your own mapping defaults. Copy this to a text file and then edit accordingly for your deployment:
See Mapping Property Reference for full details on each of these settings. The important ones that you will need to change based on your ArcGIS mapping service are:
|The spatial reference ID. In most cases this should be set to 4326.|
In each layer you need to specify the SXV4 value set it applies to.
If you have multiple fields that contain the same geographical data (for example you have multiple datasets with an Area field that contains information relevant to Australian states and suburbs) then you can bind a single layer definition to multiple SXV4 value sets and datasets.
|In each layer you need to specify the URL of the REST endpoint for the ArcGIS mapping server that will provide the geometry layer.|
In each layer you need to specify which field on the ArcGIS server it maps to.
|You need to specify whether the |
In each layer you need to specify which field on the ArcGIS server contains the names associated with the shapes for this layer. The names are displayed in Map View if a user clicks on the region.
Please note that as these names come from the ArcGIS server, they will be displayed in whatever language they were configured to use in ArcGIS, regardless of the dataset or user interface language that is currently selected in SuperWEB2.
|In each layer you need to specify the ID of the layer on the ArcGIS server that contains the geometric data for this value set.|
|The URL of the REST endpoint for the ArcGIS mapping server that will provide the outline/boundary images (this is the background layer image that shows the areas that can be selected; it is a transparent image that only shows boundary outlines and labels).|
|In each layer you need to specify an array of IDs of the layers on the ArcGIS server that contain the outline/boundary images.|
The following settings are required when connecting to a WFS mapping service, but can be omitted for connections to ArcGIS servers:
|Whatever the WFS server supports to return GeoJSON. This setting is only read for WFS servers. If omitted, it will default to |
|The field in your feature layer that has the actual geometry. This setting is only read for WFS servers. If omitted, it will default to |
Import the Settings
Once you have finished editing the mapping settings in your text file, use the following command in SuperADMIN to import your new settings and replace the current mapping layer definitions:
You may also need to complete these configuration steps: