Gruppenwert hinzufügen (Data Management)

Zusammenfassung

Fügt einen Gruppenwert zu einer Feldgruppe in einer Feature-Class oder Tabelle hinzu.

Weitere Informationen zu Gruppenwerten

Verwendung

  • Für das Dataset muss mindestens eine Feldgruppe erstellt werden, bevor ein Gruppenwert hinzugefügt werden kann. Das Werkzeug Feldgruppe erstellen kann zum Erstellen einer Feldgruppe verwendet werden.

  • Wenn die Eingabe-Feature-Class oder -tabelle Subtypes aufweist und Sie den Gruppenwert mehr als einem Subtype hinzufügen möchten, müssen Sie dieses Werkzeug für jeden Subtype einmal ausführen. Sie können nicht allen Subtypes gleichzeitig hinzufügen.

  • Wenn Ihre Daten in einer Enterprise-Geodatabase gespeichert sind, müssen Sie als Datenbesitzer verbunden sein, um dieses Werkzeug zu verwenden.

  • Gruppenwerte sind mit Geodatabases der Version ArcGIS Pro 2.3 und höher kompatibel. Wenn die Geodatabase eine niedrigere Version aufweist, müssen Sie sie aktualisieren, um Gruppenwerte verwenden zu können.

  • Nachdem eine Feldgruppe zu einem Dataset hinzugefügt wurde, wird als Dataset-Version ArcGIS Pro 2.3 festgelegt. Das bedeutet, dass das Dataset nicht mehr in ArcMap verwendet werden kann.

Parameter

BeschriftungErläuterungDatentyp
Zieltabelle

Die Eingabe-Geodatabase-Feature-Class oder -tabelle, der der Gruppenwert hinzugefügt wird.

Table View
Feldgruppenname

Die Feldgruppe, der der Gruppenwert hinzugefügt wird.

String
Werte

Der Feldname, der Feldwerttyp und die zugehörigen Feldwerte, die für den neuen Gruppenwert verwendet werden sollen.

  • Feldname: Der Name des Feldes, das zur Feldgruppe gehört.
  • Feldwerttyp: Der Typ des Gruppenwertes. Bei den Typen Beliebig und NULL werden die im Feld Feldwert angegebenen Werte ignoriert.
    • Beliebig: Der Wert kann ein beliebiger Feldwert sein.
    • NULL: Der Wert ist NULL.
    • Codierter Wert: Der Wert stammt aus einer Domäne mit codierten Werten.
    • Bereich: Der Wert ist eine minimale/maximale Teilmenge einer Bereichsdomäne.
  • Feldwert: Der spezifische Feldwert. Wenn als Feldwerttyp der Typ Codierter Wert festgelegt ist, geben Sie den Code an. Wenn für Feldwerttyp der Typ Bereich festgelegt ist, geben Sie die Minimal- und Maximalwerte im Format "Minimum;Maximum" an (z. B. 10;100).

Value Table
Subtype
(optional)

Der Eingabetabelle-Subtype, zu dem der Gruppenwert hinzugefügt wird.

String
Wert außer Kraft setzen
(optional)

Gibt an, ob der Gruppenwert außer Kraft gesetzt wird. Der Gruppenwert gilt als außer Kraft gesetzt, wenn er nicht mehr erstellt werden kann, aber in einem vorhandenen Feld weiterhin verwendet werden kann. Wenn ein Gruppenwert außer Kraft gesetzt wird, wird er dennoch in der Liste der gültigen Werte für ein Feld angezeigt, beispielsweise im Bereich Attribut. Ein Beispiel ist die Verwendung von Asbest als Baumaterial. In neuen Konstruktionen kann Asbest nicht als Baumaterial verwendet werden, vorhandene Bauwerke können dieses Attribut jedoch noch aufweisen. Weitere Informationen zu außer Kraft gesetzten Werten finden Sie unter Erstellen und Verwalten von Gruppenwerten.

  • Aktiviert: Der Gruppenwert wird außer Kraft gesetzt.
  • Deaktiviert: Der Gruppenwert wird nicht außer Kraft gesetzt. Dies ist die Standardeinstellung.

