Add Representation (Cartography) (ArcInfo only) |
|
Release 9.2
Last modified July 13, 2007 |
![]() ![]() ![]() Print all topics in : "Tools" |
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
The input must be a geodatabase feature class.
Specify an import rule layer to import representation rules from an existing layer file that symbolizes features with a feature class representation. All the representation rules of the import rule layer file will be copied into this feature class representation.
If the import rule layer has the same source feature class as the input feature class, you can check Assign Rule IDs (or use the ASSIGN option in a script or at the command line) to assign representation rules to features to match the RuleID assignments of the import rule layer.
If an import rule layer is not specified, all features will be assigned to a single default representation rule.
If an import rule layer is specifiied, but the Assign Rule IDs option is unchecked (or the NO_ASSIGN option is used in a script or at the command line), all features will be assigned to a single default representation rule.
If an import rule layer is specified and the Assign Rule IDs option is checked (or the ASSIGN option is used in a script or at the command line), all features will be assigned to a representation rule based on the symbol choices listed under the renderer type (ie: Categories-Unique values) specified on the layer file.
If <all other values> is used to symbolize data, that symbol will become Rule ID 1 when a representation is added.
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.
|
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.
|
Boolean |
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.
|
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.
|
Boolean |
import arcgisscripting gp = arcgisscripting.create() gp.workspace = "c:\Workspace.mdb" gp.toolbox = "cartography" gp.AddRepresentation ("roads", "roads_Rep", "RuleID", "Override")