Configuring access to a map service provider

A map service provider is required for providing routing and driving directions to work orders in the map view. The configuration information is valid for all apps that include the map view and that are deployed in the current environment.

Before you begin

Both the mobile device and the Esri ArcGIS server should be configured for secure communication.

About this task

Information that is used to access the Esri ArcGIS server is not added to the worklight.properties file by default because map support in Maximo Anywhere is optional. You configure this authentication information by editing this file.

When an app with the map view is started, information is transferred to the app so that the mobile workers can use the routing service.

Procedure

  1. From the maximoanywhere_home\Anywhere\MaximoAnywhere\server\conf directory, edit the worklight.properties file and set the following properties:
    Property Description
    si.map.esri.authentication.isEnabled Enables authentication to the Esri ArcGIS server. Set this property to 1 to enable authentication.
    si.map.esri.username The user name that is used to access the routing service on the Esri ArcGIS server.
    si.map.esri.password The password that is used to access the routing service on the Esri ArcGIS server.
    si.map.esri.routeService The secure URL of the routing service on the Esri ArcGIS server. Set this property to, for example, https://route.arcgis.com/arcgis/rest/services/World/Route/NAServer/Route_World
    si.map.esri.token The token that is used to access the route directions.
    si.map.esri.tokenService The URL for the server that is used to generate the token. If none is specified, the Esri default is used.
    si.map.esri.refererService The URL used as a parameter for the server that is used to generate the token. If none is specified, the Esri default is used.
    si.map.esri.isGetMethodEnabled The method that is used to generate the token for route directions.

    Table 1: The properties to be set and their descriptions.

  2. Save and close the file.
  3. Optional: Encrypt the worklight.properties file by using the encrypt.bat file encryption process.
    The si.map.esri.password.enc property contains an encryption value similar to HhMEhpY3f6F6rlJQ17qwbw\=\=.
  4. Build and deploy the application.