Subtype hinzufügen (Data Management Tools)

Zusammenfassung

Fügt den Subtypes in der Eingabetabelle einen neuen Subtype hinzu.

Verwendung

Bevor Sie neue Subtypes hinzufügen können, müssen Sie zunächst ein Feld aus der Feature-Class oder Tabelle als Subtype-Feld festlegen. Hierfür verwenden Sie das Werkzeug Subtype-Feld festlegen.
Wenn Sie einen Subtype hinzufügen, dessen Code bereits vorhanden ist, gibt das Werkzeug eine Fehlermeldung zurück.
Wenn Sie den Namen (auch: Beschreibung) eines vorhandenen Subtypes ändern möchten, müssen Sie zunächst den Subtype entfernen und anschließend einen neuen Subtype mit demselben Code und einem neuen Namen hinzufügen.
Subtypes können auch in der Subtypes-Ansicht angezeigt und verwaltet werden, indem Sie im Abschnitt Design des Menübands Daten auf Subtypes oder auf dem Menüband Ansicht "Felder" auf Subtypes klicken.

Beschriftung	Erläuterung	Datentyp
Eingabetabelle	Die Feature-Class oder Tabelle mit der zu aktualisierenden Subtype-Definition.	Table View
Subtype-Code	Ein eindeutiger Integer-Wert für den hinzuzufügenden Subtype.	Long
Subtype-Name	Ein Name (auch: Beschreibung) des Subtype-Codes.	String

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Aktualisierte Eingabetabelle	Die aktualisierte Tabelle oder Feature-Class.	Table View

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

Name	Erläuterung	Datentyp
in_table	Die Feature-Class oder Tabelle mit der zu aktualisierenden Subtype-Definition.	Table View
subtype_code	Ein eindeutiger Integer-Wert für den hinzuzufügenden Subtype.	Long
subtype_description	Ein Name (auch: Beschreibung) des Subtype-Codes.	String

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
out_table	Die aktualisierte Tabelle oder Feature-Class.	Table View

Codebeispiel

AddSubtype: Beispiel 1 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion AddSubtype im Direkt-Modus verwendet wird.

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

AddSubtype: Beispiel 2 (eigenständiges Skript)

Mit dem folgenden eigenständigen Skript wird veranschaulicht, wie Subtypes mit der Funktion AddSubtype einem Feld hinzugefügt werden.

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

AddSubtype: Beispiel 3 (eigenständiges Skript)

Das folgende Skript verwendet einen try/except-Block zur Verarbeitung des Fehlers, der von der Funktion 'AddSubtype' zurückgegeben wird, wenn für das Feld bereits ein Subtype-Code vorhanden ist.

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

Umgebungen

Auto-Commit, Aktueller Workspace

Lizenzierungsinformationen

Basic: Ja
Standard: Ja
Advanced: Ja

Subtype hinzufügen (Data Management Tools)

Zusammenfassung

Verwendung

Parameter

Abgeleitete Ausgabe

Umgebungen

Lizenzierungsinformationen

Verwandte Themen