Water Trace Overview

The Utility Isolation Trace app allows the operator to specify a location, such as a main break, and determine which valves to close and what hydrants and customers will be out of service.

This solution uses a custom widget in Web AppBuilder for ArcGIS to run the isolation trace. To determine the isolation area, information is passed to a geoprocessing service to run the analysis and process the results. The results are returned to the app, where a valve can be skipped and the process re-ran. When the isolation area has been verified, the results can be saved to the Outage Details feature service that is included with the Outage Viewer solution.

Note: This app only finds the closest valves and does not evaluate whether there are dead ended segments. If you are looking for advance isolation logic, use the isolation trace tools that are part of the Water Utility Network Editing and Analysis solution.


Utility Isolation Trace requires specific technical experience and software.

Requirement Description
  • Publishing GIS services
  • Authoring maps
  • Publishing applications using Microsoft Internet Information Services (IIS)
Map authoring
  • ArcMap (Standard or Advanced) 10.2.1, 10.3, 10.4, 10.5
  • Portal for ArcGIS 10.4, 10.5
  • ArcGIS Online
Map Service Hosting
  • ArcGIS Online
  • ArcGIS Enterprise (Standard or Advanced) 10.5
  • ArcGIS for Server (Standard or Advanced) 10.3, 10.4
    • Portal for ArcGIS
Application hosting
  • ArcGIS Enterprise 10.5
  • Portal for ArcGIS 10.4
  • Microsoft Internet Information Services (IIS) 7.0 or higher
  • Microsoft ASP.NET Framework 4.0 or 4.5
  • Web AppBuilder for ArcGIS (Developer Edition) 2.2

What you get

When you download the Utility Isolation Trace application, you'll find the following in the zip file:

Directory Item Description
Application NetworkTrace A Web AppBuilder widget that can be configured to run the isolation trace.
Maps and GDBs IsolationTrace.mxd The map document used to publish the IsolationTrace geoprocessing service.
IsolationTrace.gdb The geodatabase with the schemas to set the feature sets.
LocalGovernment.gdb The ArcGIS for Local Government geodatabase with content from the City of Naperville, Illinois.
IsolationTrace.tbx The toolbox with the IsolationTrace geoprocessing model.
PublicationGDB.tbx The toolbox with the Create Publication GDB geoprocessing model.
Symbology Layer files used to specify the schema and symbology of the feature sets in the IsolationTrace model.
Icons Icons for the services, maps, and apps.

What's new

Below are the release dates and notes for Utility Isolation Trace.

Date Description
July 2016
  • A resolution to a bug with the Publication GDB script that deleted data in the source geodatabase.
June 2016
  • A series of enhancements to the IsolationTrace geoprocessing model that include the following:
    • Common ID created and added to each result. This allows for all results of a trace to share a unique trace identifier field.
    • Common ID added as a return parameter. This allows for the trace identifier to be applied to an outage area in the Network Trace widget.
    • Isolated Mains and laterals are returned in the output.
  • The inclusion of the PublicationGDB.tbx to create a new publication geodatabase and prepare water network data in the Local Government Information Model schema for use in the Utility Isolation Trace application.
  • The WaterWebIsolation.gdb has been replaced with LocalGovernment.gdb.
  • The removal of the OutageDetails.mxd. This schema is now included as part of the Outage Viewer.
  • The latest version of the Network Trace widget, which includes support for Web AppBuilder (Developer Edition) 2.0.
February 2016
  • The latest version of the Network Trace widget, which includes support for Web AppBuilder (Developer Edition) 1.3.
October 2015
  • The latest version of the Network Trace widget, which includes user interface updates and support for Web AppBuilder (Developer Edition) 1.2.
  • Resolved issue in sample dataset.
August 2015
  • Support for standard license by using "Feature Class to Feature Class" versus "Feature to Point"
July 2015
  • The most recent sample network data from the Local Government Information Model
  • A resolution to a bug caused by projection issues (BUG-000086733); IsolationTrace geoprocessing model now handles projections and empty feature sets
  • The use of Web AppBuilder and the Network Trace widget instead of the custom JavaScript application
June 2014
January 2014
  • First release of Utility Isolation Trace

Known Issues

  • In the Utility Isolation Trace, all valves are used to stop the trace. If your hydrant and lateral valves are in the same layer as the system valves, these features need to be removed from the system valves layer. The PublicationGDB.tbx is provided to streamline this process.
  • The Trace Geometric Network Find Connected task used as part of the IsolationTrace model requires that the mains be split at the disabling layer (system valves) locations. The PublicationGDB.tbx is provided to streamline this process.

Get started with Utility Isolation Trace

Coming soon

The next release of the Utility Isolation Trace will include a series of enhancement, including tools to help configure the Isolation Trace geoprocessing tool with your data. A preview of this next release is available on GeoNet.