Export subnetworks

The Export Subnetwork tool is used to export information about a subnetwork to a .json file. This information can then be used by external systems such as outage management and asset tracking programs.

The Export Subnetwork tool also allows you to delete a row from the Subnetworks table as long as the Is deleted attribute is set to true. This indicates that the subnetwork controller has been removed from the subnetwork. A subnetwork is removed from a utility network when all subnetwork controllers associated with a subnetwork have been removed and the Set export acknowledged check box is checked. When these criteria are met, all corresponding rows representing the controllers for the subnetwork are deleted from the Subnetworks table.

Note:

Starting with ArcGIS Enterprise 10.9.1, the export subnetwork operation processes 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.

For more information, see Export subnetwork information.

Requirements

To export a subnetwork, the following requirements must be met:

• When working with an enterprise geodatabase, the Input Utility Network parameter value must be from a utility network service.
• The name provided for the Subnetwork Name parameter must be updated.
• To use the Set export acknowledged parameter, the following must are required:
  • The network topology must be enabled.
  • The Input Utility Network parameter value must reference the default branch version.
  • When working with an enterprise geodatabase, the connected ArcGIS Enterprise portal account must be the portal utility network owner.

Export a subnetwork

To export a subnetwork, complete the following steps:

1. On the Analysis tab, click Tools to open the Geoprocessing pane.
2. In the Geoprocessing pane, search for and select Export Subnetwork.
3. For the Input Utility Network parameter, specify a utility network.
4. For the Domain Network parameter, specify a domain network from the drop-down menu.
5. For the Tier parameter, specify a tier from the drop-down menu.
6. For the Subnetwork Name parameter, select the subnetwork from the drop-down menu to export.
7. Optionally, check the Set export acknowledged parameter to delete the record of any subnetwork controllers from the subnetworks table that have been removed as a subnetwork controller.

   Using this parameter requires the default version. Leave this unchecked if there are no controllers that need to be deleted from the subnetworks table.

8. For the Output JSON parameter, specify a name and a location for the .json file that will be created.

Note:

The remaining parameters are optional subnetwork details to include in the output .json file.
9. Optionally, for the Include geometry parameter, specify whether feature geometry will be included in the output .json file.
10. Optionally, for the Include domain descriptions parameter, specify whether domain descriptions will be included in the output .json file to communicate domain mapping for controllers, featureElements, connectivity, and associations.

    Note:

    For enterprise geodatabases, the Include domain descriptions parameter requires ArcGIS Enterprise 10.9.1 or later.

11. Optionally, for the Result Types parameter, specify the types of results that will be returned:
    • Connectivity—A connectivity graph of network features in a subnetwork that are connected through geometric coincidence or connectivity associations will be returned.
    • Features—Feature-based information in the response for network features in the subnetwork will be returned.
    • Containment and attachment associations—Network features that are associated through containment and structural attachment associations will be returned.

      Note:

      For enterprise geodatabases, this option requires ArcGIS Enterprise 10.8.1 or later.

    • Related records—Fields from related objects will be returned for features in the subnetwork.

      Note:

      For enterprise geodatabases, this option requires ArcGIS Enterprise 11.5 or later.

12. Optionally, for the Result Network Attributes parameter, select the network attributes to be included in the results.
13. Optionally, for the Result Fields parameter, specify the Feature Class and Field Name attribute field values to be included in the results.
14. Optionally for the Related Record Fields parameter, specify the Relationship Class and Field Name attribute field values from the related objects to be included in the results.
15. Click Run.

Information about the specified subnetwork is exported from the utility network to a .json file. If the Set export acknowledged parameter was checked, rows in the Subnetworks table that were marked as deleted are now permanently deleted from the network.

Learn more about the JSON response syntax of the exported subnetwork