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})
ParameterExplanationData Type

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.

Code Sample

MassUpdateByTracing example (Python window)

This ArcGIS Python window script example executes the MassUpdateByTracing function on Production Mapping sample data.

# ---------------------------------------------------------------------------
# Name:
# Description: Updates the LASTUPDATE field in wMain using values from wSamplingStation
# 	where the two feature classes are connected in the WaterDist_Net geometric network
# Author: ESRI
# ---------------------------------------------------------------------------

# Import arcpy module
import arcpy

# 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"

# import the Production Mapping toolbox - you may have to change this path
arcpy.ImportToolbox(r'C:\Program Files\ArcGIS\Desktop10.0\ArcToolbox\Toolboxes\Production Mapping Tools.tbx')

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


This tool does not use any geoprocessing environments

Related Topics

Licensing Information

ArcView: No
ArcEditor: Requires Production Mapping
ArcInfo: Requires Production Mapping