Migrating your MXD and Web Maps from DataHub Services to Free ArcGIS Online Services

Due to the retirement of the free DataHub services from 1st July 2016 you will need to replace these services with our free UK Content within ArcGIS Online. This post will guide you through the steps you need to take to update services within MXDs, Web Maps and developer APIs. Use the table at the end of this article to discover which new GB basemaps you can use, along with the URL to each. 

How to update your MXD:

  1. Open the MXD containing the DataHub service.
  2. Locate the layer within the Table of Contents and consult the table below to decide which ArcGIS Online basemap is the correct one to replace the existing DataHub service.
  3. To add the new basemap, either go to File, Add Data and then Add Basemap, or go to the Add Data tool on the standard toolbar.  
  4. Select the OS Open basemap you want to add and select Add. 
  5. Once the new basemap has been added to the MXD, remove the existing DataHub service and save the MXD. 

Listing which MXDs contain DataHub services:

If you are unsure which of your MXDs are using DataHub services, download the Esri UK Free Content Finder python from github using the 'Download Zip' button and follow the ‘Read Me’ documentation. The script will produce a csv with a list of MXDs containing any of the free DataHub services.

How to update your Web Maps within ArcGIS Online:

You can update your Web Maps within ArcGIS Online manually, if you don’t have many to update. Alternatively, you can use admin tools (provided by Esri Partner Geo Jobe) to update multiple web maps if you have a larger number which need updating (Please see the update at the end of this blog for recent pricing updates to the tools and new alternative options).

Manual Process to use on a small number of Web Maps:

  1. Log in to your ArcGIS account, navigate to and open the Web Map which you want to update.
  2. Use the basemap icon to select the new ArcGIS Online basemap you wish to use (refer to the table below for guidance). If the DataHub service was previously added as a basemap, this will automatically be replaced by the new ArcGIS Online basemap. However, if the DataHub Service was added as a layer you may need to manually remove the layer from the Table of Contents after the new ArcGIS Online basemap has been added. 

Process to use on a large number of Web Maps:  

  1. Use the GEO Jobe Admin Tools for ArcGIS Online by logging in using your ArcGIS Online organisational credentials.
  2. Within Quick Links, go to the Browse Item Tools then to the Update section. There are a number of update tools, the two which you may choose to use are highlighted below. We recommend that you use Update Web Map Services URLs initially on a test web map to make sure it updates the Web Maps correctly before doing a bulk update using Find and Replace Web Map Service URLs

Update Web Maps Services URLs – Manually select the Web Maps which you wish to update the URL’s for, either within your individual account or within your entire organisation if you are an administrator. Use the filters to specify which Web Maps you wish to update. Once the Web Maps have been selected, add in the new Service URLs to replace the DataHub services for each of the Web Maps (please refer to table below for the correct URLs to use).

  • Pros – By using the filter function all accounts within one organisation can be updated by one admin user
  • Cons – The Web Maps need to be manually selected, therefore you need to know which Web Maps are using the DataHub Service. 

Find and Replace Web Map Service URLs – Use this tool to locate all Web Maps containing a specified DataHub URL and replace them directly with the new ArcGIS Online URL. You can choose which of your web maps to update once you have selected ‘Next’. Please refer to table below for the correct URLs to use.

  • Pros – Updates all Web Maps within your organisational account.
  • Cons – The tool will need to be run by each member of your organisation as it cannot update Web Maps within the whole organisation 

How to update services through developer APIs:

To update the DataHub Service to a new ArcGIS Online Service you need to replace the existing DataHub URL with a new ArcGIS Online URL within your JavaScript code (refer to the table below). The code example below highlights the URL which you would need to update: 

"esri/map", "esri/layers/ArcGISTiledMapServiceLayer", ... 
], function(Map, ArcGISTiledMapServiceLayer, ... ) {
var map = new Map( ... );
var agoServiceURL = "http://datahub.esriuk.com/arcgis/rest/services/gb_basemap/os_open_background/MapServer";
var agoLayer = new ArcGISTiledMapServiceLayer(agoServiceURL, { displayLevels:[0,1,2,3,4,5,6,7]});

Service names and URLs for current and new basemaps:

Updates (26th May 2016) 

Due to recent updates of the GEO Jobe Admin Tools, both the Update Web Map Services URLs and Find and Replace Services URLs tools are no longer free and therefore require a paid for upgrade to access the tools. These tools still work as described above however they now require a paid for licence to access the tools. A free alternative is the ArcGIS Online Assistant tools. 

These free tools can be used to update URLs from your own content or within your whole organisation, if you are an administrator. Follow the steps below to select Web Maps containing the free DataHub service and change the URLs to the free ArcGIS Online services.

Use the free ArcGIS Online Assistant tools by logging into https://ago-assistant.esri.com/ using your ArcGIS Online organisational credentials. In the centre at the top, select ‘I want to update the URLs of Services in a Web Map’.

You will then need to go through the folders on the left hand side to find the Web Maps you wish to update which will be highlighted in blue. 

You can update the URL if your service is added as layer or a basemap. The URLs of operational and basemap layers can be updated manually by replacing the URL with one of the new free ArcGIS Online services listed in the table below, then clicking the Update button, and waiting for the Success message. 

Alternatively the Find/Replace tool can be used to search for one or more URL in either the operational or basemap layers, this will allow you to replace it with the appropriate new URL.  After clicking Replace be sure to click Update and wait for the Success message.

  • Pros – This is a free tool which allows you to update all Web Maps either within your content or within your whole organisation (if you are an administrator). 
  • Cons – Each Web Map needs selecting individually and therefore you need to know where the DataHub services are being used.