Экспорт подсети (Инженерная сеть)

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

Экспортирует подсети из инженерной сети в файл .json. Инструмент также позволяет удалить строку в таблице Подсети, если для атрибута Is deleted установлено значение true. Это означает, что контроллер подсети удален из подсети.

Примечание:

Начиная с версии ArcGIS Enterprise 10.9.1, при работе с инженерными сетями в корпоративных базах геоданных операция экспорта подсети выполняется асинхронно с помощью сервиса геообработки UtilityNetworkTools. Сервис UtilityNetworkTools уже предварительно настроен в папке System для сервисов объектов, которые включают инженерную сеть. Для него настроен более длительный показатель тайм-аута, и он зарезервирован под задачи геообработки инженерной сети.

Подробнее об экспорте подсетей

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

  • Перед экспортом подсети необходимо очистить; запустите сначала инструмент Обновить подсеть.

  • Параметры в категории Trace Parameters можно использовать только в Python.

  • При работе с многопользовательской базой геоданных должно быть выполнено следующее требование:
    • Входная инженерная сеть должна быть из сервиса инженерной сети.
    • Лицензия:
      Для использования этого инструмента в многопользовательском развертывании активной учетной записи портала должна быть назначена лицензия с расширением типа пользователя ArcGIS Advanced Editing.
  • Когда параметр Задать экспорт подтвержденным включен, должно соблюдаться следующее:

    • Топология сети должна быть включена.

    • Многопользовательские базы геоданных имеют следующие дополнительные требования:
      • Этот инструмент должен быть подключен к версии по умолчанию для запуска.
        • Все другие сеансы, подключенные к версии по умолчанию, блокируются от выполнения операций проверки или включения во время операции включения.
      • Учетная запись подключенного портала ArcGIS Enterprise должна быть записью владельца инженерной сети на портале.

  • В ArcGIS Pro 2.3 добавлены следующие параметры: Включить геометрию, Типы результатов, Итоговые атрибуты сети и Поля результатов. При использовании этих параметров, формат выходного файла JSON может отличаться. При работе с многопользовательской базой геоданных эти параметры требуют ArcGIS Enterprise версии 10.7 или выше. Просмотр выходного синтаксиса ответа JSON.

Параметры

ПодписьОписаниеТип данных
Входная инженерная сеть

Инженерная сеть, которая содержит экспортируемую подсеть.

Utility Network; Utility Network Layer
Специализированная сеть

Специализированная сеть, которая содержит данную подсеть.

String
Уровень

Уровень, содержащий подсеть.

String
Имя подсети

Имя подсети, которая будет экспортирована из уровня. Выберите конкретный источник для экспорта соответствующей информации о подсети. Если таблица подсети содержит 10 000 или более записей для уровня, список выбора параметра не заполняется и для имени подсети предоставляется пустое поле.

String
Настроить экспорт подтверждений

Определяет, будет ли обновлен атрибут LASTACKEXPORTSUBNETWORK для соответствующего контроллера в таблице Подсети и объект в классе SubnetLine.

  • Отмечено – атрибут LASTACKEXPORTSUBNETWORK будет обновляться для соответствующего контроллера в таблице Подсети. Если источник был отмечен для удаления (Is deleted = True), он будет удален из таблицы Подсети. Этот параметр требует, чтобы входная инженерная сеть ссылалась на версию по умолчанию.
  • Не отмечено – атрибут LASTACKEXPORTSUBNETWORK не будет обновляться для соответствующего контроллера в таблице Подсети. Это значение по умолчанию

Boolean
Выходной JSON

Название и местоположение, для создания файла .json.

File
Барьеры условий
(Дополнительный)
Примечание:

Этот параметр доступен только для Python.

Value Table
Барьеры функции
(Дополнительный)
Примечание:

Этот параметр доступен только для Python.

Value Table
Включить объекты-барьеры
(Дополнительный)
Примечание:

Этот параметр доступен только для Python.

Boolean
Применить проходимость к
(Дополнительный)

