複数の条件値およびフィールド グループをカンマ区切り値ファイル (.csv) ファイルからデータセットにインポートします。
このツールは、値を置き換える、または新しい値を既存の値と組み合わせるオプションを使って、条件値とフィールド グループをデータセットにインポートします。
ターゲット テーブルのスキーマがインポートする値と一致する必要があります。 .csv で指定されたフィールドまたは値がターゲット データセットにない場合、フィールド グループまたは条件値はインポートされません。
ターゲット テーブルがエンタープライズ ジオデータベースに格納されている場合、このツールはデータの所有者として実行する必要があります。
このツールは、[条件値のエクスポート (Export Contingent Values)] ツールと組み合わせて使用できます。
フィールド グループをデータセットに追加すると、データセット バージョンが ArcGIS Pro 2.3 に設定されます。すなわち、このデータセットは ArcMap では使用できなくなります。
フィールド グループ ファイル (.csv) は、NAME、IS_RESTRICTIVE、FIELD の列を含みます。 必要に応じて FIELD 列名を増やし、フィールド グループのすべてのフィールドを含めます (FIELD1、FIELD2、FIELD3 など)。
| 列 | 説明 | 例 |
|---|---|---|
NAME | フィールド グループ名 | AnimalCategories |
IS_RESTRICTIVE | フィールド グループが制限されるかどうかを指定します。 | TRUE |
FIELD1 | フィールドの名前 | category |
条件値ファイル (.csv) は、CAV_ID、 IS_RETIRED、FIELD_GROUP、SUBTYPE、SUBTYPE_NAME、CV_TYPE、CV_VALUE、DESCRIPTION の各列を含みます。
条件値定義の構造と一致させるために必要な数の CV_TYPE、CV_VALUE、DESCRIPTION の列があります。 これらの列名は必要に応じて増やし (CV_TYPE1、CV_VALUE1、DESCRIPTION1、CV_TYPE2、CV_VALUE2、DESCRIPTION2 など)、フィールド グループ ファイル (.csv) 内のフィールドの順序に対応します。 たとえば、条件値ファイル (.csv) 内の CV_TYPE1、CV_VALUE1、DESCRIPTION1 は、フィールド グループ ファイル (.csv) 内の FIELD1 と一致します。
| 列 | 説明 | 例 |
|---|---|---|
CAV_ID | 条件値の ID。 | 1 |
IS_RETIRED | 条件値を廃止するかどうかを定義するブール値。 | False |
FIELD_GROUP | 条件値が対応するフィールド グループの名前。 | 動物カテゴリ |
SUBTYPE | データセットにサブタイプがあり、そのサブタイプが条件値定義で使用されている場合、これがルールの適用先のサブタイプ コードになります。 | 2 |
SUBTYPE_NAME | データセットにサブタイプがあり、そのサブタイプが条件値定義で使用されている場合、これがサブタイプ コードの説明テキストになります。 | 変温 |
CV_TYPE1 | 条件値のタイプ。 タイプ値は、次のように整数として格納されます。
| 3 |
CV_VALUE1 | 特定のフィールド値。 タイプがすべてまたは NULL の場合、.csv ファイルの値が空になります。 | 1 |
DESCRIPTION1 | 条件値のタイプがコード値の場合、コード値の説明テキストになります。 | 魚類 |
| ラベル | 説明 | データ タイプ |
ターゲット テーブル | フィールド グループおよび条件値のインポート先となる入力ジオデータベース テーブルまたはフィーチャクラス。 | Table View |
フィールド グループ入力ファイル (.csv) | フィールド グループに関する情報を含む特定の列名を持つ .csv ファイル。 | File |
条件値入力ファイル (.csv) | 条件値に関する情報を含む特定の列名を持つ .csv ファイル。 | File |
既存の条件値の置き換え (オプション) | インポート時に既存の値を置き換えるか、マージするかを指定します。
| Boolean |
| ラベル | 説明 | データ タイプ |
| 更新されたテーブル | インポートされたフィールド グループおよび条件値を含む更新されたターゲット テーブル。 | Table View; Raster Layer; Mosaic Layer |
arcpy.management.ImportContingentValues(target_table, field_group_file, contingent_value_file, {import_type})| 名前 | 説明 | データ タイプ |
target_table | フィールド グループおよび条件値のインポート先となる入力ジオデータベース テーブルまたはフィーチャクラス。 | Table View |
field_group_file | フィールド グループに関する情報を含む特定の列名を持つ .csv ファイル。 | File |
contingent_value_file | 条件値に関する情報を含む特定の列名を持つ .csv ファイル。 | File |
import_type (オプション) | インポート時に既存の値を置き換えるか、マージするかを指定します。
| Boolean |
| 名前 | 説明 | データ タイプ |
| updated_table | インポートされたフィールド グループおよび条件値を含む更新されたターゲット テーブル。 | Table View; Raster Layer; Mosaic Layer |
フィールド グループおよび条件値を GasPipes データセットにインポートして、既存の値を置き換えます。
import arcpy
arcpy.management.ImportContingentValues("C:\\MyProject\\myConn.sde\\pro.USER1.Animals",
"C:\\MyProject\\MyFieldGroups.csv",
"C:\\MyProject\\MyContingentValues.csv",
"REPLACE")