Configuring Basemaps and Layers
You can edit an existing basemap definition or add a custom basemap.
Using Standard Basemaps
To add a new basemap or customize an existing basemap, select Basemap from the Object drop-down list.
Configuring Basemap Properties
The following is a description of the properties used for basemap configuration.
- name
-
Is the name of the basemap.
Next to the name is an indicator of whether the basemap is a standard basemap or a customized basemap.
- icon
-
Is the name of the thumbnail for the basemap (for a standard basemap) or the URL to the thumbnail (for a customized basemap) that will appear on the Basemap drop-down list in the WebFOCUS tools (for example, the Base map menu in WebFOCUS Designer) or the Change Basemap map widget.
- title
-
Is a title to display on the Basemap drop-down list in the WebFOCUS tools or the Change Basemap map widget.
- url
-
Is the URL to the map service that provides the basemap, for a customized basemap. The map service URL can be copied from the URL field on the page showing a custom basemap. For a standard basemap, the URL is already stored in the server geographic configuration file and is not displayed.
- type
-
Valid values are tiled and vector.
- addon_json
-
Specifies additional JSON properties for rendering the map.
Editing the Properties of a Basemap
To customize the properties of an existing basemap, right-click the basemap line and click Customize BASEMAP.
The Customize Basemap dialog box opens, as shown in the following image.
Edit the properties you want to change. If you change the URL, you can click Verify to make sure the map service is valid and accessible.
When you are finished, click OK, then click Save on the GEO configuration editor Basemaps page.
Adding a Custom Basemap
To add a new basemap to the configuration, click Add.
The Create a BASEMAP dialog box opens, as shown in the following image.
Enter a name for the basemap, a URL to the thumbnail, a title to display, and the URL to the map service that provides the basemap, and click Verify.
When you have configured the properties, click OK, then click Save on the GEO configuration editor Basemap page.
Reference: Customizing the List of Context Layers
To add a new context layer or customize an existing context layer, select ContextLayer from the Object drop-down list.
The following image shows the GEO configuration editor with the ContextLayer object selected.
Configuring Context Layer Properties
Following is a description of the properties used for context layer configuration.
- name
-
Is the name of the context layer.
Next to the name is an indicator of whether the context layer is a standard context layer or a customized context layer.
- authorization
-
Is the type of authentication needed to access this context layer. Valid values are:
- silent. Credentials for your ArcGIS application are provided in the connection string of the Adapter for Esri ArcGIS.
Note: For instructions for configuring the Adapter for Esri ArcGIS, see the Adapter Administration manual.
- none. No authorization is needed.
- named. User credentials are provided in the connection string of the Adapter for Esri.
- on premises. User credentials for a locally hosted ArcGIS server are provided in the connection string of the Adapter for Esri.
- silent. Credentials for your ArcGIS application are provided in the connection string of the Adapter for Esri ArcGIS.
- layer type
-
Is the type of context layer. For a cached layer, the layer type is tile. For a layer that is rendered dynamically, the layer type is featurelayer.
- title
-
Is a title to display on the demographic layer drop-down list in the WebFOCUS tools.
- addon_json
-
Specifies additional JSON properties needed for rendering the context layer. For example, smartMapping properties define the border styles within the context layer.
Depending on the type of context layer, the addon_json properties may resemble the following:
"layerObjectType" : "esri/layers/ArcGISDynamicMapServiceLayer", "smartMapping": { "webMapInfo": { "queryString" : "id:id", "itemDataUrl" : "url", "layerTypeEx" : "layerType" }}
where:
- esri/layers/ArcGISDynamicMapServiceLayer
-
Defines the context layer as a dynamic map service.
- id
-
Is the ID of the context layer on Esri ArcGIS. This can be found in the URL for the layer on the Esri ArcGIS site, or as the value of the "serviceItemId" property in the JSON properties accessible from the service URL of the layer.
- url
-
Is the map service URL for the layer. This should match the value that you provide for the uri field.
- layerType
-
Is an optional value to specify the type of context layer. It can be one of the following values:
- group. Identifies the context layer as a group layer composed of multiple feature layers. For more information, see https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GroupLayer.html.
- map-image. Identifies the context layer as a map image layer, which can contain multiple sub-layers rendered as images rather than features. For more information, see https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-MapImageLayer.html.
- feature. Identifies the context layer as a feature layer, which is a single layer created from a map service or feature service. For more information, see https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html.
- imagery-tile. Identifies the context layer as an imagery tile layer, created from a tiled image service. For more information see https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-ImageryTileLayer.html.
- imagery. Identifies the context layer as an imagery layer, created from an image service. For more information, see https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-ImageryLayer.html.
- elevation. Identifies the context layer as an elevation layer used in a 3D SceneView. For more information, see https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-ElevationLayer.html.
- tile. Identifies the context layer as a tile layer, created from a cached map service. For more information, see https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-TileLayer.html.
- web-map. Identifies a complete, two-dimensional WebMap. For more information, see https://developers.arcgis.com/javascript/latest/api-reference/esri-WebMap.html.
- web-scene. Identifies a complete, 3D web scene. For more information, see https://developers.arcgis.com/javascript/latest/api-reference/esri-WebScene.html.
If your context layer is neither a group layer nor a map image layer, the layerTypeEx property is not needed.
For example, the add-on JSON for a map image layer may resemble the following:
"layerObjectType" : "esri/layers/ArcGISTiledMapServiceLayer", "smartMapping": { "webMapInfo": { "queryString" : "id:1234567890abcdefghij1234567890ab", "itemDataUrl" : "https://services5.arcgis.com/1234567890abcdef/arcgis/rest/services/Layer_Name/FeatureServer", "layerTypeEx" : "map-image" } }
- uri
-
Is the URL to the map service that provides the context layer.
Customizing the Properties of an Existing Context Layer
To customize the properties of an existing context layer, click the down arrow next to a context layer name or right-click the context layer line and click Customize context layer.
The Customize CONTEXTLAYER dialog box opens, as shown in the following image.
Edit the properties you want to change. If you change the URI, you can click Verify to make sure the map service is valid and accessible.
When you are finished, click OK, then click Save on the GEO configuration editor Context Layers page.
Adding a New Context Layer
To add a new context layer to the configuration, click Add.
The Create a Customized CONTEXTLAYER dialog box opens, as shown in the following image.
Enter a name for the context layer, the authorization type, a layer type, a title to display, any additional JSON needed for rendering the context layer, and the URI to the map service that provides the context layer, and click Verify.
When you have configured the properties, click OK, then click Save on the GEO configuration editor Context Layer page.
- Release: 8207
- Category: Visualizing Data
- Product: Geographic Information Systems (GIS), WebFOCUS Designer
- Tags: How-to's