Skip To Content

Enable Network Topology

Summary

Enables a network topology for a utility network.

A network topology is needed for analytic operations such as tracing and network diagrams. A network topology can also be enabled to discover error features.

Learn more about how to enable a network topology

Usage

  • There are some network configuration tasks that can only be performed prior to a network topology being enabled for the first time. Ensure that these configuration tasks have been completed before enabling a network topology.

  • All utility network features classes must have a spatial index prior to enabling topology.

  • The connected ArcGIS Enterprise portal account must be the portal utility network owner.

  • This tool should be executed when connected to the default version.

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

Syntax

EnableNetworkTopology(in_utility_network, {max_number_of_errors}, {only_generate_errors})
ParameterExplanationData Type
in_utility_network

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

Utility Network; Utility Network Layer
max_number_of_errors
(Optional)

The maximum number of errors before the process of enabling the network topology will stop, and errors will be recorded in the errors table. The default value is 10000.

Caution:

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

Long
only_generate_errors
(Optional)

Specifies whether to generate network errors only.

  • ONLY_ERRORSThe utility network will only be evaluated for network errors. The topology will not be enabled, and the data will not be required to be registered as versioned. This allows you to inspect and fix errors in the network until you are ready to register the data as versioned and enable the topology.
  • ENABLE_TOPOThe topology is enabled. This is the default.
Boolean

Derived Output

NameExplanationData Type
out_utility_network

The updated utility network.

Utility Network

Code sample

EnableNetworkTopology example 1 (Python window)

Enable the network topology for a utility network called MyNetwork and set the maximum number of errors to 500 using the EnableNetworkTopology tool.

import arcpy
arcpy.EnableNetworkTopology_un('MyNetwork', 500)
EnableNetworkTopology example 2 (Python window)

Only generate errors for a utility network called MyNetwork using the EnableNetworkTopology tool.

import arcpy
arcpy.EnableNetworkTopology_un('MyNetwork', '', 'ONLY_ERRORS')

Environments

This tool does not use any geoprocessing environments.

Licensing information

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

Related topics