Annotation-Feature-Class anhängen (Data Management)

Zusammenfassung

Erstellt eine Geodatabase-Annotation-Feature-Class oder hängt eine Feature-Class an eine vorhandene Annotation-Feature-Class an. Dabei werden Annotationen aus unterschiedlichen Annotation-Feature-Classes der Eingabe-Geodatabase zu einer einzigen Feature-Class mit Annotationsklassen zusammengefasst.

Verwendung

• Wenn mehrere Annotation-Feature-Classes in einer neuen Annotation-Feature-Class zusammengeführt werden, müssen sich die Eingabe-Annotation-Feature-Classes in derselben Geodatabase befinden.

• Wenn Sie in ArcGIS Pro Geodatabase-Annotations-Features auswählen oder eine Definitionsabfrage erstellen, werden nur diese Features an die Ausgabe-Feature-Class angehängt.

• Wenn Sie Feature-bezogene Annotation-Feature-Classes anhängen, müssen alle Eingabe-Annotation-Feature-Classes auf dieselbe Feature-Class bezogen sein.

• Wenn Sie eine bereits vorhandene Ausgabe-Annotation-Feature-Class auswählen, werden die Features an diese Feature-Class angehängt. Das Werkzeug projiziert die Annotations-Features in den Ziel-Raumbezug.

• Beim Anhängen von Annotation-Feature-Classes mit mehreren Annotations-Subclasses werden die Subclasses vereinigt, wenn deren Eigenschaften übereinstimmen.

• Zum Erstellen einer Feature-bezogenen Ausgabe-Annotation-Feature-Class, ist eine ArcGIS Desktop Standard- oder ArcGIS Desktop Advanced-Lizenz erforderlich.

Syntax

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})

Parameter	Erklärung	Datentyp
input_features [input_features,...]	Die Eingabe-Annotations-Features, die in der Ausgabe-Feature-Class eine Annotationsklasse bilden.	Feature Layer
output_featureclass	Eine neue Annotation-Feature-Class, die für jede Eingabe-Annotation-Feature-Class eine Annotationsklasse enthält.	Feature Class
reference_scale	Der in der Ausgabe-Feature-Class festgelegte Bezugsmaßstab. Eingabe-Features, die mit einem anderen Bezugsmaßstab erstellt wurden, werden so transformiert, dass sie diesem Ausgabe-Bezugsmaßstab entsprechen.	Double
create_single_class (optional)	Gibt an, wie der Ausgabe-Feature-Class Annotations-Features hinzugefügt werden. ONE_CLASS_ONLY —Alle Annotations-Features werden zu einer Annotationsklasse in der Ausgabe-Feature-Class zusammengefasst. CREATE_CLASSES —Gesonderte Annotationsklassen werden für jede Eingabe-Annotationsklasse in der Ausgabe-Feature-Class erstellt, sofern die Klassen nicht den gleichen Namen und die gleichen Eigenschaften aufweisen. In dem Fall werden sie zusammengeführt. Dies ist die Standardeinstellung.	Boolean
require_symbol_from_table (optional)	Gibt an, wie Symbole für neu erstellte Annotations-Features ausgewählt werden können. REQUIRE_SYMBOL —Beschränkt die Erstellung von Annotations-Features auf die in der Symbolsammlung der Ausgabe-Feature-Class enthaltenen Symbole. NO_SYMBOL_REQUIRED —Annotations-Features können mit einer beliebigen Symbolisierung erstellt werden. Dies ist die Standardeinstellung.	Boolean
create_annotation_when_feature_added (optional)	Lizenz: Dieser Parameter ist nur mit ArcGIS Desktop Standard- und ArcGIS Desktop Advanced-Lizenzen verfügbar. Gibt an, ob eine Feature-bezogene Annotation erstellt wird, wenn ein Feature hinzugefügt wird. AUTO_CREATE —Eine Feature-bezogene Annotation wird mithilfe der Label-Engine erstellt, wenn ein verknüpftes Feature erstellt wird. Dies ist die Standardeinstellung. NO_AUTO_CREATE —Wenn ein Feature erstellt wird, wird keine Feature-bezogene Annotation erstellt.	Boolean
update_annotation_when_feature_modified (optional)	Lizenz: Dieser Parameter ist nur mit ArcGIS Desktop Standard- und ArcGIS Desktop Advanced-Lizenzen verfügbar. Gibt an, ob eine Feature-bezogene Annotation aktualisiert wird, wenn ein verknüpftes Feature geändert wird. AUTO_UPDATE —Eine Feature-bezogene Annotation wird mithilfe der Label-Engine aktualisiert, wenn ein verknüpftes Feature geändert wird. Dies ist die Standardeinstellung. NO_AUTO_UPDATE —Eine Feature-bezogene Annotation wird nicht aktualisiert, wenn ein verknüpftes Feature geändert wird.	Boolean

Codebeispiel

AppendAnnotation – Beispiel (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie das Werkzeug AppendAnnotation im unmittelbaren Modus verwendet wird.

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")

AppendAnnotation – Beispiel (eigenständiges Skript)

Im folgenden eigenständigen Skript wird veranschaulicht, wie das Werkzeug AppendAnnotation verwendet wird.

# 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))

Umgebungen

Aktueller Workspace, Scratch-Workspace, Auto-Commit

Lizenzinformationen

• Basic: Eingeschränkt
• Standard: Ja
• Advanced: Ja