Show Navigation | Hide Navigation
You are here:
Geoprocessing tool reference > Cartography toolbox > Representation Management toolset > Tools

Add Representation (Cartography) (ArcInfo only)

Release 9.2
Last modified July 13, 2007
E-mail This Topic Printable Version Give Us Feedback

Print all topics in : "Tools"


Related Topics

Adds a feature class representation to a geodatabase feature class.

Two new fields with the specified field names will be appended to the input feature class attribute table to identify the representation rules that govern how each category of features will be portrayed, and to hold any feature-specific overrides to these rules.


Usage tips

Command line syntax
An overview of the Command Line window
AddRepresentation_cartography <in_features> <representation_name> <rule_id_field_name> <override_field_name> {STORE_CHANGE_AS_OVERRIDE | MODIFY_FEATURE} {import_rule_layer} {ASSIGN | NO_ASSIGN}

Parameter Explanation Data Type
<in_features>

The input geodatabase feature class to which a new feature class representation will be added.

Feature Layer
<representation_name>

The name of the feature class representation to be added.

String
<rule_id_field_name>

The name of the RuleID field, which will hold a reference to the representation rule for each feature.

String
<override_field_name>

The name of the Override field, which will hold overrides to representation rules for each feature.

String
{STORE_CHANGE_AS_OVERRIDE | MODIFY_FEATURE}

Specifies what will happen to the supporting feature class geometry when features are modified with the representation editing tools.

  • STORE_CHANGE_AS_OVERRIDE — Geometry modificatiuons made to features with the representation editing tools or using any of the geoprocessing tools in the Cartography toolbox will be stored as shape overrides in the Override field. Supporting feature class geometry (stored in the Shape field of the feature class) will be unaffected. This is the default.
  • MODIFY_FEATURE_SHAPE — Geometry modifications made to features with the representation editing tools, or using any of the geoprocessing tools in the Cartography toolbox, will modify the supporting feature class geometry (stored in the Shape field of the feature class.) No shape overrides will be stored.

String
{import_rule_layer}

A feature layer that symbolizes features with a feature class representation, from which the representation rules are imported.

Layer
{ASSIGN | NO_ASSIGN}

Specifies whether or not to assign representation rules to features to match the RuleID assignments of the import rule layer. This option applies only when Import Rule Layer is specified.

  • ASSIGN — assign RuleIDs to features to match the import rule layer. This is the default.
  • NO_ASSIGN — Specifies not to match RuleIDs to features from the import rule layer. Features will be assigned to the default representation rule instead.

Boolean
Data types for geoprocessing tool parameters


Command line example

AddRepresentation_cartography c:\workspace.mdb\roads roads_Rep RuleID Override

Scripting syntax
About getting started with writing geoprocessing scripts
AddRepresentation_cartography (in_features, representation_name, rule_id_field_name, override_field_name, geometry_editing_option, import_rule_layer, assign_rule_id_option)

Parameter Explanation Data Type
in_features (Required)

The input geodatabase feature class to which a new feature class representation will be added.

Feature Layer
representation_name (Required)

The name of the feature class representation to be added.

String
rule_id_field_name (Required)

The name of the RuleID field, which will hold a reference to the representation rule for each feature.

String
override_field_name (Required)

The name of the Override field, which will hold overrides to representation rules for each feature.

String
geometry_editing_option (Optional)

Specifies what will happen to the supporting feature class geometry when features are modified with the representation editing tools.

  • STORE_CHANGE_AS_OVERRIDE — Geometry modificatiuons made to features with the representation editing tools or using any of the geoprocessing tools in the Cartography toolbox will be stored as shape overrides in the Override field. Supporting feature class geometry (stored in the Shape field of the feature class) will be unaffected. This is the default.
  • MODIFY_FEATURE_SHAPE — Geometry modifications made to features with the representation editing tools, or using any of the geoprocessing tools in the Cartography toolbox, will modify the supporting feature class geometry (stored in the Shape field of the feature class.) No shape overrides will be stored.

String
import_rule_layer (Optional)

A feature layer that symbolizes features with a feature class representation, from which the representation rules are imported.

Layer
assign_rule_id_option (Optional)

Specifies whether or not to assign representation rules to features to match the RuleID assignments of the import rule layer. This option applies only when Import Rule Layer is specified.

  • ASSIGN — assign RuleIDs to features to match the import rule layer. This is the default.
  • NO_ASSIGN — Specifies not to match RuleIDs to features from the import rule layer. Features will be assigned to the default representation rule instead.

Boolean

Data types for geoprocessing tool parameters


Script example

import arcgisscripting
gp = arcgisscripting.create()

gp.workspace = "c:\Workspace.mdb"
gp.toolbox = "cartography"
gp.AddRepresentation ("roads", "roads_Rep", "RuleID", "Override")

Please visit the Feedback page to comment or give suggestions on ArcGIS Desktop Help.
Copyright © Environmental Systems Research Institute, Inc.