Définir le champ de sous-type (Gestion des données)

Synthèse

Définit le champ dans la table ou la classe d'entités en entrée qui stocke les codes de sous-type.

Utilisation

• Une classe d'entités ou une table ne peut avoir qu'un seul champ de sous-type.

• Une fois un champ de sous-type défini, les codes de sous-type peuvent être ajoutés à la classe d'entités ou à la table à l'aide de l'outil Ajouter un sous-type.

• Vous pouvez également afficher et gérer des sous-types dans Vue des sous-types qui apparaît en cliquant sur le bouton Sous-types dans la section Création du ruban Données ou en cliquant sur le bouton Sous-types du ruban Vue des champs.

• Cet outil peut également servir à effacer un champ de sous-type s’il devient inutile.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Table en entrée	Classe d’entités ou table en entrée qui contient le champ à définir comme champ de sous-type.	Table View
Nom de champ (Facultatif)	Champ d’entier qui stocke les codes de sous-type.	Field
Supprimer la valeur (Facultatif)	Indique si le champ de sous-type doit être effacé ou non. Activé : le champ de sous-type va être effacé (défini sur Null). Désactivé : le champ de sous-type ne va pas être effacé. Il s’agit de l’option par défaut.	Boolean

Sortie obtenue

Étiquette	Explication	Type de données
Table en entrée actualisée	Table ou classe d’entités mise à jour.	Vue tabulaire

Python

arcpy.management.SetSubtypeField(in_table, {field}, {clear_value})

Nom	Explication	Type de données
in_table	Classe d’entités ou table en entrée qui contient le champ à définir comme champ de sous-type.	Table View
field (Facultatif)	Champ d’entier qui stocke les codes de sous-type.	Field
clear_value (Facultatif)	Indique si le champ de sous-type doit être effacé ou non. CLEAR_SUBTYPE_FIELD—Le champ de sous-type va être effacé (défini sur Null). DO_NOT_CLEAR—Le champ de sous-type ne va pas être effacé. Il s’agit de l’option par défaut.	Boolean

Sortie obtenue

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

Exemple de code

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

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

import arcpy
arcpy.env.workspace = "C:/data/Montgomery.gdb"
arcpy.SetSubtypeField_management("water/fittings", "TYPECODE")

Exemple 2 d’utilisation de l’outil SetSubtypeField (script autonome)

Le script autonome suivant montre comment utiliser la fonction SetSubtypeField 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.SetSubtypeField_management(inFeatures, "TYPECODE")
# Process: Add Subtypes...
# Store all the subtype values in a dictionary with the subtype code as the 
# "key" and the subtype description 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.AddSubtype_management(inFeatures, code, stypeDict[code])     
# Process: Set Default Subtype...
arcpy.SetDefaultSubtype_management(inFeatures, "4", "")

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

Le script de fenêtre Python suivant illustre l’utilisation de la fonction SetSubtypeField en mode immédiat pour effacer le champ de sous-type.

import arcpy
arcpy.env.workspace = "C:/data/Montgomery.gdb"
arcpy.SetSubtypeField_management("water/fittings", "", "TRUE")

Environnements

Validation automatique, Espace de travail courant

Cas particuliers

Informations de licence

• Basic: Oui
• Standard: Oui
• Advanced: Oui