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

    ColumnDescriptionExample

    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

Parameters

LabelExplanationData 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

LabelExplanationData Type
Updated Utility Network

The updated utility network.

Utility Network

arcpy.un.ImportSubnetworkControllers(in_utility_network, csv_file)
NameExplanationData 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

NameExplanationData 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

Licensing information

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

Related topics