条件値の追加 (Add Contingent Value) (データ管理)

サマリー

条件値をフィーチャクラスまたはテーブル上のフィールド グループに追加します。

条件値の詳細

使用法

• 条件値を追加するには、データセット内に 1 つ以上のフィールド グループが作成されている必要があります。[フィールド グループの追加 (Create Field Group)] ツールを使用して、フィールド グループを作成できます。

• 入力フィーチャクラスまたはテーブルにサブタイプがあり、条件値を複数のサブタイプに追加したい場合は、このツールをサブタイプごとに 1 回実行する必要があります。一度にすべてのサブタイプに追加するオプションはありません。

• データがエンタープライズ ジオデータベースに格納されている場合、このツールを使用するにはデータ所有者として接続する必要があります。

• 条件値は ArcGIS Pro 2.3 以降のジオデータベースと互換性があります。ジオデータベースがこれより前のバージョンの場合は、条件値に対応したバージョンにジオデータベースをアップグレードします。

• フィールド グループをデータセットに追加すると、データセット バージョンが ArcGIS Pro 2.3 に設定されます。すなわち、このデータセットは ArcMap では使用できなくなります。

パラメーター

ダイアログ

ラベル	説明	データ タイプ
ターゲット テーブル	条件値を追加する入力ジオデータベース フィーチャクラスまたはテーブル。	Table View
フィールド グループ名	条件値を追加するフィールド グループ。	String
値	新しい条件値に使用されるフィールド名、フィールド値タイプ、および関連フィールド値。 フィールド名 - フィールド グループに属しているフィールドの名前。 フィールド値タイプ - 条件値のタイプ。タイプを [ANY] または [NULL] に設定すると、[フィールド値] フィールドに指定された値が無視されます。 ANY - 値がすべてのフィールド値になります。 NULL - 値が NULL 値になります。 CODED VALUE - 値がコード値ドメイン内の値になります。 RANGE - 値が範囲ドメインの最小/最大サブセットになります。 フィールド値 - 特定のフィールド値。[フィールド値タイプ] が [CODED VALUE] の場合は、コード値の説明を指定します。[フィールド値タイプ] が [RANGE] の場合は、最小値と最大値を「最小値;最大値」の形式で指定します (例: 10;100)。	Value Table
サブタイプ (オプション)	条件値を追加する入力テーブルのサブタイプ。	String
値の廃止 (オプション)	条件値を廃止するかどうかを指定します。条件値は、作成されなくなった時点で廃止と見なされますが、既存のフィールドでまだ使用されていることがあります。条件値を廃止すると、その条件値は、[属性] ウィンドウなど、特定のフィールドに有効な値のリストにまだ表示されますが、無効な値となり、フィールド値として選択することができなくなります。たとえば、アスベストを建築材料として使用するとします。新しい建築物では、アスベストを建築材料として使用できませんが、既存の建築物でこの属性がまだ使用されていることがあります。 オン - 条件値が廃止されます。 オフ - 条件値は廃止されません。これがデフォルトです。	Boolean

派生した出力

ラベル	説明	データ タイプ
出力フィーチャクラス	追加した条件値が反映された入力テーブル。	テーブル ビュー; ラスター レイヤー; モザイク レイヤー

Python

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

名前	説明	データ タイプ
target_table	条件値を追加する入力ジオデータベース フィーチャクラスまたはテーブル。	Table View
field_group_name	条件値を追加するフィールド グループ。	String
values [[Field Name, Field Value Type, Field Value],...]	新しい条件属性値に使用されるフィールド名、フィールド値タイプ、および関連フィールド値。 Field Name - フィールド グループに属しているフィールドの名前。 Field Value Type - 条件値のタイプ。タイプを [ANY] または [NULL] に設定すると、[Field Value] パラメーターに指定された値が無視されます。 ANY - 値がすべてのフィールド値になります。 NULL - 値が NULL 値になります。 CODED_VALUE - 値がコード値ドメイン内の値になります。 RANGE - 値が範囲ドメインの最小/最大サブセットになります。 フィールド値 - 特定のフィールド値。[Field Value Type] が [CODED_VALUE] の場合は、コード値の説明を指定します。[Field Value Type] が [RANGE] の場合は、最小値と最大値を「最小値;最大値」の形式で指定します (例: 10;100)。	Value Table
subtype (オプション)	条件値を追加する入力テーブルのサブタイプ。	String
retire_value (オプション)	条件値を廃止するかどうかを指定します。条件値は、作成されなくなった時点で廃止と見なされますが、既存のフィールドでまだ使用されていることがあります。条件値を廃止すると、その条件値は、[属性] ウィンドウなど、特定のフィールドに有効な値のリストにまだ表示されますが、無効な値となり、フィールド値として選択することができなくなります。たとえば、アスベストを建築材料として使用するとします。新しい建築物では、アスベストを建築材料として使用できませんが、既存の建築物でこの属性がまだ使用されていることがあります。 RETIRE—条件値が廃止されます。 DO_NOT_RETIRE—条件値は廃止されません。これがデフォルトです。	Boolean

派生した出力

名前	説明	データ タイプ
out_table	追加した条件値が反映された入力テーブル。	テーブル ビュー; ラスター レイヤー; モザイク レイヤー

コードのサンプル

AddContingentValue (条件値の追加) の例 (Python ウィンドウ)

コード値ドメインがフィールドに割り当てられている新しい条件値を追加します。

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

環境

現在のワークスペース

特殊なケース

ライセンス情報

• Basic: Yes
• Standard: Yes
• Advanced: Yes