Résumé
Ajoute une représentation de classe d'entités à une classe d'entités de géodatabase.
Utilisation
L'entrée doit être une classe d'entités de géodatabase.
Deux nouveaux champs portant les noms spécifiés seront juxtaposés à la table attributaire de la classe d'entités en entrée afin d'identifier les règles de représentation régissant le mode d'affichage de chaque catégorie d'entités et de conserver les éventuels débrayages spécifiques aux entités de ces règles.
Spécifier une couche d'importation de règles pour importer des choix de symbole répertoriés sous le type de représentation (par exemple, Catégories – Valeurs uniques) spécifié sur le fichier de couches. Tous les choix de symbole seront copiés dans cette représentation de classe d'entités en tant que nouvelles règles de représentation. Si une couche d'importation de règles n'est pas spécifiée, toutes les entités seront affectées à une seule règle de représentation par défaut.
Si la couche d'importation de règles a la même classe d'entités source que la classe d'entités en entrée, vous pouvez utiliser le paramètre Attribuer des identifiants de règles pour attribuer des règles de représentation aux entités conformément aux attributions de RuleID de la couche d'importation de règles.
Si une couche d'importation de règles est spécifiée et si le paramètre Attribuer des identifiants de règles est défini sur ASSIGN, toutes les entités seront attribuées à une règle de représentation selon les choix de symbole répertoriés sous le type de représentation (par exemple, Catégories – Valeurs uniques) spécifié sur le fichier de couches. Si une couche d'importation de règles est spécifiée et si le paramètre Attribuer des identifiants de règles est défini sur NO_ASSIGN, toutes les entités seront attribuées à une seule règle de représentation par défaut.
Si <toutes les autres valeurs> est utilisé pour symboliser des entités dans la couche en entrée, ce symbole deviendra l'ID de règle 1 lorsqu'une représentation est ajoutée.
Syntaxe
arcpy.cartography.AddRepresentation(in_features, representation_name, {rule_id_field_name}, {override_field_name}, {geometry_editing_option}, {import_rule_layer}, {assign_rule_id_option})| Paramètre | Explication | Type de données |
in_features | Classe d'entités de géodatabase en entrée à laquelle une nouvelle représentation de classe d'entités sera ajoutée. | Feature Layer |
representation_name | Nom de la représentation de classe d'entités à ajouter. | String |
rule_id_field_name (Facultatif) | Nom du champ RuleID qui contiendra une référence à la règle de représentation pour chaque entité. | String |
override_field_name (Facultatif) | Nom du champ de débrayage qui contiendra les débrayages des règles de représentation pour chaque entité. | String |
geometry_editing_option (Facultatif) | Indique ce qui arrivera à la géométrie de la classe d'entités correspondante lors de la modification des entités avec les outils de mise à jour des représentations.
| String |
import_rule_layer (Facultatif) | Couche d'entités symbolisant les entités avec une représentation de classe d'entités à partir de laquelle les règles de représentation sont importées. | Layer |
assign_rule_id_option (Facultatif) | Indique s'il faut attribuer des règles de représentation aux entités conformément aux attributions de RuleID de la couche d'importation de règles. Cette option ne s'applique que lorsque la valeur de Couche d'importation de règles est spécifiée.
| String |
Exemple de code
Exemple d'utilisation de l'outil AddRepresentation (Fenêtre Python)
Le script de fenêtre Python suivant illustre l'utilisation de l'outil AddRepresentation en mode immédiat.
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.AddRepresentation_cartography("C:/data/cartography.gdb/buildings/footprints",
"footprints_Rep", "RuleID", "Override",
"STORE_CHANGE_AS_OVERRIDE", "C:/data/footprints.lyr", "ASSIGN")
Exemple d'utilisation de l'outil AddRepresentation (script Python autonome)
Ce script autonome affiche un exemple de l'utilisation de l'outil AddRepresentation.
# Name: AddRepresentation_standalone_script.py
# Description: Adds a feature class representation
# to a geodatabase feature class.
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set local variables
in_features = "C:/data/cartography.gdb/buildings/footprints"
representation_name = "footprints_Rep"
rule_id_field_name = "RuleID"
override_field_name = "Override"
geometry_editing_option = "STORE_CHANGE_AS_OVERRIDE"
import_rule_layer = "C:/data/footprints.lyr"
assign_rule_id_option = "ASSIGN"
# Execute Add Representation
arcpy.AddRepresentation_cartography(in_features,
representation_name,
rule_id_field_name,
override_field_name,
geometry_editing_option,
import_rule_layer,
assign_rule_id_option)
Environnements
Informations de licence
- Basic: Non
- Standard: Oui
- Advanced: Oui