Skip to main content

Enable Network Topology (Utility Network Tools)

Summary

Enables a network topology for a utility network.

This tool evaluates and establishes connectivity between features to build the network topology for a utility network. A network topology is necessary for analytic operations such as tracing and to use network diagrams. A network topology can also be enabled to find errors.

Note:

Starting with ArcGIS Enterprise 10.9.1, the enable network topology operation will process asynchronously using the UtilityNetworkTools geoprocessing service when working with a utility network in an enterprise geodatabase. The UtilityNetworkTools service is preconfigured in the System folder for feature services that include a utility network. It has a longer time-out setting and is reserved for utility network geoprocessing tasks.

Learn more about how to enable a network topology

Usage

Caution:

When enabling the network topology on a large utility network, this operation will take time and consume resources relative to the number of features in the network. Plan and size the client and database accordingly to ensure that the operation has appropriate RAM and disk space for the process.

  • Some network configuration tasks can only be performed before the network topology is enabled for the first time. See Utility network management tasks for tasks specific to this tool and the required network topology state.

  • All utility network feature classes must have a spatial index.

  • When working with an enterprise geodatabase, the following are requirements:

    • If the Input Utility Network parameter value is from a database connection, the connection must be established as the database utility network owner.

    • The active portal account must be the portal utility network owner.

    • This tool must be connected to the default version to run.

      • All other sessions connected to the default version are blocked from running validate or enable operations during the enable operation.

    • The utility network must be registered as branch versioned.

    • The utility network must be in a nonversioned state to use the Only generate errors advanced option.

    • License:

      The active portal account must be assigned a license with the ArcGIS Advanced Editing user type extension to use this tool in an enterprise deployment.

Parameters

Label Explanation Data type

Input Utility Network

The utility network for which the network topology will be enabled.

Utility Network; Utility Network Layer

Maximum number of errors

(Optional)

The maximum number of errors that can be generated before the process of enabling the network topology will stop. Errors will be recorded in the dirty areas sublayer. A parameter value of -1 or no value will allow an unbounded number of errors to be discovered. The default value is 10000.

Caution:

Increasing the maximum number of errors value will increase the length of time it takes to enable the topology. Setting a value higher than the default value of 10000 is not recommended.

Long

Only generate errors

(Optional)

Specifies whether the topology will be enabled or only network errors will be generated.

  • Checked—The utility network will only be evaluated for network errors. The topology will not be enabled. If you are working with an enterprise geodatabase, the data cannot be registered as versioned. Once the maximum number of errors specified is reached, the operation is canceled, and any errors discovered before the threshold specified will be written to the dirty areas table. This allows you to inspect and fix errors in the network until you enable the topology.

  • Unchecked—The topology will be enabled and any existing errors will generate dirty areas with errors. This is the default.

Boolean

Derived output

Label Explanation Data type

Updated Utility Network

The updated utility network.

Utility Network

Environments

This tool does not use any geoprocessing environments.

Licensing information

  • Basic: No
  • Standard: Yes
  • Advanced: Yes