Update Subnetwork (Utility Network)

This ArcGIS 2.8 documentation has been archived and is no longer updated. Content and links may be outdated. See the latest documentation.

Summary

Updates subnetwork information in the Subnetworks table, the SubnetLine feature class, and subnetwork system diagrams for the specified subnetworks. Also certain attributes are created or updated for subnetwork features. A record for any new subnetworks will be generated, the records for any deleted subnetworks will be removed, and the shape and information for any modified subnetworks will be updated.

Learn more about how to update subnetworks

Usage

  • The following requirements must be met when working with an enterprise geodatabase:

    • The utility network must be registered as branch versioned.
    • The input utility network must be from a utility network service.
    • If this tool is executed on the default version, the geometry, subnetwork name attribute, and propagated fields of the SubnetLine feature class are updated in place. If executed against a named version, the default behavior (without events) limits updates to features and objects edited in the version. The edit mode can be changed to use events (with events). This option executes geodatabase behavior and can be set in the subnetwork definition for both the default version and named versions. Learn more about the edit mode used by the Update Subnetwork tool

  • This tool creates or updates network diagrams for the updated subnetworks if a diagram template was specified when setting the subnetwork definition.

  • Any edits must be saved prior to running this tool.

  • The network topology must be enabled.

  • No dirty areas exist that intersect with subnetwork features.

Parameters

LabelExplanationData Type
Input Utility Network

The utility network that contains the subnetwork.

Utility Network; Utility Network Layer
Domain Network

The domain network that contains the subnetwork.

String
Tier

The tier that contains the subnetwork.

String
All subnetworks in tier
(Optional)

Specifies whether all subnetworks in the tier are updated. To update a subset of subnetworks in the tier, use the Subnetwork Name(s) parameter.

  • Checked—Updates all subnetworks in the tier. This option uses asynchronous processing to update the subnetworks using the system UtilityNetworkTools geoprocessing service. The service is reserved for utility network geoprocessing tasks and has a longer default timeout setting. This is the default.
  • Unchecked—Updates only the subnetworks that are specified in the Subnetwork Name(s) parameter.

Boolean
Subnetwork Name
(Optional)

The name of the subnetworks to update. If all subnetworks will be updated using the All subnetworks in tier parameter, this parameter is ignored.

String
Continue on failure
(Optional)

Specifies whether to stop the update process if a subnetwork fails to update when updating multiple subnetworks.

  • Checked—Continues to update subnetworks upon failure.
  • Unchecked—Stops updating subnetworks if a failure occurs. This is the default.

Boolean
Condition Barriers
(Optional)
Value Table
Function Barriers
(Optional)
Value Table
Include Barrier Features
(Optional)
Boolean
Apply Traversability To
(Optional)
  • Both junctions and edgesApply traversability to both junctions and edges. This is the default.
  • Junctions onlyApply traversability to only junctions.
  • Edges onlyApply traversability to only edges.
String
Propagators
(Optional)
Value Table

Derived Output

LabelExplanationData Type
Updated Utility Network

The updated utility network.

Utility Network

Environments

This tool does not use any geoprocessing environments.

Licensing information

  • Basic: No
  • Standard: Yes
  • Advanced: Yes

Related topics