HOW TO

Update URLs in Esri Map specifications using the Update Map URLs Utility

Last Published: April 25, 2020

Summary

Maps configured in Esri Maps for IBM Cognos contain hard-coded URLs specifying the REST endpoint for basemap and operational layers (map services, feature services, etc.). The Update Map URLs utility provides the ability to quickly update the URLs in configured maps.

This utility may be used when moving reports from one environment to another, if the ArcGIS Server to be used in the second environment is different than the server that was used originally when configuring the map(s).

Procedure

 
  1. Log into IBM Cognos as a user with write access to the reports that are to be updated.
  2. Backup the reports that are to be updated.
     
    Warning:
    Changes made using the Update Map URL utility are permanent. Ensure reports are backed up prior to applying changes.
  3. Open a new browser tab or window, and enter the URL to the IBM Cognos environment.
  4. Edit the URL to open the Esri Update Map URL utility:

    http://<servername>/ibmcognos/em4c/utilities/UpdateMapURLs.html

    Where 'ibmcognos' is the name of the IBM Cognos virtual directory.
  5. Use the panel on the left to select folder(s) or report(s) which require updating.
  6. Once the folder(s) or reports(s) are selected, press the 'Search' button.
  7. Review the list of reports in the panel on the right. Only reports containing configured Esri Maps are listed. The current status should say 'Not Updated'.

    View the results pane at the bottom of the page for more details.
  8. Select the reports that must be updated by selecting the checkbox for each report under 'Update', or press 'Select All' to select all of the listed reports.
  9. In the 'Find URL' text box, enter the URL string to be replaced.
  10. In the 'Replace with URL' text box, enter the URL to replace the existing string.
  11. Click 'Replace'. As each report is updated, the status changes to indicate the number of strings that have been replaced.
  12. Review the results pane for details.
  13. To clear the results pane, right-click and select 'Clear All'.

Article ID: 000012296

Software:
  • ArcGIS Maps for IBM Cognos 6 0

Receive notifications and find solutions for new or common issues

Get summarized answers and video solutions from our new AI chatbot.

Download the Esri Support App

Discover more on this topic

Get help from ArcGIS experts

Contact technical support

Download the Esri Support App

Go to download options