Upgrading from ESRI 10.x to 11.x

Upgrading from ESRI 10.x to 11.x involves running the following batch processes to help preserve the integrity of GIS-synced assets, asset locations, and work locations. This section describes these batch processes.

GIS Asset Location Data Export

The GIS Asset Location Data Export (W1GISALX) batch process extracts asset location records, including asset data, that have been synchronized with Esri. This batch enables customers to generate a file containing a current mapping of asset locations and their GIS global IDs before and after the Esri upgrade.

The batch job may generate the following files depending on the environment:

File Description File Name Prefix
Asset locations with a single asset installed SA (for Single Asset)
Asset locations with no asset installed (locations created without associated tracked assets). NA (for No Asset)
Asset locations with multiple assets installed (not supported out of the box; provided for customers with custom solutions). MA (for Multiple Assets)

Note:

Access to the GIS Asset Location Data Export (W1GISALX) application service is needed to run this batch job.

Legacy GIS ID Update

ArcGIS upgrades (for example, to the Utility Network model) may replace global IDs. The Legacy GIS ID Update (W1GISIDU) batch process updates the global IDs in asset locations and work locations with the new values generated in Esri after the upgrade, ensuring these records remain accurately linked to their corresponding GIS features.

  • Format: Create a newline-delimited JSON file (jsonl extension), where each entry maps the old global ID to the new global ID.
  • File Naming: Use only letters, numbers, and underscores ("_") in the file name. Do not use other special characters (such as dashes "-" or spaces " ").
  • Sample File:

{"legacyGisId":"{4BD5E074-2A00-4681-BC76-92CD4D841095}","newGisId":"{606E8A96-9FAE-443D-8899-30DA0A426658}"}

{"legacyGisId":"{041E245F-C286-4981-9839-77D691EB14F4}","newGisId":"{DBEF2B37-BB4C-4B11-A5E7-86EB5BFED5FB}"}

{"legacyGisId":"{F19EDC2E-8237-46A4-8198-3D2D8114A4B0}","newGisId":"{5CBF917B-BEA2-428C-9BDA-A112572563F4}"}

{"legacyGisId":"{0DD4FF2E-42D2-41B9-B3A3-D46D2A8619AA}","newGisId":"{E5BA0D72-DDFC-4246-AC3C-236506CC2433}"}

Note:

Access to the Legacy GIS ID Update (W1GISIDU) application service is needed to run this batch job.

Migration Guide

The migration guide provides detailed instructions and best practices for transitioning the Esri ArcGIS integration during the upgrade from 10.x to 11.x. The migration guide is included in the product documentation delivered with this release. The ESRI ArcGIS Integration to Oracle Utilities Work and Asset Cloud Service Migration Guide is available on the Oracle Utilities Integrations page on Oracle Help Center.