Récapitulatif
Met à jour la classe d'entités annotations en entrée avec les champs attributaires de texte et renseigne éventuellement chaque nouveau champ pour toutes les entités figurant dans la classe d'entités.
Utilisation
Cet outil peut être exécuté sur une classe d'entités versionnée si l'option permettant de renseigner des champs attributaires est désactivée. Dans ce cas, la structure de la classe d'entités est mise à jour mais les nouveaux champs d'annotation ne sont pas renseignés. Les valeurs d'attribut d'une entité restent vides jusqu'à l'édition de l'entité.
Cet outil met à jour la structure de la classe d'entités et, éventuellement, chaque entité annotations figurant dans la classe d'entités. La mise à jour de la structure permet d'ajouter des champs à la classe d'entités (gras, italique, texte, etc.) et de garantir que la collection de symboles n'est pas vide. Si la collection de symboles est vide, il est impossible d'utiliser les améliorations apportées pour créer des entités annotations.
Le renseignement des champs attributaires est une opération fastidieuse qui nécessite de mettre à jour chaque entité. Si vous désactivez cette option, les champs sont ajoutés mais ne sont pas renseignés. Si les champs ne sont pas renseignés à la mise à jour, ils restent vides jusqu'à ce que l'entité soit modifiée.
Syntaxe
UpdateAnnotation_management (in_features, {update_values})| Paramètre | Explication | Type de données |
in_features | Classe d'entités annotations en entrée à laquelle sont ajoutés les nouveaux champs. | Feature Layer |
update_values (Facultatif) | Renseigne chacun des nouveaux champs pour toutes les entités de la classe d'entités.
| Boolean |
Exemple de code
Exemple d'utilisation de l'outil UpdateAnnotation (fenêtre Python)
Le script de fenêtre Python suivant illustre l'utilisation de l'outil UpdateAnnotation en mode immédiat.
import arcpy
arcpy.env.workspace = "C:/data/Ontario.mdb"
arcpy.UpdateAnnotation_management("ProvParks_anno", "POPULATE")
Exemple d'utilisation de l'outil UpdateAnnotation (script Python autonome)
Le script autonome suivant montre comment utiliser l'outil UpdateAnnotation.
# Name: UpdateAnnotation_Example.py
# Description: Use UpdateAnnotation to update ArcGIS 8.3 annotation feature classes
# to ArcGIS 9.0
# import system modules
import arcpy
import os
# Set environment settings
# User input geodatabase location - eg. C:/data/anno83.mdb
arcpy.env.workspace = input('Annotation data location: ')
# Create list of annotation feature classes within the geodatabase
fcList = arcpy.ListFeatureClasses("", "ANNOTATION")
# Loop through the feature classes and update
for fc in fcList:
try:
# Process: Update the annotation feature classes
print("Updating " + fc + "...")
arcpy.UpdateAnnotation_management(fc, "POPULATE")
except:
# If an error occurred while running a tool print the messages
print(arcpy.GetMessages())
print("Update of annotation feature classes in " + env.workspace + " complete")
Environnements
Informations de licence
- ArcGIS for Desktop Basic: Oui
- ArcGIS for Desktop Standard: Oui
- ArcGIS for Desktop Advanced: Oui