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.
Usage
When working with an enterprise geodatabase, the Input Utility Network 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 device or junction object feature that has been set as a subnetwork controller.
RMT001
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 subnetwork controller name.
RMT003
DESCRIPTION
The description for the subnetwork controller.
CB1
NOTES
Any notes entered for the subnetwork controller.
RMT001 Circuit breaker
Syntax
ImportSubnetworkControllers(in_utility_network, csv_file)
Parameter | 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
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
Licensing information
- Basic: No
- Standard: Yes
- Advanced: Yes