Back to Top

Update a subnetwork

In this topic

  1. Requirements
  2. Update a single subnetwork or all subnetworks in a tier

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.

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

Dive-in:
When updating a subnetwork in a named version, the subnetwork name attributes, Is connected attribute, and propagated values are only updated for network features modified in that version. This default behavior can be modified by changing the Edit Mode for Named Version parameter to use eventing in the tier's subnetwork definition.

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

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 that are encountered.
    • 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 now updated.

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

Feedback on this topic?

In this topic
  1. Requirements
  2. Update a single subnetwork or all subnetworks in a tier