Mass Update By Tracing (Production Mapping)



Updates feature attributes in a geometric network using a field from Input Source Features. The tool can update any feature class that participates in the geometric network and is connected to Input Source Features. A trace task determines connectivity. Any feature connected to, upstream, or downstream of a feature in Input Source Features is updated.



MassUpdateByTracing_production (in_geometric_network, in_source_features, in_source_field, in_target_features, in_trace_task, {in_additional_source_expression}, {in_use_barriers})

The geometric network that contains the features you want to update.

Geometric Network

The features to use for the trace. Each feature is used as a starting point in the trace.

Feature Layer

The field in the source layer that is used to update values in the target layers.

[[Layer, {Edit}, {Disable}, {Field}].,...]

Lists the feature classes to update in the geometric network. You must include three different properties for each feature class to update:

  • Edit—Indicates whether the features in the layer are edited. If False, the features are not modified. If True, the features are updated using the value from the in_source_field parameter.
  • Disable—Indicates whether the features in the layer are included in the trace operation. If False, the layer features are not included in the trace operation. If True, they are included.
  • Field—The field to update with the trace.
Value Table

The tracing task to use to update the target features.

  • FIND_CONNECTEDUpdates all target features that are connected to the source features. This is the default.
  • TRACE_UPSTREAMUpdates all target features that are upstream from the source features.
  • TRACE_DOWNSTREAMUpdates all target features that are downstream from the source features.

A Structured Query Language (SQL) expression that defines which source features to use to update the target features.

SQL Expression

Indicates whether barriers in the geometric network are used in the update process.

  • NO_BARRIERSBarriers in the geometric network are ignored during the update.
  • USE_BARRIERSBarriers in the geometric network are taken into consideration during the update.


MassUpdateByTracing example (Python window)

The following Python window script demonstrates how to use the MassUpdateByTracing tool.

# Description: Updates the LASTUPDATE field in wMain using values from wSamplingStation
# 	where the two feature classes are connected in the WaterDist_Net geometric network
# paths to the sample data - you may have to alter these paths
WaterDist_Net = "C:\\data\\WaterUtilities.gdb\\WaterDistribution\\WaterDistribution_Net"
wSamplingStation = "C:\\data\\WaterUtilities.gdb\\WaterDistribution\\wSamplingStation"
wMain = "C:\\data\\WaterUtilities.gdb\\WaterDistribution\\wMain"

# Update using MassUpdateByTracing
arcpy.MassUpdateByTracing_production(WaterDist_Net, wSamplingStation, "LASTUPDATE", "C:\\data\\WaterUtilities.gdb\\WaterDistribution\\wMain true false LASTUPDATE", "FIND_CONNECTED", "", "NO_BARRIERS")




ArcGIS for Desktop Basic: 否
ArcGIS for Desktop Standard: 需要 Production Mapping
ArcGIS for Desktop Advanced: 需要 Production Mapping