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

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

Экспортирует подсети из инженерной сети в файл .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: Да

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