添加条件值 (数据管理)

摘要

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

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

使用情况

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

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

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

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

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

参数

标注说明数据类型
目标表

要添加条件值的输入地理数据库要素类或表。

Table View
字段组名称

要添加条件值的字段组。

String

将用于新条件值的字段名、字段值类型和相关字段值。

  • 字段名 - 参与字段组的字段名称
  • 字段值类型 - 条件值的类型。 “Any”和“Null”类型将忽略字段值字段中指定的任何值。
    • Any - 该值可以为任意字段值。
    • Null - 该值为空。
    • 编码值 - 该值来自于编码值属性域。
    • 范围 - 该值为范围属性域的最小/最大子集。
  • 字段值 - 特定字段值。 如果字段值类型编码值,请指定编码描述。 如果字段值类型范围,则请以“最小值;最大值”(例如 10;100)的格式指定最小值和最大值。

Value Table
子类型
(可选)

要添加条件值的输入表子类型。

String
停用值
(可选)

指定是否停用条件值。 如果不再创建条件值,但其仍可在现有字段中使用,则将此条件值视为停用状态。 停用一个条件值后,它仍然会显示在字段的有限值列表中(例如,在属性窗格中),但处于非活动状态,此时您将无法将其选为字段值。 例如,将石棉用作建筑材料时。 新的构造无法使用石棉作为建筑材料,但是现有结构可能仍然具有此属性。

  • 选中 - 将停用条件值。
  • 未选中 - 不会停用条件值。 这是默认设置。

Boolean

派生输出

标注说明数据类型
输出要素类

添加了条件值的已更新输入。

Table View; Raster Layer; Mosaic Layer

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 - 条件值的类型。 ANYNULL 类型将忽略 Field Value 参数中指定的任何值。
    • ANY - 该值可以为任意字段值。
    • NULL - 该值为空。
    • CODED_VALUE - 该值来自于编码值属性域。
    • RANGE - 该值为范围属性域的最小/最大子集。
  • 字段值 - 特定字段值。 如果 Field Value TypeCODED_VALUE,请指定编码描述。 如果 Field Value TypeRANGE,则请以“最小值;最大值”的格式指定最小值和最大值(例如 10;100)。

Value Table
subtype
(可选)

要添加条件值的输入表子类型。

String
retire_value
(可选)

指定是否停用条件值。 如果不再创建条件值,但其仍可在现有字段中使用,则此条件值视为停用。 停用一个条件值后,它仍然会显示在字段的有限值列表中(例如,在属性窗格中),但处于禁用状态,此时您将无法将其选为字段值。 例如,将石棉用作建筑材料时。 新的构造无法使用石棉作为建筑材料,但是现有结构可能仍然具有此属性。

  • RETIRE将停用条件值。
  • DO_NOT_RETIRE不会停用条件值。 这是默认设置。
Boolean

派生输出

名称说明数据类型
out_table

添加了条件值的已更新输入。

Table View; Raster Layer; Mosaic Layer

代码示例

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: 是

相关主题