Задает тип проходимости, который будет применен. Область проходимости определяет, будут ли применены настройки проходимости для соединений, ребер или для обоих. Например, если барьер условия задан для остановки трассировки в случае, когда DEVICESTATUS равно Open, и для области проходимости задано только по ребрам, трассировка не остановится, даже при обнаружении открытого устройства, поскольку DEVICESTATUS применимо только к соединениям. Другими словами, этот параметр указывает трассировке, следует ли игнорировать ребра, соединения, или и то и другое.

  • И соединения, и ребра—Проходимость будет применима как к соединениям, так и к ребрам.
  • Только соединения—Проходимость будет применена только к соединениям.
  • Только ребра—Проходимость будет применена только к ребрам.
Примечание:

Этот параметр доступен только для Python.

String
Распространители
(Дополнительный)
Примечание:

Этот параметр доступен только для Python.

Value Table
Включить геометрию
(Дополнительный)

Определяет, будет ли геометрия включена в результаты.

  • Отмечено - геометрия будет включена в результаты.
  • Не отмечено - геометрия не будет включена в результаты. Это значение по умолчанию

Примечание:

Для многопользовательских баз геоданных этот параметр требует наличия ArcGIS Enterprise 10.7 или более поздней версии.

Boolean
Типы результатов
(Дополнительный)

Задает типы возвращаемых результатов.

  • Связность—Будут возвращены объекты, которые связаны через совпадение геометрии или связи связности. Это значение по умолчанию
  • Объекты—Будет возвращена информация об уровне объектов.
  • Связи содержания и прикрепления к структуре—Будут возвращены объекты, которые связаны через связи содержания или прикрепления к структуре.
Примечание:

Для многопользовательских баз геоданных этот параметр требует наличия ArcGIS Enterprise 10.7 или более поздней версии.

Опции связей содержания и прикрепления к структуре требуют ArcGIS Enterprise версии 10.8.1 или выше.

String
Итоговые атрибуты сети
(Дополнительный)

Атрибуты сети будут включены в результаты.

Примечание:

Для многопользовательских баз геоданных этот параметр требует наличия ArcGIS Enterprise 10.7 или более поздней версии.

String
Поля результатов
(Дополнительный)

Поля из класса объектов, которые будут возвращены как результаты. Значение поля будут возвращаться в результатах для объектов в подсети.

Примечание:

Для многопользовательских баз геоданных этот параметр требует наличия ArcGIS Enterprise 10.7 или более поздней версии.

Value Table
Включить описания домена
(Дополнительный)

Определяет, будут ли описания доменов включены в выходной файл .json для передачи сопоставления домена для контроллеров, featureElements, связности и связей.

  • Отмечено – описания доменов будут включены в результат.
  • Не отмечено – описания доменов будут включены в результат. Это значение по умолчанию

Примечание:

Для многопользовательских баз геоданных этот параметр требует наличия ArcGIS Enterprise 10.7 или более поздней версии.

Boolean

Производные выходные данные

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

Обновленная инженерная сеть

Utility Network

arcpy.un.ExportSubnetwork(in_utility_network, domain_network, tier, subnetwork_name, export_acknowledged, out_json_file, {condition_barriers}, {function_barriers}, {include_barriers}, {traversability_scope}, {propagators}, {include_geometry}, {result_types}, {result_network_attributes}, {result_fields}, {include_domain_descriptions})
ИмяОписаниеТип данных
in_utility_network

Инженерная сеть, которая содержит экспортируемую подсеть.

Utility Network; Utility Network Layer
domain_network

Специализированная сеть, которая содержит данную подсеть.

String
tier

Уровень, содержащий подсеть.

String
subnetwork_name

Имя подсети, которая будет экспортирована из уровня. Выберите конкретный источник для экспорта соответствующей информации о подсети.

String
export_acknowledged

Определяет, будет ли обновлен атрибут LASTACKEXPORTSUBNETWORK для соответствующего контроллера в таблице Подсети и объект в классе SubnetLine.

  • ACKNOWLEDGE—Атрибут LASTACKEXPORTSUBNETWORK будет обновляться для соответствующего контроллера в таблице Подсети. Если источник был отмечен для удаления (Is deleted = True), он будет удален из таблицы Подсети. Этот параметр требует, чтобы входная инженерная сеть ссылалась на версию по умолчанию.
  • NO_ACKNOWLEDGE—Атрибут LASTACKEXPORTSUBNETWORK не будет обновляться для соответствующего контроллера в таблице Подсети. Это значение по умолчанию
Boolean
out_json_file

Название и местоположение, для создания файла .json.

