Ajouter des classes d’entités annotations (Gestion des données)

Résumé

Crée une classe d’entités annotations de géodatabase ou ajoute des éléments à une classe d’entités annotations existante en combinant les annotations provenant de plusieurs classes d’entités annotations de géodatabase en entrée en une seule classe d’annotations.

Utilisation

• Lors de la juxtaposition de plusieurs classes d'entités annotations dans une nouvelle classe d'entités annotations, les classes d'entités annotations en entrée doivent résider dans la même base de données.

• Si vous sélectionnez des entités annotations de géodatabase dans ArcGIS Pro ou construisez un ensemble de définitions, seules ces entités seront ajoutées à la classe d’entités en sortie.

• Si vous ajoutez des classes d'entités annotations liées à des entités, toutes les classes d'entités annotations en entrée doivent être liées à la même classe d'entités.

• Si vous sélectionnez une classe d’entités annotations en sortie qui existe déjà, les entités sont ajoutées à cette classe d’entités et l’outil projette les entités annotations dans la référence spatiale de destination.

• Lorsque vous ajoutez des classes d’entités annotations avec plusieurs sous-classes d’annotations, les sous-classes sont fusionnées si leurs propriétés correspondent.

• Une licence ArcGIS Desktop Standard ou ArcGIS Desktop Advanced est requise pour créer une classe d’annotations liées aux entités en sortie.

Syntaxe

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

Paramètre	Explication	Type de données
input_features [input_features,...]	Entités annotations en entrée formant une classe d’annotations dans la classe d’entités en sortie.	Feature Layer
output_featureclass	Nouvelle classe d’entités annotations contenant une classe d’annotations pour chaque classe d’entités annotations en entrée.	Feature Class
reference_scale	Échelle de référence définie dans la classe d’entités en sortie. Les entités en entrée créées à une échelle de référence différente seront transformées pour correspondre à cette échelle de référence en sortie.	Double
create_single_class (Facultatif)	Spécifie comment les entités annotations seront ajoutées à la classe d'entités en sortie. ONE_CLASS_ONLY —Toutes les entités annotations sont agrégées dans une classe d’annotations au sein de la classe d’entités en sortie. CREATE_CLASSES —Des classes d’annotations distinctes sont créées pour chaque classe d’annotations en entrée dans la classe d’entités en sortie sauf si les classes se nomment de la même manière et possèdent les mêmes propriétés. Dans ce cas, elles sont fusionnées. Il s’agit de l’option par défaut.	Boolean
require_symbol_from_table (Facultatif)	Spécifie comment les symboles peuvent être sélectionnés pour les entités annotations qui viennent d'être créées. REQUIRE_SYMBOL —Restreint la création d’annotations à la liste de symboles de la collection de symboles de la classe d’entités en sortie. NO_SYMBOL_REQUIRED —Autorise la création d’annotations avec n’importe quelle symbologie. Il s’agit de l’option par défaut.	Boolean
create_annotation_when_feature_added (Facultatif)	Licence : Ce paramètre est disponible uniquement avec les licences ArcGIS Desktop Standard et ArcGIS Desktop Advanced. Spécifie si une annotation liée à une entité est créée lorsqu’une entité est ajoutée. AUTO_CREATE —Une annotation liée aux entités est créée à l’aide du moteur d’étiquetage lorsqu’une entité liée est créée. Il s’agit de l’option par défaut. NO_AUTO_CREATE —Aucune annotation liée aux entités n’est créée lorsqu’une entité est créée.	Boolean
update_annotation_when_feature_modified (Facultatif)	Licence : Ce paramètre est disponible uniquement avec les licences ArcGIS Desktop Standard et ArcGIS Desktop Advanced. Spécifie si l’annotation liée à une entité est mise à jour lors de la modification de l’entité liée. AUTO_UPDATE —Une annotation liée aux entités est mise à jour à l’aide du moteur d’étiquetage lorsqu’une entité liée est modifiée. Il s’agit de l’option par défaut. NO_AUTO_UPDATE —Aucune annotation liée aux entités n’est mise à jour lorsqu’une entité liée est modifiée.	Boolean

Exemple de code

Exemple d'utilisation de l'outil AppendAnnotation (fenêtre Python)

Le script de fenêtre Python suivant montre comment utiliser l'outil AppendAnnotation en mode immédiat.

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

Exemple d’utilisation de l’outil AppendAnnotation (script autonome)

Le script autonome suivant illustre l'utilisation de l'outil 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))

Environnements

Espace de travail courant, Espace de travail temporaire, Validation automatique

Informations de licence

• Basic: Limité
• Standard: Oui
• Advanced: Oui