Skip To Content

Update a subnetwork

A subnetwork represents a topological subpart within a tier where all connected features are defined by the same subnetwork controller or controllers.

A subnetwork is updated when it is created or modified; indicating the subnetwork is dirty. When a subnetwork is updated, information in the Subnetworks table, the SubnetLine feature class, and attributes on features are created or updated.

The Update Subnetwork tool performs attribute edits in place. This means that the Update Subnetwork process bypasses eventing and will not prompt the evaluation of attribute rules. See Evaluate attribute rules for more information.

The Update Subnetwork tool is used to update one or all of the subnetworks in a single tier. If devices or lines are discovered in the topology of a subnetwork that are not valid to participate in the subnetwork, error features are created for invalid features and the subnetwork remains dirty.

To learn more about the process, see Update subnetworks.


The following requirements must be met to use the Update Subnetwork tool:

  • When working with an enterprise geodatabase, the Input Utility Network parameter must be from a utility network service.
  • The subnetwork has one or more subnetwork controllers.
  • The network topology must be enabled.
  • The subnetwork to update is marked as dirty in the Subnetworks table.
  • No dirty areas exist that intersect with subnetwork features.
  • Any edits must be saved.

Update a single subnetwork or all subnetworks in a tier

To update one or more subnetworks in a tier, complete the following steps:

  1. On the Analysis tab, in the Geoprocessing group, click Tools Tools to open the Geoprocessing pane.
  2. In the Geoprocessing pane, search for and select Update Subnetwork.
  3. For Input Utility Network, select the utility network.
  4. Choose a domain network by clicking the Domain Network drop-down arrow.
  5. Click the Tier drop-down arrow and choose a tier.
  6. By default, the All subnetworks in tier option is checked to update all subnetworks contained in the Tier specified.
    • Checked—Update subnetwork for all subnetworks in specified Tier.

      This option uses asynchronous processing to update subnetworks. This uses the system UtilityNetworkTools geoprocessing service that is reserved for utility network geoprocessing tasks and has a longer default timeout setting.

    • Unchecked—Update subnetwork occurs for specific subnetwork in specified Tier.
  7. If All subnetworks in tier is unchecked, a Subnetwork Name parameter is available. Specify the Subnetwork Name to update by clicking the drop-down arrow.
  8. If All subnetworks in tier is checked, optionally check Continue on failure. This option determines how the update subnetwork process handles errors that are encountered.
    • Unchecked—Subnetworks in the specified Tier will be updated until an error is encountered. Specific error details are reported within tool results and can be reviewed in the ArcGIS Server logs.
    • Checked—All subnetworks in the specified Tier are attempted against for the update operation. The update subnetwork process continues if one or more subnetworks encounter an error and a general warning message is returned in the tool results. Specific subnetworks that failed to update for the Tier are logged in detail and can be reviewed in the ArcGIS Server logs. You can also reference the Subnetworks table to view what subnetworks remain dirty for the specified tier.
  9. Click Run.

The subnetworks specified are now updated.

After the update subnetwork process is complete, review the Subnetworks table to inspect the Is Dirty property and additional subnetwork attributes. The Find Subnetworks pane can also be used to explore subnetworks for a utility network.