Information about the features and their connectivity that comprise a circuit in a telecom domain network can be exported to .json files using the Export Circuits tool. This exported data can be used for archiving or in other tools using ModelBuilder, custom tools, or through integration with external third-party systems.
The Set export acknowledged parameter can be used to specify whether external systems will be notified about the circuit. If a circuit has been logically deleted from the network (Is deleted = True), the Export Circuits tool allows you to physically delete the row from the Circuit table when the Set export acknowledged parameter is checked.
Note:
The Export Circuits tool runs asynchronously using the UtilityNetworkTools geoprocessing service when working with a utility network in an enterprise geodatabase. The UtilityNetworkTools service is preconfigured in the System folder for feature services that include a utility network. It has a longer time-out setting and is reserved for utility network geoprocessing tasks.
Requirements
To export circuits, the following requirements must be met:
- The Input Utility Network parameter value must reference a utility network version 8 or later and contain a telecom domain network.
- To use the Set export acknowledged parameter, the following must be true:
- The network topology must be enabled.
- The Input Utility Network parameter must reference the default version.
- The following requirements must be met when working with an enterprise geodatabase:
- The connected ArcGIS Enterprise portal account must be the portal utility network owner.
- The Input Utility Network parameter value must reference the default branch version.
License:
The active portal account must be assigned a license with the ArcGIS Advanced Editing user type extension to use this tool in an enterprise deployment.
Export a circuit
To export a circuit, complete the following steps:
- On the Analysis tab, click Tools
to open the Geoprocessing pane. - In the Geoprocessing pane, search for and select Export Circuits.
The Export Circuits tool can also be accessed from the context menu for a selected circuit in the Find Circuits pane. This opens the tool with attributes of the selected circuit prepopulated.
- For the Input Utility Network parameter, specify a utility network.
- For the Domain Network parameter, use the drop-down list to specify a telecom domain network.
- For the Circuits parameter, provide the names of the circuit or circuits to export.
When specifying more than one circuit name, use a comma-delimited list.
- Optionally, check the Set export acknowledged parameter to delete a specified circuit when the Is deleted attribute is True in the Circuit table.
Using this parameter requires the default version. Keep this parameter unchecked if there are no circuits that need to be deleted.
- For the Output folder parameter, provide the location where the output .json files will be created.
A .json file will be created for each circuit that is exported to the specified output folder.
- Optionally, check the Include geometry parameter to include feature geometry for each circuit in the output .json files.
- Optionally, check the Include domain descriptions parameter to include domain descriptions to communicate domain mapping for features and connectivity in the output .json files.
- For the Result Types parameter, specify either of the following:
- Connectivity—Return a connectivity graph of network features in a circuit that are connected through geometric coincidence or connectivity associations.
- Features—Return feature-based information in the response for network features in the circuit.
- For the Result Network Attributes parameter, specify the network attributes to include in the export.
- For the Result Fields parameter, specify the Feature Class and Field Name values to include in the export.
- Click Run.
Information about the specified circuits is exported from the utility network to the specified .json file. If the Set export acknowledged parameter was checked, the Last exported attribute is updated for the specified circuits, and rows in the Circuit table that were marked as logically deleted (Is deleted is True) are permanently deleted from the network.