Agregar subtipo (Herramientas de administración de datos)

Resumen

Agrega un nuevo subtipo a los subtipos de la tabla de entrada.

Uso

En la tabla o clase de entidad, se debe asignar un campo como campo de subtipo antes de que se puedan agregar subtipos nuevos. Se hace con la herramienta Establecer campo de subtipo.
Si agrega un subtipo cuyo código ya existe, la herramienta mostrará un mensaje de error.
Si necesita cambiar el nombre (también llamado descripción) de un subtipo existente, primero deberá quitar el subtipo, después agregar un subtipo nuevo con el mismo código y un nuevo nombre.
También puede ver y administrar los subtipos en la Vista de subtipos, que puede abrirse haciendo clic en el botón Subtipos situado en la sección Diseño de la cinta Datos o haciendo clic en el botón Subtipos de la cinta Vista de campos.

Etiqueta	Explicación	Tipo de datos
Tabla de entrada	Tabla o clase de entidad que contiene la definición de subtipo que se actualizará.	Table View
Código de subtipo	Un valor entero único para el subtipo que se agregará.	Long
Nombre de subtipo	Un nombre (también llamado descripción) del código de subtipo.	String

Salida derivada

Etiqueta	Explicación	Tipo de datos
Tabla de entrada actualizada	La clase de entidad o tabla actualizada.	Table View

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

Nombre	Explicación	Tipo de datos
in_table	Tabla o clase de entidad que contiene la definición de subtipo que se actualizará.	Table View
subtype_code	Un valor entero único para el subtipo que se agregará.	Long
subtype_description	Un nombre (también llamado descripción) del código de subtipo.	String

Salida derivada

Nombre	Explicación	Tipo de datos
out_table	La clase de entidad o tabla actualizada.	Table View

Muestra de código

Ejemplo 1 de "AddSubtype" (ventana de Python)

El siguiente script de ventana de Python demuestra cómo utilizar la función AddSubtype en el modo inmediato.

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

Ejemplo 2 de "AddSubtype" (script independiente)

El siguiente script independiente muestra cómo utilizar la función AddSubtype como parte de un flujo de trabajo para agregar subtipos a un campo.

# 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")

Ejemplo 3 de "AddSubtype" (script independiente)

El siguiente script utiliza un bloque try/"except" para gestionar el error que devuelve la función "AddSubtype" cuando ya existe un código de subtipo para el campo.

# 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.")

Entornos

Auto ejecución, Espacio de trabajo actual

Información de licenciamiento

Basic: Sí
Standard: Sí
Avanzado: Sí

Agregar subtipo (Herramientas de administración de datos)

Resumen

Uso

Parámetros

Salida derivada

Entornos

Información de licenciamiento

Temas relacionados