File
condition_barriers
[[Name, Operator, Type, Value, Combine Using],...]
(Дополнительный)

Задает условия проходимости барьеров в объекте на основании сравнения с сетевым атрибутом или проверки строки категории. Барьер условия использует атрибут сети, оператор и тип, а также значение атрибута. Например, остановите трассировку, если атрибут Device Status объекта равен определенному значению Open. Если объект удовлетворяет этому условию, трассировка остановится. При использовании более одного атрибута, можно применить параметр Комбинировать использование, чтобы задать условие И или Или.

Компоненты барьеров условий следующие:

  • Name – фильтрация по любому из атрибутов сети, определенному в системе.
  • Operator – выбрать из нескольких различных операторов.
  • name – выбрать определенное значение или сетевой атрибут из значения, которое задано в параметре Type.
  • Value – задайте определенное значение типа входного атрибута, которое может вызвать прекращение трассировки на основании значения оператора.
  • Combine Using– задайте это значение, если собираетесь добавить несколько атрибутов. Их можно комбинировать при помощи условий И или ИЛИ.

Значения operator барьера условий:

  • IS_EQUAL_TO—Атрибут равен значению.
  • DOES_NOT_EQUAL—Атрибут не равен значению.
  • IS_GREATER_THAN—Атрибут больше значения.
  • IS_GREATER_THAN_OR_EQUAL_TO—Атрибут больше или равен значению.
  • IS_LESS_THAN—Атрибут меньше значения.
  • IS_LESS_THAN_OR_EQUAL_TO—Атрибут меньше или равен значению.
  • INCLUDES_THE_VALUES—Побитовая операция AND, где все биты в значении присутствуют в атрибуте (побитовый AND == значение).
  • DOES_NOT_INCLUDE_THE_VALUES—Побитовая операция AND, где не все биты в значении присутствуют в атрибуте (побитовый AND != значение).
  • INCLUDES_ANY—Побитовая операция AND, в которой хотя бы один бит в значении присутствует в атрибуте (побитовый AND == True).
  • DOES_NOT_INCLUDE_ANY—Побитовая операция AND, где ни один из битов в значении не присутствует в атрибуте (побитовый AND == False).

Опции type барьера условий:

  • SPECIFIC_VALUE—Фильтр по заданному значению.
  • NETWORK_ATTRIBUTE—Фильтр по сетевому атрибуту.

Применяются следующие значения Combine Using:

  • AND—Комбинировать барьеры условий.
  • OR—Использовать, если встречается любой из барьеров условий.

Более подробно об использовании множественных условных выражений

Value Table
function_barriers
[[Function, Attribute, Operator, Value, Use Local Values],...]
(Дополнительный)

Задает барьер проходимости на объектах на основе функции. Барьеры функций можно применять для ограничения того, насколько далеко трассировка может уйти от начальной точки, или установки максимального значения, при котором трассировка остановится. Например, длина каждой пройденной линии добавляется к общему пройденному на данный момент расстоянию. Когда общая пройденная длина достигнет указанного значения, трассировка остановится.

Компоненты барьеров функции следующие:

  • Function – выбрать среди различных функций вычисления.
  • Attribute – фильтрация по любому из атрибутов сети, определенному в системе.
  • Operator – выбрать из нескольких различных операторов.
  • Value – задать значение для типа входного атрибута, которое в случае обнаружения вызовет завершение работы.
  • Use Local Values – вычислить значения в каждом направлении, в противоположность общему глобальному значению. Например, используется как барьер функции, вычисляющей сумму Shape length, где трассировка прерывается, если значение больше или равно 4. В общем случае, после того, как вы прошли два ребра со значениями 2, вы уже достигли суммы длин геометрий, равной 4, поэтому трассировка останавливается. Если используются локальные значения, то локальные значения вдоль каждого пути меняются, поэтому трассировка продолжается.

  • TRUE—Использовать локальные значения.
  • FALSE—Использовать глобальные значения. Это значение по умолчанию

Возможны следующие значения опции function барьера функции:

  • AVERAGE—Среднее арифметическое входных значений.
  • COUNT—Число объектов.
  • MAX—Максимальное из входных значений.
  • MIN—Минимальное из входных значений.
  • ADD—Добавить все значения.
  • SUBTRACT—Вычесть значения. Контроллеры подсети и циклические трассировки не поддерживаются функцией вычитания.

