Export subnetworks

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

The Export Subnetwork tool also allows you to delete a row in the Subnetworks table as long as the Is deleted attribute is set to true. This indicates 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.

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 must be from a utility network service.
• The Subnetwork Name provided must be updated.
• To use the Set export acknowledged option, the following must be true:
  • The network topology must be enabled.
  • The Input Utility Network parameter must be referencing the default branch version.
  • When working with an enterprise geodatabase, the connected ArcGIS Enterprise portal account must be the portal utility network owner.

Workflow

Follow these steps to export a subnetwork:

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 check box to delete the record of any subnetwork controllers from the subnetworks table that have been removed as a subnetwork controller.

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

8. In the Output JSON parameter, specify a name and a location for the JSON file to be created.

Note:

The remaining parameters are optional subnetwork details to include in the output JSON file. For enterprise geodatabases, these parameters require ArcGIS Enterprise 10.7 or later.
9. For the Include geometry parameter, optionally specify whether to include feature geometry in the output JSON file.
10. For the Include domain descriptions parameter, optionally specify whether to include domain descriptions to communicate domain mapping for controllers, featureElements, connectivity, and associations in the output JSON file.

    • Note:

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

11. For the Result Types parameter, specify any of the following:
    • Connectivity—Return a connectivity graph of network features in a subnetwork that are connected through geometric coincidence or connectivity associations.
    • Features—Return feature-based information in the response for network features in the subnetwork.
    • Containment and attachment associations—Return network features that are associated through containment and structural attachment associations.

      Note:

      For enterprise geodatabases, the containment and attachment associations result type requires ArcGIS Enterprise 10.8.1 or later.

12. For the Result Network Attributes parameter, select the network attributes that you want to include in the export.
13. For the Result Fields parameter, specify the Feature Class and Field Name you want to include in the export.
14. Click Run.

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

Review the JSON response syntax of the exported subnetwork