Boolean

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Ausgabe-Feature-Class

Die aktualisierte Eingabe mit einem hinzugefügten Gruppenwert.

Table View; Raster Layer; Mosaic Layer

arcpy.management.AddContingentValue(target_table, field_group_name, values, {subtype}, {retire_value})
NameErläuterungDatentyp
target_table

Die Eingabe-Geodatabase-Feature-Class oder -tabelle, der der Gruppenwert hinzugefügt wird.

Table View
field_group_name

Die Feldgruppe, der der Gruppenwert hinzugefügt wird.

String
values
[[Field Name, Field Value Type, Field Value],...]

Der Feldname, der Feldwerttyp und die zugehörigen Feldwerte, die für den neuen Gruppenwert verwendet werden sollen.

  • Feldname: Der Name des Feldes, das zur Feldgruppe gehört.
  • Feldwerttyp: Der Typ des Gruppenwertes. Bei den Typen ANY und NULL werden die im Feld "Feldwert" angegebenen Werte ignoriert.
    • ANY: Der Wert kann ein beliebiger Feldwert sein.
    • NULL: Der Wert ist NULL.
    • CODED_VALUE: Der Wert stammt aus einer Domäne mit codierten Werten.
    • RANGE: Der Wert ist eine minimale/maximale Teilmenge einer Bereichsdomäne.
  • Feldwert: Der spezifische Feldwert. Wenn der Feldwerttyp CODED_VALUE lautet, geben Sie den Code an. Wenn für den Feldwerttyp der Typ RANGE festgelegt ist, geben Sie die Minimal- und Maximalwerte im Format "Minimum;Maximum" an (z. B. 10;100).

Value Table
subtype
(optional)

Der Eingabetabelle-Subtype, zu dem der Gruppenwert hinzugefügt wird.

String
retire_value
(optional)

Gibt an, ob der Gruppenwert außer Kraft gesetzt wird. Der Gruppenwert gilt als außer Kraft gesetzt, wenn er nicht mehr erstellt werden kann, aber in einem vorhandenen Feld weiterhin verwendet werden kann. Wenn ein Gruppenwert außer Kraft gesetzt wird, wird er dennoch in der Liste der gültigen Werte für ein Feld angezeigt, beispielsweise im Bereich Attribut. Ein Beispiel ist die Verwendung von Asbest als Baumaterial. In neuen Konstruktionen kann Asbest nicht als Baumaterial verwendet werden, vorhandene Bauwerke können dieses Attribut jedoch noch aufweisen. Weitere Informationen zu außer Kraft gesetzten Werten finden Sie unter Erstellen und Verwalten von Gruppenwerten.

  • RETIREDer Gruppenwert wird außer Kraft gesetzt.
  • DO_NOT_RETIREDer Gruppenwert wird nicht außer Kraft gesetzt. Dies ist die Standardeinstellung.
Boolean

Abgeleitete Ausgabe

NameErläuterungDatentyp
out_table

Die aktualisierte Eingabe mit einem hinzugefügten Gruppenwert.

Table View; Raster Layer; Mosaic Layer

Codebeispiel

AddContingentValue: Beispiel (Python-Fenster)

Fügen Sie einen neuen Gruppenwert hinzu, dessen Feld eine Domäne mit codierten Werten zugewiesen ist.

import arcpy
CV = [["FieldName1", "CODED_VALUE", "DomainValue1"], 
      ["FieldName2", "CODED_VALUE", "DomainValue2"]]
arcpy.management.AddContingentValue("C:\\MyProject\\myConn.sde\\mygdb.USER1.myFC", 
                                    "MyFieldGroup", CV, "My Subtype", 
                                    "DO_NOT_RETIRE")

Verwandte Themen