Например, объект начальной точки имеет значение 20. Следующий объект имеет значение 30. Если вы используете функцию минимума, результат равен 20, максимум - 30, добавить - 50, среднее - 25, количество - 2 и разность -10.

Опции значения operator барьеров функций следующие:

  • IS_EQUAL_TO—Атрибут равен значению.
  • DOES_NOT_EQUAL—Атрибут не равен значению.
  • IS_GREATER_THAN—Атрибут больше значения.
  • IS_GREATER_THAN_OR_EQUAL_TO—Атрибут больше или равен значению.
  • IS_LESS_THAN—Атрибут меньше значения.
  • IS_LESS_THAN_OR_EQUAL_TO—Атрибут меньше или равен значению.
  • INCLUDES_THE_VALUES—Побитовая операция AND, где все биты в значении присутствуют в атрибуте (побитовый AND == значение).
  • DOES_NOT_INCLUDE_THE_VALUES—Побитовая операция AND, где не все биты в значении присутствуют в атрибуте (побитовый AND != значение).
  • INCLUDES_ANY—Побитовая операция AND, в которой хотя бы один бит в значении присутствует в атрибуте (побитовый AND == True).
  • DOES_NOT_INCLUDE_ANY—Побитовая операция AND, где ни один из битов в значении не присутствует в атрибуте (побитовый AND == False).
Value Table
include_barriers
(Дополнительный)

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

  • INCLUDE_BARRIERS—Барьеры проходимости будут включаться в результаты трассировки. Это значение по умолчанию
  • EXCLUDE_BARRIERS—Барьеры проходимости не включаются в результаты трассировки.
Boolean
traversability_scope
(Дополнительный)

Задает тип проходимости, который будет применен. Область проходимости определяет, будут ли применены настройки проходимости для соединений, ребер или для обоих. Например, если барьер условия задан для остановки трассировки в случае, когда DEVICESTATUS равно Open, и для области проходимости задано только по ребрам, трассировка не остановится, даже при обнаружении открытого устройства, поскольку DEVICESTATUS применимо только к соединениям. Другими словами, этот параметр указывает трассировке, следует ли игнорировать ребра, соединения, или и то и другое.

  • BOTH_JUNCTIONS_AND_EDGES—Проходимость будет применима как к соединениям, так и к ребрам.
  • JUNCTIONS_ONLY—Проходимость будет применена только к соединениям.
  • EDGES_ONLY—Проходимость будет применена только к ребрам.
String
propagators
[[Attribute, Substitution Attribute, Function, Operator, Value],...]
(Дополнительный)

Указывает сетевые атрибуты для распространения, а также то, как это распространение будет происходить во время трассировки. Класс распространяющихся атрибутов определяет ключевое значение для контроллеров подсети, которое будет распределено по остальным объектам подсети. Например, в модели электрической сети вы можете распространить значение фазы.

Компоненты распространителя:

  • Attribute – фильтрация по любому из атрибутов сети, определенному в системе.
  • Substitution Attribute – использовать заменяющее значение вместо битового множества атрибутов сети. Замены кодируются на основе числа битов в распространенном атрибуте сети. Замена сопоставляет один бит в фазе другим битом. Например, для Фазы AC, одна замена сопоставляет бит A с B, а C с null. В этом примере замена 1010 (Фаза AC) дает 0000-0010-0000-0000 (512). Замена захватывает сопоставление, т.ч. вы знаете, что Фаза A была сопоставлена с B, а Фаза C с null, а не иначе (например, Фаза A не сопоставлялась с null, а Фаза C не сопоставлялась с B).
  • Function – выбрать среди различных функций вычисления.
  • Operator – выбрать среди различных операторов.
  • Value – задать определенное значение для типа входного атрибута, которое может вызвать прерывание на основании значения оператора.

Возможные значения для распространителя function следующие:

  • PROPAGATED_BITWISE_AND—Сравнивать значения одного объекта со значениями следующего.
  • PROPAGATED_MIN—Получить минимальное значение.
  • PROPAGATED_MAX—Получить максимальное значение.

