Adding MapServer content

Configure a Filter window to make your MapServer content available for selection. When the MapServer entry is selected in the Filter window, the geospatial map that is provided by the MapServer is rendered on the base map. For example, you might want to overlay a detailed flood plain geospatial map on the base map. Any filtered data items are then rendered in the top-level operational layer.

Before you begin

  • For each MapServer entry that you add to the Filter window, ensure that the MapServer content is available from the mapping service. For more information, see http://mapserver.org. For example, ensure that an Esri tile layer is available on your ArcGIS Server or ArcGIS Online. If the mapping service is secured by token-based authentication, make a note of the credentials so that you can add the client ID and client secret to the filter configuration.
  • A page extension is required to support the rendering of the selected MapServer content on the base map on a specific page. Ensure that the page extension is configured for the page where the content is rendered. For more information, see the link at the end of the topic.
  • If the Filter window for the selected page does not include a filter pane for the map servers, add a FilterGroupPane child extension to the Filter window. For information, see Configuring the Filter window.

Procedure

  1. Click Solution Administration > Configuration Tools > Application Configuration.
  2. Select your solution application from the Select a solution application to configure list.
  3. On the Pages tab, select a page from the Select a page to configure list. For example, select Supervisor: Operations.
  4. Expand Filter Window and select the filter pane that you configured for the map layers.
  5. Click Create to add a map server to the filter pane.
  6. In the Create Extension Configuration window, enter the details for the map server:
    1. In the Title field, enter the name to display for the map server in the Filter window.
    2. Select Map Server Filter (Device Management Enablement) as the extension type.
    3. In the URL field, enter the URL of the mapping service that provides the MapServer content. The order of the x, y, z query parameters in the URL depends on the mapping service. For example, the following URL is for an ArcGIS mapping service:
      https://services.arcgisonline.com/arcgis/rest/service/World_Street_Map/MapServer/tile/${z}/${y}/${x}
    4. If the mapping service is secured by token-based authentication, select the Authentication required check box.
      • Enter the credentials for the mapping service in the Client ID and Client Secret fields.
      • Optionally, click Validate Credentials to validate the client ID and client secret values with the mapping service.
  7. Click Save.

What to do next

To extend the base map content in an Operations view, select a MapServer entry in the Filter window to overlay the provided geospatial map on the base map. The map content might not be visible if the current zoom level in the Operations view is unsuitable, so adjust the zoom level to include the boundaries of the map content. The map content that is rendered on the base map is not transparent, so if you select entries for overlapping areas, only the map content for the last selected entry is visible. For more information, see the related link.