Update Is Connected (Utility Network)

Summary

Updates the IsConnected attribute on all the network features for the specified utility network based on connectivity.

Every feature in the line, device, and junction feature classes as well as every object in the domain network's junction object and edge object tables contains an Is connected attribute. This attribute helps identify isolated network features and objects by maintaining information about their connectivity to subnetwork controllers. When a feature is created, regardless of its connectivity, the Is connected attribute is set to unknown. This attribute is modified for network features depending on the operation being performed.

Note:

Starting with ArcGIS Enterprise 10.9.1, the Update Is Connected 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.

To learn more about this attribute, see Is connected attribute.

Usage

  • The network topology must be enabled.

  • The following requirements must be met when working with an enterprise geodatabase:
    • The connected ArcGIS Enterprise 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 Input Utility Network parameter value must be from a utility network service.
    • 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

LabelExplanationData Type
Utility Network

The utility network where the IsConnected attribute will be updated.

Utility Network; Utility Network Layer

Derived Output

LabelExplanationData Type
Updated Utility Network

The updated utility network.

Utility Network

arcpy.un.UpdateIsConnected(in_utility_network)
NameExplanationData Type
in_utility_network

The utility network where the IsConnected attribute will be updated.

Utility Network; Utility Network Layer

Derived Output

NameExplanationData Type
out_utility_network

The updated utility network.

Utility Network

Code sample

UpdateIsConnected example (Python window)

Update the IsConnected attribute for a utility network called GridNetwork.

import arcpy
arcpy.un.UpdateIsConnected("GridNetwork")

Environments

This tool does not use any geoprocessing environments.

Licensing information

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

Related topics