Set Terminal Configuration (Utility Network)

Summary

Assigns a terminal configuration to an asset type in a utility network.

Once a terminal configuration has been established, you can use this tool to set the terminal configuration for a utility network asset type of a device feature class or junction object table. When a terminal configuration is assigned to an asset type, a feature created with that asset type includes terminals. More specifically, the feature includes the terminals specified for the terminal configuration.

To understand what underlying terminals are provided for each asset type, review the Terminal Configuration section on the Network Properties dialog box of the utility network layer properties.

Caution:

The default terminal configuration for all features is Single terminal. Assigning a terminal configuration to an asset type is permanent and cannot be changed after the network topology is enabled for the first time. This applies even if the network topology is in a disabled state.

Usage

• A terminal configuration can be assigned to more than one asset type, but an asset type can only be assigned one terminal configuration.

• You can use this tool with the Add Terminal Configuration tool, which adds a new terminal configuration to a utility network.

• If an asset type has not been assigned a user-defined terminal configuration, the default terminal configuration is a single terminal.

• The network topology must be disabled.

• When working with an enterprise geodatabase, the connected ArcGIS Enterprise portal account must be the portal utility network owner.

• When working with an enterprise geodatabase, this tool must be connected to the default version to run.

• When working with an enterprise geodatabase, the Input Utility Network parameter value must be from a database connection established as the database utility network owner.

Parameters

Dialog

Label	Explanation	Data Type
Input Utility Network	The utility network containing the terminal configuration that will be assigned to a specific asset type.	Utility Network; Utility Network Layer
Domain Network	The domain network to which the asset type belongs.	String
Input Table	The utility network feature class or table to which the asset type belongs.	String
Asset Group	The asset group to which the asset type belongs.	String
Asset Type	The asset type that will receive the terminal configuration.	String
Terminal Configuration	The terminal configuration that will be assigned to the asset type.	String

Derived Output

Label	Explanation	Data Type
Updated Utility Network	The updated utility network	Utility Network

Python

arcpy.un.SetTerminalConfiguration(in_utility_network, domain_network, device_featureclass, assetgroup, assettype, terminal_configuration)

Name	Explanation	Data Type
in_utility_network	The utility network containing the terminal configuration that will be assigned to a specific asset type.	Utility Network; Utility Network Layer
domain_network	The domain network to which the asset type belongs.	String
device_featureclass	The utility network feature class or table to which the asset type belongs.	String
assetgroup	The asset group to which the asset type belongs.	String
assettype	The asset type that will receive the terminal configuration.	String
terminal_configuration	The terminal configuration that will be assigned to the asset type.	String

Derived Output

Name	Explanation	Data Type
out_utility_network	The updated utility network	Utility Network

Code sample

SetTerminalConfiguration example (Python window)

Set the terminal configuration for the Air powered asset type.

import arcpy
arcpy.un.SetTerminalConfiguration("Utility Network", "ElectricDistribution", 
                                  "ElectricDistributionDevice", "Circuit Breaker", 
                                  "Air powered", "Dual terminal")

Environments

Current Workspace

Licensing information

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