ArcMap

Update Override

Summary

Transfers feature representation overrides from the default override field to explicit fields as defined by the representation rules in the representation.

Usage

  • Representation overrides are stored in the override field by default, for convenience. A manageable database model is one that leverages explicit fields to contain these overrides. Use this tool to expose overrides in the feature attribute table to support queries and selection.

  • The input must be a geodatabase feature class with at least one feature class representation.

  • The explicit fields to be updated must be present on the input feature attribute table, and specified in the representation rules of the representation prior to using this tool.

  • The explicit field to be used for field mapping can contain null values.

  • When transferring geometry overrides on Z-aware data, Z-values will be set according to the Default Output Z Value environment setting.

Syntax

arcpy.cartography.UpdateOverride(in_features, representation, {update_option})
ParameterExplanationData Type
in_features

The input feature layer containing at least one representation.

Feature Layer
representation

The representation containing overrides to be transferred to explicit fields.

String
update_option
(Optional)

Specifies the type of representation override to be transferred to explicit fields.

  • REPRESENTATION_PROPERTY_OVERRIDE —Transfers representation property overrides only. This is the default.
  • GEOMETRY_OVERRIDE —Transfers representation geometry overrides only, into the Shape field. The original geometry of the feature will be overwritten.
  • BOTH —Transfers both representation property and geometry overrides. Representation geometry overrides will be transferred into the Shape field, overwriting the original geometry of the feature.
String

Code sample

UpdateOverride tool Example (Python Window)

The following Python window script demonstrates how to use the UpdateOverride tool in immediate mode.

import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.UpdateOverride_cartography("footprints.lyr", "footprints_Rep", "BOTH")
UpdateOverride tool Example (stand-alone Python script)

This stand-alone script shows an example of using the UpdateOverride tool.

# Name: UpdateOverride_standalone_script.py
# Description: Transfers feature representation overrides
#              from the default override field to explicit fields
#              as defined by the representation rules
#              in the representation.

 
# Import system modules
import arcpy
from arcpy import env

# Set environment settings
env.workspace = "C:/data"

# Set local variables
in_features = "footprints.lyr"
representation = "footprints_Rep"
update_option = "BOTH"

# Execute Update Override
arcpy.UpdateOverride_cartography(in_features, representation, update_option)

Environments

Licensing information

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

Related topics