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
- Log into IBM Cognos as a user with write access to the reports that are to be updated.
- 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.
- Open a new browser tab or window, and enter the URL to the IBM Cognos environment.
- 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. - Use the panel on the left to select folder(s) or report(s) which require updating.
- Once the folder(s) or reports(s) are selected, press the 'Search' button.
- 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. - 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.
- In the 'Find URL' text box, enter the URL string to be replaced.
- In the 'Replace with URL' text box, enter the URL to replace the existing string.
- Click 'Replace'. As each report is updated, the status changes to indicate the number of strings that have been replaced.
- Review the results pane for details.
- To clear the results pane, right-click and select 'Clear All'.