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, muss das Werkzeug für jeden Subtype einmal ausgeführt werden. Es gibt keine Möglichkeit, alle Subtypes gleichzeitig hinzuzufü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 Ihre Geodatabase eine niedrigere Version aufweist, müssen Sie die Geodatabase 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. Mit 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 spezielle Feldwert. Wenn für Feldwerttyp der Typ Codierter Wert festgelegt ist, geben Sie die Code-Beschreibung 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. Allerdings ist er nicht aktiv, und Sie können ihn nicht als Feldwert auswählen. 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.

  • 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 Gruppenattributwert verwendet werden sollen.

  • Field Name: Der Name des Feldes, das zur Feldgruppe gehört.
  • Field Value Type: Der Typ des Gruppenwertes. Die ANY- und NULL-Typen ignorieren die im Parameter Field Value angegebenen Werte.
    • 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 spezielle Feldwert. Wenn für Field Value Type der Typ CODED_VALUE festgelegt ist, geben Sie die Code-Beschreibung an. Wenn für Field Value Type 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. Allerdings ist er deaktiviert, und Sie können ihn nicht als Feldwert auswählen. 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.

  • 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.AddContingentValue_management("C:\\MyProject\\myConn.sde\\mygdb.USER1.myFC", 
                                    "MyFieldGroup",	CV, "My Subtype", 
                                    "DO_NOT_RETIRE")

Lizenzinformationen

  • Basic: Ja
  • Standard: Ja
  • Advanced: Ja

Verwandte Themen