Incorporar clases de entidad de anotación (Administración de datos)

Resumen

Crea una clase de entidad de anotación de geodatabase o la incorpora a una clase de entidad de anotación existente al combinar anotaciones provenientes de varias clases de entidad de anotación de geodatabase de entrada en una única clase de entidad con clases de anotación.

Uso

• Cuando se adjuntan múltiples clases de entidad de anotación a una nueva clase de entidad de anotación, las clases de entidad de anotación de entrada deben residir en la misma base de datos.

• Si selecciona entidades de anotación de geodatabase en ArcGIS Pro o crea una consulta de definición, solamente se incorporarán esas entidades a la clase de entidad de salida.

• Cuando se adjuntan clases de entidad de anotación vinculadas a una entidad, todas las clases de entidad de anotación de entrada deben estar vinculadas a la misma clase de entidad.

• Si selecciona una clase de entidad de anotación de salida que ya existe, las entidades se incorporarán a esa clase de entidad y la herramienta proyectará las entidades de anotación en la referencia espacial de destino.

• Al incorporar clases de entidad de anotación con varias subclases de anotación, estas subclases se fusionarán si sus propiedades coinciden.

• Se requiere una licencia de ArcGIS Desktop Standard o ArcGIS Desktop Advanced para crear una clase de entidad de anotación de salida vinculada a entidad.

Sintaxis

arcpy.management.AppendAnnotation(input_features, output_featureclass, reference_scale, {create_single_class}, {require_symbol_from_table}, {create_annotation_when_feature_added}, {update_annotation_when_feature_modified})

Parámetro	Explicación	Tipo de datos
input_features [input_features,...]	Las entidades de anotación de entrada que formarán una clase de anotación en la clase de entidad de salida.	Feature Layer
output_featureclass	Una nueva clase de entidad de anotación que contiene una clase de anotación para cada clase de entidad de anotación de entrada.	Feature Class
reference_scale	La escala de referencia establecida en la clase de entidad de salida. Las entidades de salida creadas en una escala de referencia diferente se transformarán para que coincidan con esta escala de referencia de salida.	Double
create_single_class (Opcional)	Especifica cómo se agregarán las entidades de anotación a la clase de entidad de salida. ONE_CLASS_ONLY —Todas las entidades de anotación se agregarán a una sola clase de anotación en la clase de entidad de salida. CREATE_CLASSES —En la clase de entidad de salida se crearán clases de anotación separadas para cada clase de anotación de entrada, a no ser que las clases tengan el mismo nombre y las mismas propiedades. En este caso, se fusionarán. Esta es la opción predeterminada.	Boolean
require_symbol_from_table (Opcional)	Especifica cómo se pueden seleccionar símbolos para las entidades de anotación creadas recientemente. REQUIRE_SYMBOL —Restringe la creación de entidades de anotación a la lista de símbolos en el conjunto de símbolos de la clase de entidad de salida. NO_SYMBOL_REQUIRED —Permite crear entidades de anotación con cualquier simbología. Esta es la opción predeterminada.	Boolean
create_annotation_when_feature_added (Opcional)	Licencia: Este parámetro solo está disponible con las licencias de ArcGIS Desktop Standard y ArcGIS Desktop Advanced. Especifica si la anotación vinculada a entidad se creará al agregar una entidad. AUTO_CREATE —Se creará una anotación vinculada a entidad con el motor de etiquetado al crear una entidad vinculada. Es la opción predeterminada. NO_AUTO_CREATE —No se creará ninguna anotación vinculada a entidad al crear una entidad.	Boolean
update_annotation_when_feature_modified (Opcional)	Licencia: Este parámetro solo está disponible con las licencias de ArcGIS Desktop Standard y ArcGIS Desktop Advanced. Especifica si la anotación vinculada a entidad se actualiza cuando cambia una entidad vinculada. AUTO_UPDATE —La anotación vinculada a entidad se actualizará con el motor de etiquetado cuando cambie una entidad vinculada. Esta es la opción predeterminada. NO_AUTO_UPDATE —La anotación vinculada a entidad no se actualizará cuando cambie una entidad vinculada.	Boolean

Muestra de código

Ejemplo de AppendAnnotation (ventana de Python)

El script de la ventana de Python muestra cómo utilizar la herramienta AppendAnnotation en el modo inmediato.

import arcpy
arcpy.env.workspace = "C:/data/Cobourg.gdb"
arcpy.AppendAnnotation_management("highways;roads", "transport_anno", 1200, 
                                  "CREATE_CLASSES", "NO_SYMBOL_REQUIRED", 
                                  "AUTO_CREATE", "AUTO_UPDATE")

Ejemplo de AppendAnnotation (script independiente)

El siguiente script independiente muestra cómo utilizar la herramienta AppendAnnotation.

# Name: AppendAnnotation_Example.py
# Description: Use AppendAnnotation to append annotation feature classes in a 
#              geodatabase
# import system modules 
import arcpy
import os
# Set environment settings - user specified
# User input geodatabase for annotation location - eg. C:/data/roads.gdb
arcpy.env.workspace = input('Location of geodatabase annotation: ')
# Create list of annotation feature classes within the geodatabase
fcList = arcpy.ListFeatureClasses("", "ANNOTATION")
# Set variables
# User input output feature class name - eg. appendedroadsAnno
outFeatureClass = arcpy.env.workspace + os.sep + \
                  input('Output annotation feature class name: ')
refScale = 1200
createClasses = "CREATE_CLASSES"
symbolReq = "NO_SYMBOL_REQUIRED"
autoCreate = "AUTO_CREATE"
autoUpdate = "AUTO_UPDATE"
# Process: Append the annotation feature classes
print("Appending annotation feature classes...")
arcpy.AppendAnnotation_management(fcList, outFeatureClass, refScale, 
                                  createClasses, symbolReq, autoCreate, 
                                  autoUpdate)
print("Annotation feature classes in {} have been appended into {}".format(
    arcpy.env.workspace, outFeatureClass))

Entornos

Espacio de trabajo actual, Espacio de trabajo temporal, Auto ejecución

Información de licenciamiento

• Basic: Limitado
• Standard: Sí
• Advanced: Sí