Возможны следующие значения распространителя operator:

  • IS_EQUAL_TO—Атрибут равен значению.
  • DOES_NOT_EQUAL—Атрибут не равен значению.
  • IS_GREATER_THAN—Атрибут больше значения.
  • IS_GREATER_THAN_OR_EQUAL_TO—Атрибут больше или равен значению.
  • IS_LESS_THAN—Атрибут меньше значения.
  • IS_LESS_THAN_OR_EQUAL_TO—Атрибут меньше или равен значению.
  • INCLUDES_THE_VALUES—Побитовая операция AND, где все биты в значении присутствуют в атрибуте (побитовый AND == значение).
  • DOES NOT INCLUDE_THE_VALUES—Побитовая операция AND, где не все биты в значении присутствуют в атрибуте (побитовый AND != значение).
  • INCLUDES_ANY—Побитовая операция AND, в которой хотя бы один бит в значении присутствует в атрибуте (побитовый AND == True).
  • DOES_NOT_INLCUDE_ANY—Побитовая операция AND, где ни один из битов в значении не присутствует в атрибуте (побитовый AND == False).
Value Table
include_geometry
(Дополнительный)

Определяет, будет ли геометрия включена в результаты.

  • INCLUDE_GEOMETRY—Геометрия будет включена в результаты.
  • EXCLUDE_GEOMETRY—Геометрия не будет включена в результаты. Это значение по умолчанию
Примечание:

Для многопользовательских баз геоданных этот параметр требует наличия ArcGIS Enterprise 10.7 или более поздней версии.

Boolean
result_types
[result_types,...]
(Дополнительный)

Задает типы возвращаемых результатов.

  • CONNECTIVITY—Будут возвращены объекты, которые связаны через совпадение геометрии или связи связности. Это значение по умолчанию
  • FEATURES—Будет возвращена информация об уровне объектов.
  • CONTAINMENT_AND_ATTACHMENT_ASSOCIATIONS—Будут возвращены объекты, которые связаны через связи содержания или прикрепления к структуре.
Примечание:

Для многопользовательских баз геоданных этот параметр требует наличия ArcGIS Enterprise 10.7 или более поздней версии.

Опции связей содержания и прикрепления к структуре требуют ArcGIS Enterprise версии 10.8.1 или выше.

String
result_network_attributes
[result_network_attributes,...]
(Дополнительный)

Атрибуты сети будут включены в результаты.

Примечание:

Для многопользовательских баз геоданных этот параметр требует наличия ArcGIS Enterprise 10.7 или более поздней версии.

String
result_fields
[[Feature Class, Field Name],...]
(Дополнительный)

Поля из класса объектов, которые будут возвращены как результаты. Значение поля будут возвращаться в результатах для объектов в подсети.

Примечание:

Для многопользовательских баз геоданных этот параметр требует наличия ArcGIS Enterprise 10.7 или более поздней версии.

Value Table
include_domain_descriptions
(Дополнительный)

Определяет, будут ли описания доменов включены в выходной .json для передачи сопоставления домена для контроллеров, featureElements, связности и связей.

  • INCLUDE_DOMAIN_DESCRIPTIONS—Описания доменов будут включены в результат.
  • EXCLUDE_DOMAIN_DESCRIPTIONS—Описания доменов не будут включены в результат. Это значение по умолчанию
Примечание:

Для многопользовательских баз геоданных этот параметр требует наличия ArcGIS Enterprise 10.7 или более поздней версии.

Boolean

Производные выходные данные

ИмяОписаниеТип данных
out_utility_network

Обновленная инженерная сеть

Utility Network

Пример кода

ExportSubnetwork, пример (окно Python)

Экспорт соответствующей информации подсети для источника с названием RMT002 в файл .json с включенными описаниями доменов.

import arcpy
arcpy.un.ExportSubnetwork("Utility Network", "ElectricDistribution", 
                          "Medium Voltage", "RMT002", "ACKNOWLEDGE", 
                          "C:\\Temp\\RMT002clean.json", None, None, 
                          "INCLUDE_BARRIERS", "BOTH_JUNCTIONS_AND_EDGES", 
                          None, "EXCLUDE_GEOMETRY", None, None, None, 
                          "INCLUDE_DOMAIN_DESCRIPTIONS")

Параметры среды

Этот инструмент не использует параметры среды геообработки

Информация о лицензиях

  • Basic: Нет
  • Standard: Да
  • Advanced: Да

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