Import Subnetwork Controllers (Utility Network)

Summary

Imports subnetwork controllers from a .csv file into a utility network.

The .csv file generated by the Export Subnetwork Controllers tool can be used as input to this tool. The imported .csv file will modify properties on existing features in the utility network to set those features as subnetwork controllers.

Learn more about importing subnetwork controllers

Usage

• 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.

• Subnetwork controllers must be in the correct CSV format and contain the required columns.

• Features listed in the .csv file must exist in the utility network and meet the prerequisites to be set as a subnetwork controller.

• The information in the .csv file follows this format: SUBNETWORKCONTROLLERNAME, FEATUREGLOBALID, FEATURECLASSNAME, FEATUREASSETGROUP, FEATUREASSETTYPE, FEATURETERMINAL, TIERNAME, SUBNETWORKNAME, DESCRIPTION, NOTES.

  .csv columns

  Column	Description	Example
  SUBNETWORKCONTROLLERNAME	The name of the subnetwork controller set on the device or junction object.	South Side Substation
  FEATUREGLOBALID	The global ID of the subnetwork controller feature.	{1CAF7740-0BF4-4113-8DB2-654E18800028}
  FEATURECLASSNAME	The feature class or table of the subnetwork controller feature.	ElectricDistributionDevice
  FEATUREASSETGROUP	The asset group of the subnetwork controller feature.	Circuit Breaker
  FEATUREASSETTYPE	The asset type of the subnetwork controller feature.	Air Powered
  FEATURETERMINAL	The terminal of the subnetwork controller feature.	Load
  TIERNAME	The name of the tier to which the subnetwork controller feature belongs.	Medium Voltage
  SUBNETWORKNAME	The name of the subnetwork in which the subnetwork controller participates.	RMT003
  DESCRIPTION	The description for the subnetwork controller.	CB1
  NOTES	Any notes entered for the subnetwork controller.	RMT003 Substation

Parameters

Dialog

Label	Explanation	Data Type
Input Utility Network	The utility network to which the subnetwork controllers will be imported.	Utility Network; Utility Network Layer
Input File	The .csv file containing the subnetwork controllers to import.	File

Derived Output

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

Python

arcpy.un.ImportSubnetworkControllers(in_utility_network, csv_file)

Name	Explanation	Data Type
in_utility_network	The utility network to which the subnetwork controllers will be imported.	Utility Network; Utility Network Layer
csv_file	The .csv file containing the subnetwork controllers to import.	File

Derived Output

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

Code sample

ImportSubnetworkControllers example (Python window)

This sample script imports subnetwork controllers from a .csv file named mySources.csv into a utility network named GridNetwork.

import arcpy
arcpy.ImportSubnetworkControllers_un("GridNetwork", "C:\\Temp\\mySources.csv")

Environments

Current Workspace

Licensing information

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