Creating and configuring maps

To use maps in spatially enabled applications, you must configure the maps and map services on map manager.

Before you begin

  • If you want to use the Geocoder tool in the map toolbar, a geocode service and address locator must exist in your GIS.

  • You must create GIS objects in the Database Configuration application for the layer that is registered.

  • All map layers that are configured to relate to Maximo records must have the OBJECTID field and the SHAPE field enabled in the Layer Properties window in ESRI ArcMap.

  • If you are using Spatial as a map provider, set a timeout value for retrieving data from the ArcGIS server. Use the System Properties application and set a value mxe.pluss.spatialConf.timeout. The default value is 5000 ms.

About this task

Only map services from ESRI ArcGIS Server are supported. You can use public maps from Bing Maps, OpenStreetMap, and ArcGIS Online as base maps.

All URLs are for representational state transfer (REST) services, for example: http://localhost:8399/arcgis/rest/services/mymapservice/MapServer.

Procedure

  1. In the Map Manager application, select a map or click New Map.
  2. Select Enable Map to activate this map manager configuration.
  3. For new maps, specify a unique name for the map and type a short description.
  4. Optional: Select Enable GIS trace messages box? if you are using Spatial as a map provider you want to view details from the ArcGIS server about which layers are requested and loaded on the map.
  5. Optional: Select the Use Proxy option to use a proxy for all requests that are related to that Map Manager record.
    The map component will use the proxy URL <host>:<port>/maximo/webclient/pluss/plusstokenproxy.jsp by default.
  6. Optional: Enable web map configuration by selecting Layers Configured with Web Map Definitions, which indicates that layers are configured by using Web Map definitions. After you enable web map configuration, select the layers that you want to include in your map.
  7. Select the Map Tools option from the Common Actions menu to configure which map tools are available for the current map.
    Tools are enabled for members of the EVERYONE group. Map tool configuration is saved in the presentation file of each map-enabled application.
  8. Specify the sites that you want to use the map and configure extent data for the site map.
    A site can use only one map. Map extent can be configured by using map controls to pan across the map and set the zoom level.
  9. Optional: Specify a link to the geometry service that this map uses.
  10. Optional: In the Map Services table window, add a map service.
    You can add more than one map service. The last map service listed should be the base map without service layers. For example, Name: Basemap, Order 100, URL http://basemaps.arcgis.com/arcgis/rest/services/World_Basemap_v2/VectorTileServer
    Option Description
    Name Specify a unique name for the map service.
    URL Specify the link to the map service in your GIS.
    Order If you use more than one map service, specify the order in which they are drawn on the map. Map data from smaller numbers is drawn first. This drawing sequence means that data from larger numbers is applied to the map behind data from smaller numbers. For example, the largest number is the last map service added to the map. This map service might have some features that are hidden behind features of a lower ordered map service.
    % Transparency Specify how transparent you want the map service to be. Transparency can help to reduce features hidden by other map services. 0 indicates no transparency; 100 indicates total transparency.
  11. Optional: Enable map features to be linked with application records:
    If a layer is not in the Service Layers table window, it can be visualized by any user that has access to this map.
    1. In the Map Services table window, select a layer.
    2. In the Service Layers table window, click Select Layers.
    3. In the Select Layers window, select one or more layers to add to the map service, and click OK.
    4. For each layer, select the GIS object that the layer uses.
      If there is more than one layer in the map that maps to the same GIS object, then all layers must be added to the Service Layers table.
    5. Select an object to associate with the GIS object. This field is validated by the GIS-MBO-TYPES ALN Domain.
    6. Specify any restrictions applied to the service layer.
      Select Do not open feature attributes dialog during feature creation to prevent the attribute inspector from opening after a feature is created.
      Select Do not allow feature attribute edition after creation to prevent the attribute inspector from appearing in the feature edit toolbar for the service layer.
      Select Only display map features linked to Maximo record the user has access to display features that the user is authorized to view. After setting this option, refresh the features displayed on map using the Refresh map tool.
    7. Specify system of record. Select Maximo to designate Maximo authoritative data source for this map record. Select ArcGIS to designate the ArcGIS server as the data authority.
    Map features in the layer can be linked with application records. A signature option (SIGOPTION) is created for the map service layer.
  12. Optional: Enable map security by selecting Enable Token Security. Enter credentials for each map service. You can also specify default credentials that apply to all map services.
  13. Optional: On the Services tab, specify a link to the geocode service this map uses.
  14. Optional: On the Auto Create tab, select the feature class and label that the Auto-Create action uses for work orders and service requests.
  15. Optional: On the Auto Locate tab, specify the label text and label position for work orders, service requests, and service addresses.
  16. Optional: On the Map Tips tab, specify the menu item details for the map tips menu links.
  17. Optional: To use public maps, specify the public map details on the Settings tab.
  18. Select the Active check box to make this map active for the sites that you specified and save the map.