Skip To Content

Import Subnetwork Controllers

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 these features as subnetwork controllers.

Learn more about importing subnetwork controllers

Usage

  • The network topology must be disabled.

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

  • The connected ArcGIS Enterprise portal account must be the portal 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 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 of the subnetwork controller device.

    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 given when setting the subnetwork controller feature using the Modify Controller pane.

    CB1

    NOTES

    Any notes entered for the subnetwork controller.

    RMT001 Circuit breaker

Syntax

ImportSubnetworkControllers(in_utility_network, csv_file)
ParameterExplanationData Type
in_utility_network

The utility network to which the subnetwork controllers will be imported.

Utility Network; Utility Network Layer
csv_file

The .csvfile 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

This tool does not use any geoprocessing environments.

Licensing information

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

Related topics