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

Synthèse

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 dans 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 AllSource 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, 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’entités annotations liées aux entités en sortie.

  • Cet outil gère les classes d’entités annotations ayant des structures différentes. Si les classes d’entités annotations ont la même structure, utilisez l’outil Append (Ajouter).

Paramètres

ÉtiquetteExplicationType de données
Entités en entrée

Annotations en entrée qui forment une classe d’annotations dans la classe d’entités en sortie.

Feature Layer
Classe d'entités en sortie

Classe d’entités annotations, nouvelle ou existante, qui contient une classe d’annotations pour chaque classe d’entités annotations en entrée.

Feature Class
Echelle de référence

É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
Créer une classe d’annotations unique
(Facultatif)

Spécifie comment les entités annotations seront ajoutées à la classe d'entités en sortie.

  • Activé : toutes les entités annotations sont agrégées dans une classe d’annotations au sein de la classe d’entités en sortie.
  • Désactivé : 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 ont le même nom et les mêmes propriétés. Dans ce cas, elles sont fusionnées. Il s’agit de l’option par défaut.
Boolean
Sélection du symbole dans la table
(Facultatif)

Spécifie comment les symboles peuvent être sélectionnés pour les entités annotations qui viennent d'être créées.

  • Activé : seule la liste des symboles dans la collection de symboles de la classe d’entités en sortie peut être utilisée pour créer les entités annotations.
  • Désactivé : toutes les symbologies peuvent être utilisées pour créer les entités annotations. Il s’agit de l’option par défaut.
Boolean
Créer une annotation lors de l’ajout de nouvelles entités (annotation liée aux entités uniquement)
(Facultatif)

Spécifie si une annotation liée à une entité est créée lorsqu’une entité est ajoutée.

  • Activé : une annotation liée aux entités est créée au moyen du moteur d’étiquetage lorsqu’une entité liée est ajoutée. Il s’agit de l’option par défaut.
  • Désactivé : aucune annotation liée aux entités n’est créée lors de l’ajout d’une entité.
Boolean
Mettre à jour une annotation lorsque la forme de l’entité associée est modifiée (annotation liée aux entités uniquement)
(Facultatif)

Spécifie si l’annotation liée aux entités est mise à jour lors de la modification d’une entité liée.

  • Activé : une annotation liée aux entités est mise à jour au moyen du moteur d’étiquetage lorsqu’une entité liée est modifiée. Il s’agit de l’option par défaut.
  • Désactivé : aucune annotation liée aux entités n’est mise à jour lors de la modification d’une entité.
Boolean

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})
NomExplicationType de données
input_features
[input_features,...]

Annotations en entrée qui forment une classe d’annotations dans la classe d’entités en sortie.

Feature Layer
output_featureclass

Classe d’entités annotations, nouvelle ou existante, qui contient 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_ONLYToutes les entités annotations sont agrégées dans une classe d’annotations au sein de la classe d’entités en sortie.
  • CREATE_CLASSESDes 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 ont le même nom et 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_SYMBOLSeule la liste des symboles dans la collection de symboles de la classe d’entités en sortie peut être utilisée pour créer les entités annotations.
  • NO_SYMBOL_REQUIREDToutes les symbologies peuvent être utilisées pour créer les entités annotations. Il s’agit de l’option par défaut.
Boolean
create_annotation_when_feature_added
(Facultatif)

Spécifie si une annotation liée à une entité est créée lorsqu’une entité est ajoutée.

  • AUTO_CREATEUne annotation liée aux entités est créée au moyen du moteur d’étiquetage lorsqu’une entité liée est ajoutée. Il s’agit de l’option par défaut.
  • NO_AUTO_CREATEAucune annotation liée aux entités n’est créée lors de l’ajout d’une entité.
Boolean
update_annotation_when_feature_modified
(Facultatif)

Spécifie si l’annotation liée aux entités est mise à jour lors de la modification d’une entité liée.

  • AUTO_UPDATEUne annotation liée aux entités est mise à jour au moyen du moteur d’étiquetage lorsqu’une entité liée est modifiée. Il s’agit de l’option par défaut.
  • NO_AUTO_UPDATEAucune annotation liée aux entités n’est mise à jour lors de la modification d’une entité.
Boolean

Exemple de code

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

Le script de fenêtre Python ci-dessous illustre l’utilisation de la fonction AppendAnnotation en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data/Cobourg.gdb"
arcpy.management.AppendAnnotation(["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 ci-dessous illustre l’utilisation de la fonction 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.management.AppendAnnotation(fcList, outFeatureClass, refScale, 
                                  createClasses, symbolReq, autoCreate, 
                                  autoUpdate)

print("Annotation feature classes in {} have been appended into {}".format(
    arcpy.env.workspace, outFeatureClass))

Rubriques connexes