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 can be created or updated.

The update subnetwork operation can be run from the Find Subnetworks pane or by using the Update Subnetwork geoprocessing tool to update one or all of the subnetworks in a single tier. When validate consistency failures or subnetwork errors are discovered during the update subnetwork operation, the operation fails and the subnetwork status is marked as invalid.

When a subnetwork is updated in the default version, the geometry, subnetwork name attributes, Is connected attribute, and propagated values are updated for all features and objects in the subnetwork. If the update subnetwork operation is run in a named version using the default edit mode option, these same updates are limited to features and objects that are edited within the version.

Dive-in:
The default eventing behavior for named versions can be modified as part of the update subnetwork policy with the Edit Mode for Named Version parameter in the Set Subnetwork Definition geoprocessing tool for utility networks of version 4 or later.

Learn more about the update subnetwork policy.

Requirements

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 controllers for the subnetwork to update are marked as dirty in the Subnetworks table.
  • No dirty areas exist for the network features that 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:

Note:
You can also use the Find Subnetworks pane to explore and update subnetworks. When the pane is used to update a subnetwork, the operation bypasses geoprocessing and does not log geoprocessing history. 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. Check or uncheck the All subnetworks in tier check box to specify whether to update all subnetworks contained in the tier.
    • Checked—Update subnetwork occurs for all subnetworks in the specified tier. This is the default.
      Dive-in:

      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.
      Dive-in:

      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.
    • Unchecked—Subnetworks in the specified tier are 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 updated.

After the update subnetwork process is complete, review the Subnetworks table to inspect the Is Dirty attribute and other subnetwork attributes.