Work with circuit definitions

A circuit comprises a collection of components that represent a signal path between specified elements in a telecom domain network. A circuit may be composed of disconnected collections of connected elements, which are called sections. Circuits may also be subdivided into subcircuits to share capacity or bandwidth. Circuit definitions contain the various components that compose a circuit such as the name of the circuit, information about the starting and stopping points that define the path, and whether it is sectioned or nonsectioned.

Beta:

The telecom domain network is available as beta functionality through the Early Adopter Community in ArcGIS Pro 3.5 and ArcGIS Enterprise 11.5, as a result some links may not be active. To access this functionality and learn more, join the Telecom Domain Network Early Adopter Community.

Circuit management tables can be populated with circuit definitions to create circuits, circuit sections, and subcircuits using the Create Circuit pane, the Import Circuit Definitions tool, or the create operation on the Circuits resource in the ArcGIS REST API. Circuit definitions can also be exported using the Export Circuit Definitions tool. This topic describes geoprocessing workflows associated with importing circuit definitions to populate the circuit management tables and exporting circuit definitions.

The Import Circuit Definitions tool is used to import circuit information using .csv files to populate the circuit management tables (Circuit, CircuitSection, and Subcircuit). The Export Circuit Definitions tool exports circuit component information from the circuit management tables into a series of .csv files.

Circuit definitions can be imported to, or exported from a utility network with an enabled or disabled network topology. When the topology is disabled, the Status attribute value for the imported circuit in the Circuit table is set as Dirty unless the Import Circuits as Clean parameter is checked when configuring the circuit properties for a telecom domain network using the Set Circuit Properties tool, and the Last Verified attribute value is NULL.

To import or export circuit definitions, the following requirements must be met:

• The Input Utility Network parameter must reference a utility network that contains a telecom domain network.

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

For tool-specific usage requirements, see the Import Circuit Definitions and Export Circuit Definitions tool documentation.

Import circuit definitions

To import circuit definitions into a utility network, complete the following steps:

1. On the Analysis tab, in the Geoprocessing group, click Tools to open the Geoprocessing pane.
2. In the Geoprocessing pane, search for and select Import Circuit Definitions.
3. For the Input Utility Network parameter, specify the utility network to which the circuit definitions will be imported.
4. For the Domain Network parameter, specify the telecom domain network to receive the circuit definitions.
5. Optionally, for the Input Circuits File (.csv), Input Circuit Sections File (.csv), and Input Subcircuits File (.csv) parameters, provide the name and location of the .csv files containing the circuit component information.

   See the Import Circuit Definitions tool help for information about formatting the .csv files.

6. Click Run.

The files containing the circuit definition information are imported into the specified telecom domain network. Depending on the input parameters used, rows are written to the Circuit, CircuitSection, and Subcircuit tables.

Export circuit definitions

To export circuit definitions from a utility network, complete the following steps:

1. On the Analysis tab, in the Geoprocessing group, click Tools to open the Geoprocessing pane.
2. In the Geoprocessing pane, search for and select Export Circuit Definitions.
3. For the Input Utility Network parameter, specify the utility network from which the circuit definitions will be exported.
4. For the Domain Network parameter, specify the telecom domain network from which the circuit definitions will be exported.
5. For the Component Type parameter, specify the circuit definition information that will be included in the export:
   • ALL—Circuit component information will be exported from the Circuit, CircuitSection, and Subcircuit tables.
   • Circuit—Circuit component information will be exported from the Circuit table.
   • CircuitSection—Circuit component information will be exported from the CircuitSection table.
   • Subcircuit—Circuit component information will be exported from the Subcircuit table.
6. For the Output Folder parameter, provide the path and name of the output folder that will contain the exported .csv file or files.
7. Click Run.

Circuit definition information for the tables specified in the Component Type parameter are exported from the selected telecom domain network into the output folder.