添加条件值 (数据管理)

描述

向要素类或表中的字段组添加条件值。

了解有关条件值的详细信息

使用方法

• 数据集必须创建一个或多个字段组，然后才能添加条件值。可以使用创建字段组工具创建字段组。

• 如果输入要素类或表具有子类型，并且您希望向多个子类型添加条件值，则需要对每个子类型各执行一次此工具。没有一次添加到所有子类型的选项。

• 如果您的数据存储在企业级地理数据库中，则必须以数据所有者身份连接才能使用此工具。

• 条件值与 ArcGIS Pro 2.3 及更高版本的地理数据库相兼容。如果您的地理数据库为较早版本，则您需要升级地理数据库才能使用条件值。

• 将字段组添加到数据集之后，数据集版本将设置为 ArcGIS Pro 2.3。这意味着该数据集将不再可用于 ArcMap。

语法

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 - 该值为空。 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: 是
• Standard: 是
• Advanced: 是