Zusammenfassung
Fügt einen Gruppenwert zu einer Feldgruppe in einer Feature-Class oder Tabelle hinzu.
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.
Syntax
AddContingentValue(target_table, field_group_name, values, {subtype}, {retire_value})
Parameter | Erklärung | Datentyp |
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.
| 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.
| Boolean |
Abgeleitete Ausgabe
Name | Erklärung | Datentyp |
out_table | Die aktualisierte Eingabe mit einem hinzugefügten Gruppenwert. | Tabellensicht; Raster-Layer; Mosaik-Layer |
Codebeispiel
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")
Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja