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

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

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

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

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

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

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

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

  • Зависящие значения совместимы с 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],...]

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

  • Имя поля - имя поля, которое участвует в группе полей.
  • Тип значения поля - тип зависящего значения. Типы ANY и NULL будут игнорировать любое значение, заданное в поле Значение поля.
    • ANY - значение может быть любым.
    • NULL - значение равно null.
    • CODED_VALUE - значение берется из домена кодированных значений.
    • RANGE - значение является поднабором мин/макс интервального домена.
  • Значение поля - заданное значение поля. Если типом значения поля является CODED_VALUE, укажите код. Если типом значения поля является 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.management.AddContingentValue("C:\\MyProject\\myConn.sde\\mygdb.USER1.myFC", 
                                    "MyFieldGroup", CV, "My Subtype", 
                                    "DO_NOT_RETIRE")

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