How to: |
Map services are referenced by inbound or outbound layers.
To configure a new map service:
The Add New Map Service dialog opens, as shown in the following image.
Since map services are hosted by the ArcGIS Server, you must first configure a connection to an available ArcGIS Server.
The REST Service Connection Information dialog opens, as shown in the following image.
The Use proxy to access REST service check box provides you with the option to enable or disable usage of the proxy.jsp file to navigate to a REST endpoint when adding a new map service. This option is enabled by default.
If the Use proxy to access REST service check box is selected, then the proxy.jsp file on the application server must be changed to add the URL to the map server. If the Use proxy to access REST service check box is not selected, and the application server and the map server are not on the same machine, then requests to the map server will fail and an error message indicating a network error is generated. This is the result of a default setting in web browsers, which prevents cross-domain Ajax calls. This setting can be changed in the security settings section of your web browser configuration.
Note: If you are using Microsoft Internet Explorer Version 10 and the Use proxy to access REST service check box is not selected, the following dialog box is displayed.
If you click Yes, then Microsoft Internet Explorer allows you to access the map service without the proxy.jsp. If you click No, an error message indicating Access is denied is displayed.
If you are using Google Chrome and the Use proxy to access REST service check box is not selected, an error message indicating A network error is displayed. If you are using Mozilla Firefox 24 and the Use proxy to access REST service check box is not selected, an error message indicating Failure is displayed. As a workaround, you must select the Use proxy to access REST service check box and edit the proxy.jsp to add a REST endpoint to your proxy list.
To edit the proxy.jsp file, navigate to the following directory:
<WF_HOME>\webapps\webfocus\tools\esri_config\proxy.jsp
Add your REST endpoint, as indicated by the following example:
String[] serverUrls = {
//"<url>[,<token>]"
//For ex. (secured server): "http://myserver.mycompany.com/arcgis/rest/services,ayn2C2iPvqjeqWoXwV
6rjmr43kyo23mhIPnXz2CEiMA6rVu0xR0St8gKsd0olv8a"
//For ex. (non-secured server): "http://sampleserver1.arcgisonline.com/arcgis/rest/services"
"http://informat-65f86f:8399/arcgis/rest/services",
"http://ibigisdev.ibi.com:8399/arcgis/rest/services",
"http://ibigis10.ibi.com:8399/arcgis/rest/services",
"http://tsssvz01:8399/arcgis/rest/services",
"http://sampleserver1.arcgisonline.com/arcgis/rest/services",
"http://sampleserver2.arcgisonline.com/arcgis/rest/services" //NOTE - no comma after the last item
};
Note: As a best practice, do not include an ending forward slash (/) character when specifying an ArcGIS Server URL in the proxy.jsp file. If a forward slash character is specified, then you must ensure that the value entered in the Instance field of the REST Service Connection Information dialog also contains a forward slash at the end.
You are returned to the Add New Map Service dialog.
The map service (for example, Florida Map) is added to the Services pane in the ESRI Configuration Utility, as shown in the following image.
The Properties tab lists the available configuration properties for the map service. The following table lists and describes these properties.
Property |
Description |
---|---|
Label |
The name that is used to identify this map service (for example, Florida Map). |
Type |
The type of map service. For example, Tiled or Dynamic. Tiled map services have a cache of pre rendered image tiles, which allows the ArcGIS Server to render images based on the user request. The ArcGIS Server, therefore, can handle these requests much faster than drawing the maps on the fly. Dynamic map services must be rendered by the ArcGIS Server each time a user zooms or pans a map. Dynamic map services do not have a cache of pre rendered image tiles. As a result, dynamic map services are usually slower to load than tiled map services. However, dynamic map services are useful for displaying data that changes frequently or needs to appear in real time. |
Path |
The path to the map service hosted on the ArcGIS Server. |
Visible |
Determines if the map is visible by default. The default value is Yes. |
Alpha |
The default value is 1. |
Icon |
The path to the icon that is used to represent the map service by the WebFOCUS GIS Flex Viewer. |
A geometry map service is used by WebFOCUS GIS Flex Viewer to make appropriate spatial selections from a map. To configure a geometry map service:
The Add New Map Service dialog opens, as shown in the following image.
Since map services are hosted by the ArcGIS Server, you must first configure a connection to an available ArcGIS Server.
The REST Service Connection Information dialog opens, as shown in the following image.
The Use proxy to access REST service check box provides you with the option to enable or disable usage of the proxy.jsp file to navigate to a REST endpoint when adding a new map service. This option is enabled by default.
If the Use proxy to access REST service check box is selected, then the proxy.jsp file on the application server must be changed to add the URL to the map server. If the Use proxy to access REST service check box is not selected, and the application server and the map server are not on the same machine, then requests to the map server will fail and an error message indicating a network error is generated. This is the result of a default setting in web browsers, which prevents cross-domain Ajax calls. This setting can be changed in the security settings section of your web browser configuration.
Note: If you are using Microsoft Internet Explorer Version 10 and the Use proxy to access REST service check box is not selected, the following dialog box is displayed.
If you click Yes, then Microsoft Internet Explorer allows you to access the map service without the proxy.jsp. If you click No, an error message indicating Access is denied is displayed.
If you are using Google Chrome and the Use proxy to access REST service check box is not selected, an error message indicating A network error is displayed. If you are using Mozilla Firefox 24 and the Use proxy to access REST service check box is not selected, an error message indicating Failure is displayed. As a workaround, you must select the Use proxy to access REST service check box and edit the proxy.jsp to add a REST endpoint to your proxy list.
To edit the proxy.jsp file, navigate to the following directory:
<WF_HOME>\webapps\webfocus\tools\esri_config\proxy.jsp
Add your REST endpoint, as indicated by the following example:
String[] serverUrls = {
//"<url>[,<token>]"
//For ex. (secured server): "http://myserver.mycompany.com/arcgis/rest/services,ayn2C2iPvqjeqWoXwV
6rjmr43kyo23mhIPnXz2CEiMA6rVu0xR0St8gKsd0olv8a"
//For ex. (non-secured server): "http://sampleserver1.arcgisonline.com/arcgis/rest/services"
"http://informat-65f86f:8399/arcgis/rest/services",
"http://ibigisdev.ibi.com:8399/arcgis/rest/services",
"http://ibigis10.ibi.com:8399/arcgis/rest/services",
"http://tsssvz01:8399/arcgis/rest/services",
"http://sampleserver1.arcgisonline.com/arcgis/rest/services",
"http://sampleserver2.arcgisonline.com/arcgis/rest/services" //NOTE - no comma after the last item
};
Note: As a best practice, do not include an ending forward slash (/) character when specifying an ArcGIS Server URL in the proxy.jsp file. If a forward slash character is specified, then you must ensure that the value entered in the Instance field of the REST Service Connection Information dialog also contains a forward slash at the end.
You are returned to the Add New Map Service dialog.
The Geometry Service is added to the list of Map services, as shown in the following image.
Note: If you cannot see a Geometry Service on your ArcGIS Server, then contact your ArcGIS Server Administrator to publish a Geometry Service. Only one Geometry Service can be added per ArcGIS Server.
WebFOCUS |