Agregar representación (Cartografía)

Resumen

Agrega una representación de clase de entidad a una clase de entidad de geodatabase.

Uso

• La entrada debe ser una clase de entidad de geodatabase.

• Se incorporan dos nuevos campos con los nombres de campo especificados a la tabla de atributos de clase de entidad de entrada para identificar las reglas de representación que rigen la manera en que se representa cada categoría de entidades y para retener cualquier excepción específica de las entidades a estas reglas.

• Especifique una capa de importación de reglas para importar las opciones de símbolo enumeradas bajo el tipo de renderizador (es decir, valores únicos de categoría) especificado en el archivo de capa. Todas las opciones de símbolo se copiarán a esta representación de la clase de entidad como nuevas reglas de representación. Si no se especifica una capa de importación de reglas, se asignarán todas las entidades a una única regla de representación predeterminada.

• Si la capa de importación de reglas tiene la misma clase de entidad de origen que la clase de entidad de entrada, puede utilizar el parámetro Asignar los Id. de regla para asignar reglas de representación a entidades para que coincidan con las asignaciones de RuleID de la capa de importación de reglas.

• Si se especifica una capa de importación de reglas y el parámetro Asignar los Id. de regla está establecido como ASSIGN, todas las entidades se asignarán a una regla de representación basada en las opciones de símbolo enumeradas bajo el tipo de renderizador (es decir, valores únicos de categoría) especificado en el archivo de capa. Si se especifica una capa de importación de reglas pero el parámetro Asignar los Id. de regla está establecido como NO_ASSIGN, todas las entidades se asignarán a una regla de representación predeterminada única.

• Si se usa <todos los demás valores> para simbolizar las entidades en la capa de entrada, ese símbolo se convertirá en el Id. de regla 1 cuando se agregue una representación.

Sintaxis

AddRepresentation_cartography (in_features, representation_name, {rule_id_field_name}, {override_field_name}, {geometry_editing_option}, {import_rule_layer}, {assign_rule_id_option})

Parámetro	Explicación	Tipo de datos
in_features	Clase de entidad de geodatabase de entrada a la que se agregará una nueva representación de clase de entidad.	Feature Layer
representation_name	Nombre de la representación de clase de entidad que se agregará.	String
rule_id_field_name (Opcional)	Nombre del campo Id. de regla, que contendrá una referencia a la regla de representación para cada entidad.	String
override_field_name (Opcional)	Nombre del campo de excepción, que contendrá excepciones a las reglas de representación para cada entidad.	String
geometry_editing_option (Opcional)	Especifica qué sucederá a la geometría de la clase de entidad de respaldo cuando las entidades se modifiquen con las herramientas de edición de representación. STORE_CHANGE_AS_OVERRIDE —La modificación de la geometría realizada en las entidades con las herramientas de edición de representación o cualquiera de las herramientas de geoprocesamiento de la caja de herramientas Cartografía se almacena como excepciones de forma en el campo de excepción. La geometría de la clase de entidad de respaldo (almacenada en el campo Forma de la clase de entidad) no se verá afectada. Esta es la opción predeterminada. MODIFY_FEATURE_SHAPE —Las modificaciones de la geometría realizadas en las entidades con las herramientas de edición de representación o cualquiera de las herramientas de geoprocesamiento de la caja de herramientas Cartografía modifica la geometría de la clase de entidad de respaldo (almacenada en el campo Forma de la clase de entidad). No se almacena ninguna excepción de forma.	String
import_rule_layer (Opcional)	Capa de entidades que simboliza las entidades con una representación de clase de entidad, desde la que se importan las reglas de representación.	Layer
assign_rule_id_option (Opcional)	Especifica si se asignan las reglas de representación a las entidades para que coincidan con las asignaciones de RuleID de la capa de importación de reglas. Esta opción sólo se aplica cuando se especifica la Capa de importación de reglas. ASSIGN —Asigna ReglasID a las entidades para que coincidan con la capa de importación de reglas. Esta es la opción predeterminada. NO_ASSIGN —Especifica que no se debe hacer coincidir las ReglasID con las entidades de la capa de importación de reglas. En cambio, las entidades se asignarán a la regla de representación predeterminada.	String

Ejemplo de código

Ejemplo de la herramienta AddRepresentation (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la herramienta AddRepresentation en el modo inmediato.

import arcpy from arcpy import env env.workspace = "C:/data" arcpy.AddRepresentation_cartography("C:/data/cartography.gdb/buildings/footprints",                                     "footprints_Rep", "RuleID", "Override",                                     "STORE_CHANGE_AS_OVERRIDE", "C:/data/footprints.lyr", "ASSIGN")

Ejemplo de la herramienta AddRepresentation (secuencia de comandos de Python independiente)

Esta secuencia de comandos independiente muestra un ejemplo del uso de la herramienta AddRepresentation.

# Name: AddRepresentation_standalone_script.py
# Description: Adds a feature class representation
#              to a geodatabase feature class.
 
# Import system modules
import arcpy
from arcpy import env

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

# Set local variables
in_features = "C:/data/cartography.gdb/buildings/footprints"
representation_name = "footprints_Rep"
rule_id_field_name = "RuleID"
override_field_name = "Override"
geometry_editing_option = "STORE_CHANGE_AS_OVERRIDE"
import_rule_layer = "C:/data/footprints.lyr"
assign_rule_id_option = "ASSIGN"

# Execute Add Representation
arcpy.AddRepresentation_cartography(in_features,
                                    representation_name,
                                    rule_id_field_name,
                                    override_field_name,
                                    geometry_editing_option,
                                    import_rule_layer,
                                    assign_rule_id_option)

Entornos

Sistema de coordenadas cartográficas, Escala de referencia

Información sobre licencias

ArcGIS for Desktop Basic: No

ArcGIS for Desktop Standard: Sí

ArcGIS for Desktop Advanced: Sí