Information about the features and their connectivity that compose a circuit in a telecom domain network can be exported to .json files using the Export Circuits geoprocessing tool. This exported data can be consumed for archiving or fed into other tools using ModelBuilder, custom tools, or through integration with external third-party systems.
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.
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 check box is checked.
Note:
The export circuits operation is processed 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 option, the following must be true:
- The network topology must be enabled.
- The Input Utility Network parameter must reference the default version.
- The following requirement 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.
Run the Export Circuit tool
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 Circuit.
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, specify a telecom domain network from the drop-down menu.
- For the Circuits parameter, specify 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 check box to delete a specified circuit when the Is deleted attribute is True in the Circuit table.
Using this option requires the default version. Keep this unchecked if there are no circuits that need to be deleted.
- For the Output folder parameter, specify the location for the output JSON files to be created.
A JSON file will be created for each circuit that is exported to the specified output folder.
- Optionally, for the Include domain descriptions parameter, specify whether to include domain descriptions to communicate domain mapping for features and connectivity in the output JSON file.
- Optionally, for the Include geometry parameter, specify whether to include feature geometry for each circuit in the output JSON files.
- For the Result Types parameter, specify any 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, select the network attributes that you want to include in the export.
- For the Result Fields parameter, specify the Feature Class and Field Name values you want to include in the export.
- Click Run.
Information about the specified circuits has been exported from the utility network to a JSON file. If the Set export acknowledged check box 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 now permanently deleted from the network.