Skip To Content

Set Terminal Configuration

Summary

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

Once a terminal configuration has been established, it can be assigned to an asset type in the device feature class. This tool allows you to set the terminal configuration for a utility network asset type in the device class. When a terminal configuration is assigned to an asset type, a feature created with that asset type will have terminals. More specifically, the feature will have the terminals specified for the terminal configuration.

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

Usage

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

  • Assigning a terminal configuration to an asset type is permanent and cannot be changed or removed.

  • This tool may be used with the Add Terminal Configuration tool, which is used to add 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 Single terminal.

  • Some network configuration tasks can only be performed prior to the network topology being enabled for the first time. Review Network topology actions for tasks specific to this tool and the required network topology state.

  • The network topology must be disabled.

  • The connected ArcGIS Enterprise portal account must be the portal utility network owner.

  • This tool should be executed when connected to the default version.

  • The input utility network must be from a database connection established as the database utility network owner.

Syntax

SetTerminalConfiguration(in_utility_network, domain_network, device_featureclass, assetgroup, assettype, terminal_configuration)
ParameterExplanationData Type
in_utility_network

The utility network that contains the terminal configuration that will be set on 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 device feature class to which the asset type belongs.

String
assetgroup

The asset group to which the asset type belongs.

String
assettype

The asset type receiving the terminal configuration.

String
terminal_configuration

The terminal configuration to be assigned to the asset type.

String

Derived Output

NameExplanationData 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.SetTerminalConfiguration_un("Utility Network", "ElectricDistribution", 
                                  "ElectricDistributionDevice", "Circuit Breaker", 
                                  "Air powered", "Dual terminal")

Environments

This tool does not use any geoprocessing environments.

Licensing information

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

Related topics