Ajouter un sous-type (Outils de gestion des données)

Résumé

Ajoute un nouveau sous-type aux sous-types de la table en entrée.

Utilisation

Vous devez attribuer un champ de la classe d'entités ou de la table comme champ de sous-type avant d'ajouter de nouveaux sous-types. Pour ce faire, utilisez l’outil Définir le champ de sous-type.
Si vous ajoutez un sous-type dont le code existe déjà, l’outil renvoie un message d’erreur.
Si vous devez modifier le nom (également appelé description) d’un sous-type existant, vous devez d’abord supprimer le sous-type, puis ajouter un nouveau sous-type avec le même code et un nouveau nom.
Vous pouvez également afficher et gérer des sous-types dans la vue des sous-types qui s’ouvre en cliquant sur le bouton Subtypes (Sous-types) dans la section Design (Création) du ruban Data (Données) ou en cliquant sur le bouton Subtypes (Sous-types) du ruban Fields view (Vue des champs).

Etiqueter	Explication	Type de données
Input Table (Table en entrée)	Classe d'entités ou table contenant la définition du sous-type à mettre à jour.	Table View
Code de sous-type	Valeur entière unique du sous-type à ajouter.	Long
Nom du sous-type	Nom (également appelé description) du code du sous-type.	String

Sortie dérivée

Etiqueter	Explication	Type de données
Table en entrée mise à jour	Table ou classe d’entités mise à jour.	Table View

arcpy.management.AddSubtype(in_table, subtype_code, subtype_description)

Nom	Explication	Type de données
in_table	Classe d'entités ou table contenant la définition du sous-type à mettre à jour.	Table View
subtype_code	Valeur entière unique du sous-type à ajouter.	Long
subtype_description	Nom (également appelé description) du code du sous-type.	String

Sortie dérivée

Nom	Explication	Type de données
out_table	Table ou classe d’entités mise à jour.	Table View

Exemple de code

Exemple 1 d’utilisation de AddSubtype (fenêtre Python)

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

import arcpy
arcpy.env.workspace = "C:/data/Montgomery.gdb"
arcpy.management.SetSubtypeField("water/fittings", "TYPECODE")
arcpy.management.AddSubtype("water/fittings", "1", "Bend")

Exemple 2 d’utilisation de AddSubtype (script autonome)

Le script autonome suivant montre comment utiliser la fonction AddSubtype dans le cadre d’un processus pour ajouter des sous-types à un champ.

# Name: ManageSubtypes.py
# Purpose: Create a subtype definition

# Import system modules
import arcpy

# Set the workspace (to avoid having to type in the full path to the data every time)
arcpy.env.workspace =  "C:/data/Montgomery.gdb"

# Set local parameters
inFeatures = "water/fittings"

# Process: Set Subtype Field...
arcpy.management.SetSubtypeField(inFeatures, "TYPECODE")

# Process: Add Subtypes...
# Store all the suptype values in a dictionary with the subtype code as the
# "key" and the subtype name as the "value" (stypeDict[code])
stypeDict = {"0": "Unknown", "1": "Bend", "2": "Cap", "3": "Cross",
             "4": "Coupling", "5": "Expansion joint", "6": "Offset",
             "7": "Plug", "8": "Reducer", "9": "Saddle", "10": "Sleeve",
             "11": "Tap", "12": "Tee", "13": "Weld", "14": "Riser"}

# use a for loop to cycle through the dictionary
for code in stypeDict:
    arcpy.management.AddSubtype(inFeatures, code, stypeDict[code])

# Process: Set Default Subtype...
arcpy.management.SetDefaultSubtype(inFeatures, "4")

Exemple 3 d’utilisation de AddSubtype (script autonome)

Le script suivant utilise un bloc try/except pour gérer l’erreur retournée par la fonction AddSubtype lorsqu’un code de sous-type existe déjà pour le champ.

# Name: ManageSubtypes2.py
# Purpose: Add more subtype definitions

# Import system modules
import arcpy

# Set the workspace (to avoid having to type in the full path to the data every time)
arcpy.env.workspace = "C:/data/Montgomery.gdb"

# Set local parameters
inFeatures = "water/fittings"

# Define new subtypes to be added
# Store all the suptype values in a dictionary with the subtype code as the
# "key" and the subtype name as the "value" (stypeDict[code])
stypeDict = { "5": "Expansion joint", "6": "Offset", "7": "Plug", 
             "8": "Reducer", "9": "Saddle", "10": "Sleeve",
             "11": "Tap", "12": "Tee", "13": "Weld", "14": "Riser"}

# Process: Add Subtypes...
# use a for loop to cycle through the dictionary
# use a try/except to catch errors from any subtypes that already exist on the field
for code in stypeDict:
    try:
        arcpy.management.AddSubtype(inFeatures, code, stypeDict[code])
    except:
        print(f"Skipping '{code}: {stypeDict[code]}' as it is already a subtype on the field.")

Environnements

Validation automatique, Espace de travail courant

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui

Ajouter un sous-type (Outils de gestion des données)

Résumé

Utilisation

Paramètres

Sortie dérivée

Environnements

Informations de licence

Rubriques connexes