Update Subnetwork (Utility Network)

This ArcGIS 3.0 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)
Note:

This parameter is only available via Python.

Value Table
Function Barriers
(Optional)
Note:

This parameter is only available via Python.

Value Table
Include Barrier Features
(Optional)
Note:

This parameter is only available via Python.

Boolean
Apply Traversability To
(Optional)

Specifies the type of traversability to enforce. Traversability scope dictates whether traversability is enforced at junctions, edges, or both. For example, if a condition barrier is defined to stop the trace if DEVICESTATUS is equal to Open and traversability scope is set to edges only, the trace would not stop even if the trace encounters an open device, because the DEVICESTATUS is only applicable for junctions. In other words, this parameter indicates to the trace whether to ignore junctions, edges, or both.

  • 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.
Note:

This parameter is only available via Python.

String
Propagators
(Optional)
Note:

This parameter is only available via Python.

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