Update Subnetwork (Utility Network)

ArcGIS Pro 3.4 | | Help archive

Summary

Updates subnetwork information in the Subnetworks table, the SubnetLine feature class, and subnetwork system diagrams for the specified subnetworks.

For the Subnetworks table, this tool changes the status of associated subnetwork controllers to clean (the Is dirty attribute is set to False). If validate consistency failures or subnetwork errors are discovered during tool operation, the status of the associated subnetwork controllers will be marked invalid (the Is dirty attribute is set to Invalid). In the SubnetLine feature class, a record for new subnetworks will be generated, the records for deleted subnetworks will be removed, and the shape and information for modified subnetworks will be updated. Certain attributes will also be created or updated for subnetwork features.

If the update subnetwork policy for a tier is configured so the Is dirty attribute is not managed, the update subnetwork operation can be used to delete rows in the Subnetworks table when the Is deleted attribute is set to true.

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.
    • The update subnetwork operation can be used on the default version to delete rows in the Subnetworks table for tiers that do not manage the Is dirty attribute.
    • If this tool is run on the default version, the geometry, subnetwork name attribute, and propagated fields of the SubnetLine feature class will be updated in place. If this tool is run on 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 runs 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

    • License:
      The active portal account must be assigned a license with the ArcGIS Advanced Editing user type extension to use this tool in an enterprise deployment.

  • 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 before 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 will be updated. To update a subset of subnetworks in the tier, use the Subnetwork Name parameter.

  • Checked—All subnetworks in the tier will be updated. 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—Only the subnetworks that are specified in the Subnetwork Name parameter will be updated.

Boolean
Subnetwork Name
(Optional)

The name of the subnetwork that will be updated from the tier. If the All subnetworks in tier parameter is checked, this parameter is ignored. When the subnetworks table contains 10,000 or more records for a tier, the parameter's choice list is not populated and an empty field is provided for the subnetwork name.

String
Continue on failure
(Optional)

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

  • Checked—The update process will not stop if a subnetwork failure occurs; it will continue.
  • Unchecked—The update process will stop if a subnetwork failure occurs. This is the default.

Boolean
Condition Barriers
(Optional)
Note:

This parameter is only available for Python.

Value Table
Function Barriers
(Optional)
Note:

This parameter is only available for Python.

Value Table
Include Barrier Features
(Optional)
Note:

This parameter is only available for Python.

Boolean
Apply Traversability To
(Optional)

Specifies the type of traversability that will be applied. Traversability scope determines whether traversability will be applied to 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 will not stop even if it encounters an open device, because DEVICESTATUS is only applicable to junctions. In other words, this parameter indicates to the trace whether to ignore junctions, edges, or both.

  • Both junctions and edgesTraversability will be applied to both junctions and edges. This is the default.
  • Junctions onlyTraversability will be applied to junctions only.
  • Edges onlyTraversability will be applied to edges only.
Note:

This parameter is only available for Python.

String
Propagators
(Optional)
Note:

This parameter is only available for 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