Utility network management tasks

Configuration and management tasks within the utility network are dependent on many factors, including the type of workspace connection and its permission level, state of the network topology, and the version being referenced.

The following sections and tables provide an overview of the dependencies that exist for different types of network actions when working with a utility network. The following details are used to describe the various components:

• Action—The tool or type of action being performed

• Network topology state—The required state of the network topology

  • Enabled

  • Disabled

  • Prior to initial enabling of network topology

  • Currently not allowed

The following only apply when working with a utility network with an enterprise geodatabase:

• Workspace—Specifies the required data source.

  • Service—The action must be performed against a feature layer from a service.

  • Database connection—The action must be performed against a database connection. For operations completed using a database connection, always ensure the workspace is set to branch for the versioning type.

• Versioned data required—Specifies whether the action requires the dataset to be registered as versioned. The versioning type must be branch.

• Database and portal utility network owner connection required—Specifies whether the action requires connections as both the database owner and portal owner of the utility network.

For further usage and examples, see An overview of the Utility Network toolbox.

Caution:

Certain network configuration tasks cannot be changed or are only allowed prior to enabling the network topology for the first time. Review Network topology state in the tables below for details on tools and actions impacted.

General operations

Action	Workspace	Network topology state	Default version only	Versioned data required	Database and portal utility network owner connection required
Calculate Cluster Keys	Database connection	Disabled	Yes	No	No
Create Utility Network	Database connection	Disabled	Yes	No	Yes
Disable Network Topology	Database connection or service	Enabled	No	No	Yes
Enable Cluster Keys	Database connection	Enabled/disabled	Yes	No	No
Enable Network Topology	Database connection or service	Disabled	Yes	Yes	Yes
Enable Network Topology (generate errors)	Database connection	Disabled	Yes	No Data must be unversioned.	Yes
Rebuild Network Topology	Service	Enabled	No	Yes	No
Repair Network Topology	Database connection	Enabled	Yes	Yes	Yes
Update Portal Dataset Owner	Database connection	Enabled/disabled	No	Yes	Requires connection as the database utility network owner
Validate Network Topology	Service	Enabled	No	Yes	No
Verify Circuits	Service	Enabled	No	Yes	No
Verify Network Topology	Database connection	Enabled	Yes	Yes	Yes
Migrate To Utility Network	N/A The Migrate To Utility Network tool generates an output mobile geodatabase.	N/A	N/A	N/A	N/A
Analyze Network Data	Database connection	Enabled/disabled	Yes	No	Yes
Apply Error Resolutions	Database connection	N/A	Yes	No Data must be unversioned.	Yes

Network modifications

Action	Workspace	Network topology state	Default version only	Versioned data required	Database and portal utility network owner connection required
Load data	Database connection or service	Enabled/disabled	No	No	No
Update service territory feature class extent	Currently not allowed	N/A	N/A	N/A	N/A

Editing a network

Action	Workspace	Network topology state	Default version only	Versioned data required	Database and portal utility network owner connection required
Create feature templates	Database connection	Enabled/disabled	No	No	No
Edit network features and attributes	Service	Enabled	No	Yes	No
Modify associations	Service	Enabled/disabled	No	Yes	No
Create or modify a telecom circuit	Service	Enabled/disabled Working with start and stop locations requires the topology to be enabled.	No	Yes	No
Create or modify a subnetwork controller	Service	Enabled/disabled	No	Yes	No
Modify terminal paths	Service	Enabled/disabled	No	Yes	No
Modify terminal connections	Database connection or service	Enabled/disabled	No	Can be from a database connection (if unversioned). If versioned, it must be from a service.	Yes
Update Subnetwork	Service	Enabled	No	Yes	No
Update Is Connected	Service	Enabled	No	Yes	Yes

Importing and exporting information

https://devtopia.esri.com/ArcGISPro/geodatabase/issues/3945

