标注 | 说明 | 数据类型 |
目标表
| 将向其中导入字段组和条件值的输入地理数据库表或要素类。 | Table View |
字段组输入文件 (.csv) | 带有包含字段组相关信息的指定列名称的 .csv 文件。 | File |
条件值输入文件 (.csv) | 带有包含条件值相关信息的指定列名称的 .csv 文件。 | File |
替换现有条件值
(可选) | 指定导入时将替换还是合并现有值。
| Boolean |
派生输出
标注 | 说明 | 数据类型 |
已更新的表 | 包含所导入的字段组和条件值的已更新目标表。 | 表视图;栅格图层;镶嵌图层 |
将多个条件值和字段组从逗号分隔值文件 (.csv) 导入到数据集中。
此工具会将条件值和字段组导入到数据集中,并可选择替换值或将新值与现有值进行组合。
目标表的方案必须与要导入的值匹配。如果 .csv 文件中指定的字段或值在目标数据集中并不存在,则不会导入字段组或条件值。
如果目标表存储在企业级地理数据库中,则必须以数据所有者的身份运行此工具。
此工具可以与导出条件值工具一起使用。
将字段组添加到数据集之后,数据集版本将设置为 ArcGIS Pro 2.3。这意味着该数据集将不再可用于 ArcMap。
字段组 .csv 文件包括 NAME、IS_RESTRICTIVE 和 FIELD 列。FIELD 列名称将根据需要进行递增,以包含字段组中的所有字段,例如 FIELD1、FIELD2、FIELD3 等等。
列 | 描述 | 示例 |
---|---|---|
NAME | 字段组名称 | AnimalCategories |
IS_RESTRICTIVE | 指定字段组是否具有限制性 | TRUE |
FIELD1 | 字段的名称 | 类别 |
条件值 .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 | 条件值所对应的字段组的名称。 | AnimalCategories |
SUBTYPE | 如果数据集具有子类型且子类型已用于条件值定义,则此字段是应用此规则的子类型代码。 | 2 |
SUBTYPE_NAME | 如果数据集具有子类型且子类型已用于条件值定义,则此字段为子类型代码的文本描述。 | Cold blooded |
CV_TYPE1 | 条件值的类型。类型值将存储为整数,如下所示:
| 3 |
CV_VALUE1 | 特定字段值。如果类型为任意或空,则 .csv 文件中的值为空。 | 1 |
DESCRIPTION1 | 如果条件值类型为编码值,则此为编码值的文本描述。 | Fish |
标注 | 说明 | 数据类型 |
目标表
| 将向其中导入字段组和条件值的输入地理数据库表或要素类。 | Table View |
字段组输入文件 (.csv) | 带有包含字段组相关信息的指定列名称的 .csv 文件。 | File |
条件值输入文件 (.csv) | 带有包含条件值相关信息的指定列名称的 .csv 文件。 | File |
替换现有条件值
(可选) | 指定导入时将替换还是合并现有值。
| Boolean |
标注 | 说明 | 数据类型 |
已更新的表 | 包含所导入的字段组和条件值的已更新目标表。 | 表视图;栅格图层;镶嵌图层 |
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 | 包含所导入的字段组和条件值的已更新目标表。 | 表视图;栅格图层;镶嵌图层 |
在 GasPipes 数据集中导入字段组和条件值,并替换现有值。
import arcpy
arcpy.ImportContingentValues_management("C:\\MyProject\\myConn.sde\\pro.USER1.Animals",
"C:\\MyProject\\MyFieldGroups.csv",
"C:\\MyProject\\MyContingentValues.csv",
"REPLACE")