Добавить зависящее значение (Управление данными)

Краткая информация

Добавляет зависящее значение к группе полей класса объектов или таблицы.

Более подробно о сопряженных значениях

Использование

  • Набор данных должен содержать одну или несколько групп полей, созданных перед добавлением зависящего значения. Для создания группы полей используйте инструмент Создать группу полей.

  • Если входной класс объектов или таблица содержат подтипы, и вы хотите добавить зависящее значение в несколько подтипов, инструмент необходимо запустить несколько раз для каждого подтипа. Возможности работы с нескольким подтипами одновременно нет.

  • Если данные хранятся в многопользовательской базе геоданных, для использования инструмента необходимо подключиться к ней как владелец данных.

  • Зависящие значения совместимы с ArcGIS Pro 2.3 и более новыми базами геоданных. Если используется база геоданных более ранней версии, необходимо обновить ее для работы с зависящими значениями.

  • После добавления к набору данных группы полей, его версия становится ArcGIS Pro 2.3. Это означает, что набор данных больше не может использоваться в ArcMap.

Параметры

ПодписьОписаниеТип данных
Целевая таблица

Входной класс объектов или таблица базы геоданных, куда будет добавляться зависящее значение.

Table View
Имя группы полей

Группа полей, в которую будет добавлено зависящее значение.

String
Значения

Имя поля, тип значения поля и значения связанных полей, использующиеся для нового зависящего значения.

  • Имя поля - имя поля, которое участвует в группе
  • Тип значения поля - тип зависящего значения. Типы Any и Null будут игнорировать любое значение, заданное в поле Значение поля.
    • Any - значение может быть любым.
    • Null - значение null.
    • Кодированное значение - значение берется из домена кодированных значений.
    • Диапазон - значение является поднабором мин/макс домена диапазона.
  • Значение поля – заданное значение поля. Если Типом значения поля является Кодированное значение, укажите описание кода. Если Типом значения поля является Диапазон, укажите минимальное и максимальное значения в формате min;max (например, 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 - тип зависящего значения. Типы ANY и NULL будут игнорировать любое значение, заданное параметром Field Value.
    • ANY - значение может быть любым.
    • NULL - значение равно null.
    • CODED_VALUE - значение берется из домена кодированных значений.
    • RANGE - значение является поднабором мин/макс домена диапазона.
  • Значение поля – заданное значение поля. Если Field Value Type равно CODED_VALUE, укажите описание кода. Если Field Value Type равно RANGE, укажите минимальное и максимальное значения в формате min;max (например, 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: Да

Связанные разделы