Action	Workspace	Network topology state	Default version only	Versioned data required	Database and portal utility network owner connection required
Export Associations	Database connection	Enabled/disabled	No	No	Requires connection as the database utility network owner
Import Associations	Database connection	Enabled/disabled	No	No	Requires connection as the database utility network owner
Export Circuits	Service	Enabled	No	Yes	No
Export Circuit Definitions	Database connection	Enabled/disabled	Yes	No	No
Import Circuit Definitions	Database connection	Enabled/disabled	Yes	No	No
Import Rules	Database connection	Disabled	Yes	No	Yes
Export Rules	Database connection	Enabled/disabled	No	No	Yes
Export Subnetwork (without acknowledgments)	Service	Enabled	Yes	Yes	No
Export Subnetwork (with acknowledgments)	Service	Enabled	Yes	Yes	Requires connection as the portal utility network owner
Import Subnetwork Controllers	Database connection	Enabled/disabled	No	No	Requires connection as the database utility network owner
Export Subnetwork Controllers	Database connection	Enabled/disabled	No	No	Requires connection as the database utility network owner
Export Trace Configuration	Service	Enabled/disabled	No	Yes	No
Import Trace Configuration	Service	Enabled/disabled	No	Yes	No

Tip:

A disabled network topology is recommended to import a large number of associations or subnetwork controllers.

Configuration changes

Action	Workspace	Network topology state	Default version only	Versioned data required	Database and portal utility network owner connection required
Add Color Set	Database connection	Enabled/disabled	Yes	No	Yes
Delete a color set	N/A	Currently not allowed	N/A	N/A	N/A
Add Color Scheme	Database connection	Enabled/disabled	Yes	No	Yes
Delete Color Scheme	Database connection	Enabled/disabled	Yes	No	Yes
Add Domain Network	Database connection	Disabled	Yes	No	Yes
Add Telecom Domain Network	Database connection	Disabled	Yes	No	Yes
Delete a domain network	N/A	Currently not allowed	N/A	N/A	N/A
Add Network Attribute	Database connection	Disabled	Yes	No	Yes
Set Network Attribute	Database connection	Disabled	Yes	No	Yes
Delete a network attribute	N/A	Currently not allowed	N/A	N/A	N/A
Add Terminal Configuration	Database connection	Disabled	Yes	No	Yes
Set Terminal Configuration	Database connection	Disabled	Yes	No	Yes
Delete Terminal Configuration	Database connection	Disabled, must be performed prior to the network topology being enabled for the first time	Yes	No	Yes
Remove a terminal configuration assignment—modify terminal configuration set from a user-defined terminal configuration to the default, or another user-defined terminal configuration.	Database connection	Disabled, must be performed prior to the network topology being enabled for the first time	Yes	No	Yes
Add Network Category	Database connection	Disabled	Yes	No	Yes
Set Network Category	Database connection	Disabled	Yes	No	Yes
Delete Network Category	Database connection	Disabled	Yes	No	Yes
Add Tier	Database connection	Disabled	Yes	No	Yes
Delete a tier	N/A	Currently not allowed	N/A	N/A	N/A
Add Tier Group	Database connection	Disabled	Yes	No	Yes
Set or modify the subnetwork definition	Database connection	Disabled	Yes	No	Yes
Set or modify telecom circuit properties	Database connection	Disabled	Yes	No	Yes
Add Rule	Database connection	Disabled	Yes	No	Yes
Delete Rule	Database connection	Disabled	Yes	No	Yes
Set Association Role	Database connection	Disabled	Yes	No	Yes
Set Association Role (unassign)	Database connection	Disabled, must be performed prior to the network topology being enabled for the first time	Yes	No	Yes
Set Edge Connectivity (modify from EndVertex to AnyVertex)	Database connection	Disabled	Yes	No	Yes
Set the telecom object combine or divide policies for grouped objects	Database connection	Enabled/disabled	Yes	No	Yes
Add, edit, or rename subtypes in the Asset group field	Database connection	Enabled/disabled	Yes	No	Yes
Delete subtypes assigned to Asset group field	N/A	Currently not allowed	N/A	N/A	N/A
Add, edit, or rename domain values in the Asset type field	Database connection	Enabled/disabled	Yes	No	Yes
Delete domains assigned to Asset type field	N/A	Currently not allowed	N/A	N/A	N/A
Add Trace Configuration	Service	Enabled/disabled	No	Yes	No
Delete Trace Configuration	Service	Enabled/disabled	No	Yes	No
Add Wavelength Scheme	Database connection	Enabled/disabled	Yes	No	Yes
Delete a wavelength scheme	N/A	Currently not allowed	N/A	N/A	N/A