Update Override (Cartography)

Summary

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

Caution:

Updating geometry overrides will transfer the geometry override from the representation override field into the Shape field. The original geometry of the feature will be overwritten.

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.

Syntax

UpdateOverride_cartography (in_features, representation, {update_option})

Parameter	Explanation	Data 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

This tool does not use any geoprocessing environments

Licensing Information

ArcGIS for Desktop Basic: No

ArcGIS for Desktop Standard: Yes

ArcGIS for Desktop Advanced: Yes