Create Utility Network (Utility Network)

Summary

Creates a utility network in an enterprise, file, or mobile geodatabase feature dataset.

A utility network is created and a structure network, with its collection of feature classes, is added to the target feature dataset. The structure feature classes will be shared across all domain networks as they are created and configured for the utility network.

For details about system requirements and supported databases, see Create a utility network.

Usage

• The Input Feature Dataset and Service Territory Feature Class parameters must have the same spatial reference.

• The Service Territory Feature Class parameter value must exist in the input feature dataset and must be z- and m-enabled.

• The DEFAULTS configuration keyword will be used for the output utility network.

• When working with an enterprise geodatabase, the following requirements must be met:

  • The geodatabase version must be 10.8.1.2.6 or later to create a utility network version 6 or earlier.

  • The geodatabase version must be 11.2.0.3.2 or later to create a utility network version 7 or later.

  • The utility network cannot be owned by an operating system-authenticated user or a database administrator or geodatabase administrator account.
  • You must sign in and set an active ArcGIS Enterprise portal with an account that has privileges to publish content; these privileges include the ability to publish server-based layers as well as create, update, and delete content. The default Publisher role includes these privileges. The active ArcGIS Enterprise portal account will be recorded in the network properties as the portal utility network owner.

  License:

  The active portal account must be licensed with the ArcGIS Advanced Editing user type extension to create, publish, and work with a utility network in an enterprise geodatabase.

Parameters

Dialog

Label	Explanation	Data Type
Input Feature Dataset	The geodatabase feature dataset in which the utility network and schema will be created.	Feature Dataset
Utility Network Name	The name of the utility network that will be created.	String
Service Territory Feature Class	The existing polygon feature class that will be used to create the utility network's geographical extent. Utility network features cannot be created outside of this extent. The feature class must be z- and m-enabled.	Feature Layer; Feature Class

Derived Output

Label	Explanation	Data Type
Output Utility Network	The output utility network.	Utility Network

Python

arcpy.un.CreateUtilityNetwork(in_feature_dataset, in_utility_network_name, service_territory_feature_class)

Name	Explanation	Data Type
in_feature_dataset	The geodatabase feature dataset in which the utility network and schema will be created.	Feature Dataset
in_utility_network_name	The name of the utility network that will be created.	String
service_territory_feature_class	The existing polygon feature class that will be used to create the utility network's geographical extent. Utility network features cannot be created outside of this extent. The feature class must be z- and m-enabled.	Feature Layer; Feature Class

Derived Output

Name	Explanation	Data Type
out_utility_network	The output utility network.	Utility Network

Code sample

CreateUtilityNetwork example (Python window)

Create a utility network called MyNetwork in a feature dataset called EsriCoOp and a service territory layer called ServiceArea.

import arcpy
arcpy.CreateUtilityNetwork_un(r"C:\MyProject\unownerconnection.sde\UNdatabase.UNOWNER.EsriCoOp", 
                              "MyNetwork", "ServiceArea")

Environments

Current Workspace

Licensing information

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