Skip To Content

Enable a network topology

A network topology is enabled to perform tracing of network features, and to use network diagrams. When enabled, dirty areas are generated for features where edits are made. These dirty areas are used during the validation of the network topology to ensure it is kept up to date. The network topology for a utility network is enabled using the Enable Network Topology geoprocessing tool. The enable process requires an exclusive lock, so all editing will be blocked while the network topology is being enabled. If the network topology has previously been enabled, any existing error features will be deleted and repopulated.

Tip:

Review the usage notes for specific tools to see the required state for the network topology.

The network topology can be enabled using the following options depending on the desired workflow:

Caution:

There are some network configuration tasks that can only be performed prior to the network topology being enabled for the first time. To learn more, see Network topology actions.

Enable a network topology to discover errors

The network topology can be enabled with the Only generate errors option. This is done to perform quality assurance and prototyping on your network configuration and features before registering as versioned and fully enabling the network topology. Use this process to review and correct errors by making nonversioned edits to utility network features and adjustments to the utility network configuration. Analytic capabilities are not enabled at this stage, so dirty area creation, tracing, and network diagrams are not available.

The following requirements must be met to enable a network topology using the Only generate errors option:

  • The Input Utility Network parameter must be from a database connection established as the database utility network owner.
  • The connected portal account must be the portal utility network owner.
  • The utility network must be in a nonversioned state when using the Only generate errors advanced option.
  • An exclusive schema lock must be obtained.
  • All network feature classes must have a spatial index.
  • The Input Utility Network must have certain configuration tasks complete. See Configure a utility network for more information.
    • All network feature classes must have attribute domains assigned on the Asset type field for each subtype (Asset group).
    • At least one network rule must be present.
    • At least one domain network, tier, and subnetwork must be present.

To enable a network topology using the Only generate errors option, complete the following steps:

  1. On the Analysis tab, in the Geoprocessing group, click Tools Tools to open the Geoprocessing pane.
  2. In the Geoprocessing pane, search for and choose Enable Network Topology.
  3. For Input Utility Network, specify the utility network.
  4. In the Advanced Options section, you can optionally restrict the number of errors processed by the operation. This error number is a sum of the errors generated across the three error feature tables. Once the maximum number of errors specified is reached, the operation is aborted and the tool fails. The errors are written to the Line Error, Point Error, and Polygon Error feature classes for review. The default setting for this parameter is 10,000. To specify an infinite number of errors, type 0.
    Caution:
    Increasing this parameter to a higher value is not recommended and will result in an increase in the length of time for the enable operation.
  5. In the Advanced Options section, check the Only generate errors check box.
  6. Click Run.
  7. Error features are generated for inconsistences in your network.

Enable a network topology to work with dirty areas, tracing, and network diagrams

To work with dirty areas, run traces, and generate a diagram, the network topology must be enabled on a utility network. The network topology is initially enabled once a utility network is configured and ready to be published for consumption via services. Error features are also generated at this stage to mark errors in your network.

The network topology can be disabled to perform planned configuration changes or larger data loading operations. Enabling the network topology must be performed on the default version.

Tip:
If the topology is disabled in a user version, the reconcile process can be used to inherit the topology state from the default branch version.

The Input Utility Network can be from a service or a database connection.

The following requirements must be met to enable a network topology:

  • The connected portal account must be the portal utility network owner.
  • An exclusive schema lock must be obtained.
  • All network feature classes must have a spatial index.
  • The Input Utility Network must have certain configuration tasks complete. See Configure a utility network for more information.
    • All network feature classes must have attribute domains assigned on the Asset type field for each subtype (Asset group).
    • At least one network rule must be present.
    • At least one domain network, tier, and subnetwork must be present.
  • The utility network must be registered as branch versioned.
  • If the Input Utility Network is from a database connection, the connection must be established as the database utility network owner.
  • The Input Utility Network parameter must be referencing the default branch version.

Tip:
If referencing a utility network from a service the timeout setting can be adjusted for longer running enable and disable operations. See Tune and configure services.

To enable a network topology, complete the following steps:

  1. On the Analysis tab, in the Geoprocessing group, click Tools Tools to open the Geoprocessing pane.
  2. In the Geoprocessing pane, search for and choose Enable Network Topology.
  3. For Input Utility Network, specify the utility network.
  4. In the Advanced Options section, you can optionally restrict the number of errors processed by the operation. This error number is a sum of the errors generated across the three error feature tables. Once the maximum number of errors specified is reached, the operation is aborted and the tool fails. The errors are written to the Line Error, Point Error, and Polygon Error feature classes for review. The default setting for this parameter is 10,000. To specify an infinite number of errors, type 0.
    Caution:
    Increasing this parameter to a higher value is not recommended and will result in an increase in the length of time for the enable operation.
  5. Click Run.
  6. The network topology is enabled for the specified utility network. Dirty areas may be present if error features were generated.