Skip To Content

Deploying the Relocate Events tool as a service

The Relocate Events tool enables external systems to acquire measure changes to event records required to bring the event measure into alignment with the changes made to the LRS route in Roads and Highways. The Relocate Events tool can be published to ArcGIS Server as a geoprocessing service, allowing it to be invoked as a REST web service.


This tool works from the geodatabase version it was published against. You should publish the version that has all the LRS edits posted.

To publish as a geoprocessing service, you must author a geoprocessing task using the Relocate Events geoprocessing tool located in the Location Referencing Tools toolbox on ArcGIS Desktop.

Learn more about geoprocessing services

  1. Start ArcMap.
  2. Open the Catalog window and expand Location Referencing Tools under Toolboxes.

    Relocate Events tool

  3. Double-click the Relocate Events geoprocessing tool.
    The Relocate Events dialog box appears.

    Relocate Events geoprocessing tool

    Do not change the geodatabase version in the .mxd file used to publish the service. This will cause the geoprocessing service to fail, even though the service will publish successfully.

  4. Using the information documented in Relocate Events, fill out the parameters.

    When you author a geoprocessing task, note the following:

    • Use a layer as an input to the Network Layer.
    • Do not set the Last Invoked Time, LRS Time (optional), and Last LRS Time (optional) parameters for the result from which you publish. The date and time parameter values will become the default value in your service, preventing web service invocations from not providing a default value.

  5. Click OK.
  6. Once the geoprocessing tool has executed successfully, open the result in the Results window.
  7. Right-click the result and click Share As > Geoprocessing Service. This will open a step-by-step wizard that defines the service and the initial task within the service.

    Once published as a geoprocessing service, it will use the network layer and the external event name with date parameters to relocate all external events according to changes done on the network.

    Learn more about publishing a geoprocessing service

  8. After you have successfully published the Relocate Events geoprocessing service to ArcGIS Server, you can access its REST endpoint through Server Manager.
    1. Open your ArcGIS REST Services Directory in a web browser.

      The URL is http://<server name>:6080/arcgis/rest/services.

    2. Browse to Services and select the Relocate Events GP Task to access its REST endpoint.