Update a subnetwork

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

When a subnetwork is updated, information in the Subnetworks table, attributes on features and objects are updated, and a subnetwork line in the SubnetLine feature class may be created or updated.

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

To learn more about the subnetwork properties inspected and updated, see Update subnetworks.

The Update Subnetwork tool performs attribute edits in place for all network classes with the exception of the SubnetLine feature class. This means that the update subnetwork process bypasses eventing and will not prompt the evaluation of attribute rules. The default edit mode policy can be configured for both the default version and named versions as part of the subnetwork definition for the tier. The Edit Mode for Default Version parameter specifies the edit mode for subnetwork updates on the default version and with file and mobile geodatabases.

Learn more about the edit mode used by the Update Subnetwork tool


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 for the network features which define the subnetwork.
  • Any edits must be saved.

Update a single subnetwork or all subnetworks in a tier

To update one or more subnetworks in a tier using the Update Subnetwork tool, complete the following steps:

You can also use the Find Subnetworks pane to explore and update subnetworks. Learn more about how to use the Find Subnetworks pane.

  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. Click the Domain Network drop-down arrow and choose a domain network.
  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 specified tier.
    • Checked—Update subnetwork occurs for all subnetworks in the 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 time-out setting of 7200 seconds (120 minutes).

    • Unchecked—Update subnetwork occurs for specific subnetworks in the specified tier.

      This option uses synchronous processing to update a specific subnetwork and has a time-out setting of 1800 seconds (30 minutes).

  7. If All subnetworks in tier is unchecked, the Subnetwork Name parameter is available. Click the Subnetwork Name drop-down arrow and choose the subnetwork name to update.
  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 in the 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 refer to the Subnetworks table to view which subnetworks remain dirty for the specified tier.
  9. Click Run.

The specified subnetworks 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.