Экспорт подсети (Инструменты инженерной сети)

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

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

Примечание:

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

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

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

Перед экспортом подсети необходимо очистить; запустите сначала инструмент Обновить подсеть.
Параметры в категории Trace Parameters можно использовать только в Python.
При работе с многопользовательской базой геоданных должны быть выполнены следующие требования:
- Входная инженерная сеть должна быть из сервиса инженерной сети.
- Лицензия:
  
  Для использования этого инструмента в многопользовательском развертывании, активной учетной записи портала должна быть назначена лицензия с расширением типа пользователя ArcGIS Advanced Editing.
Когда параметр Задать экспорт подтвержденным включен, должно соблюдаться следующее:
- Топология сети должна быть включена.
- Многопользовательские базы геоданных имеют следующие дополнительные требования:
  - Этот инструмент должен быть подключен к версии по умолчанию для запуска.
    - Все другие сеансы, подключенные к версии по умолчанию, блокируются от выполнения операций проверки или включения во время операции включения.
  - Учетная запись подключенного портала ArcGIS Enterprise должна быть записью владельца инженерной сети портала.

Подпись	Объяснение	Тип данных
Входная инженерная сеть	Инженерная сеть, содержащая экспортируемую подсеть.	Utility Network; Utility Network Layer
Специализированная сеть	Специализированная сеть, которая содержит данную подсеть.	String
Уровень	Уровень, содержащий подсеть.	String
Имя подсети	Имя подсети, которая будет экспортирована из уровня. Выберите конкретный источник для экспорта соответствующей информации о подсети. Если таблица подсети содержит 10000 или более записей для уровня, список выбора параметра не заполняется и для имени подсети предоставляется пустое поле.	String
Настроить экспорт подтверждений	Определяет, будет ли обновлен атрибут `LASTACKEXPORTSUBNETWORK` для соответствующего контроллера в таблице Подсети и объект в классе SubnetLine. Отмечено–Атрибут `LASTACKEXPORTSUBNETWORK` будет обновляться для соответствующего контроллера в таблице Подсети. Если источник был отмечен для удаления (Is deleted = True), он будет удален из таблицы Подсети. Этот параметр требует, чтобы входная инженерная сеть ссылалась на версию по умолчанию. Не отмечено–Атрибут `LASTACKEXPORTSUBNETWORK` не будет обновляться для соответствующего контроллера в таблице Подсети. Используется по умолчанию.	Boolean
Выходной JSON	Название и местоположение, для создания файла `.json`.	File
Барьеры условий (Дополнительный)	Задает условия проходимости барьеров в объекте на основании сравнения с сетевым атрибутом или проверки строки категории. В качестве барьера условия используются атрибут сети или категория сети, оператор и тип, а также значение атрибута. Например, остановите трассировку, если атрибут `Device Status` объекта равен определенному значению `Open`. Если объект удовлетворяет этому условию, трассировка остановится. При использовании более одного атрибута, можно применить параметр Комбинировать используя, чтобы задать условие И или Или. Более подробно об использовании множественных условных выражений Примечание: Этот параметр доступен только для Python. Столбцы таблицы значений: Name–Filter by network attribute name. Operator–Filter by an operator. Is equal to–The attribute is equal to the value. Does not equal–The attribute is not equal to the value. Is greater than–The attribute is greater than the value. Is greater than or equal to–The attribute is greater than or equal to the value. Is less than–The attribute is less than the value. Is less than or equal to–The attribute is less than or equal to the value. Includes the values (bitwise AND equals the value)–A bitwise AND operation in which all bits in the value are present in the attribute (bitwise AND == value). Does not include the values (bitwise AND does not equal the value)–A bitwise AND operation in which not all of the bits in the value are present in the attribute (bitwise AND != value). Includes any (bitwise AND equals True)–A bitwise AND operation in which at least one bit in the value is present in the attribute (bitwise AND == True). Does not include any (bitwise AND equals False)–A bitwise AND operation in which none of the bits in the value are present in the attribute (bitwise AND == False). Type–Filter by a specific type. Specific value–Filter by a specific value or network category. Network attribute–Filter by a network attribute. Value–Filter by a specific value. Combine Using–Use this parameter to combine multiple condition barriers. And–Combine the condition barriers. Or–Use if either condition barrier is met.	Value Table
Барьеры функции (Дополнительный)	Задает барьер проходимости на объектах на основе функции. Барьеры функций можно применять для ограничения того, насколько далеко трассировка может уйти от начальной точки, или установки максимального значения, при котором трассировка остановится. Например, длина каждой пройденной линии добавляется к общему пройденному на данный момент расстоянию. Когда общая пройденная длина достигнет указанного значения, трассировка остановится. Примечание: Этот параметр доступен только для Python. Столбцы таблицы значений: Function–Filter by a function. Minimum–The minimum of the input values will be identified. Maximum–The maximum of the input values will be identified. Average–The average of the input values will be calculated. Count–The number of features will be identified. Add–The sum of the input values will be calculated. Subtract–The difference in the input values will be calculated. Subnetwork controllers and loops trace types do not support the subtract function. Attribute–Filter by a network attribute. Operator–Filter by an operator. Is equal to–The attribute is equal to the value. Does not equal–The attribute is not equal to the value. Is greater than–The attribute is greater than the value. Is greater than or equal to–The attribute is greater than or equal to the value. Is less than–The attribute is less than the value. Is less than or equal to–The attribute is less than or equal to the value. Includes the values (bitwise AND equals the value)–A bitwise AND operation in which all bits in the value are present in the attribute (bitwise AND == value). Does not include the values (bitwise AND does not equal the value)–A bitwise AND operation in which not all of the bits in the value are present in the attribute (bitwise AND != value). Includes any (bitwise AND equals True)–A bitwise AND operation in which at least one bit in the value is present in the attribute (bitwise AND == True). Does not include any (bitwise AND equals False)–A bitwise AND operation in which none of the bits in the value are present in the attribute (bitwise AND == False). Value–Filter by a specific value. Use Local Values–Boolean value to use local variables instead of a global variable.	Value Table
Включить объекты барьеров (Дополнительный)	Определяет, будут ли объекты-барьеры проходимости включены в результаты трассировки. Включение барьеров проходимости являются дополнительной опцией, даже если они представлены в определении подсети. Отмечено–Барьеры проходимости будут включаться в результаты трассировки. Используется по умолчанию. Не отмечено–Барьеры проходимости не включаются в результаты трассировки.	Boolean
Применить проходимость к (Дополнительный)	Задает тип проходимости, который будет применен. Область проходимости определяет, будут ли применены настройки проходимости для соединений, ребер или для обоих. Например, если барьер условий задан для остановки трассировки в случае, когда `DEVICESTATUS` установлено на `Open` и область проходимости задана только по ребрам, трассировка не остановится, даже при обнаружении открытого устройства, поскольку `DEVICESTATUS` применимо только к соединениям. Другими словами, параметр показывает, что трассировка должна игнорировать ребра, соединения, или и то и другое. Примечание: Этот параметр доступен только для Python. И соединения, и ребра–Проходимость будет применима как к соединениям, так и к ребрам. Используется по умолчанию. Только соединения–Проходимость будет применена только к соединениям. Только ребра–Проходимость будет применена только к ребрам.	String
Распространители (Дополнительный)	Указывает сетевые атрибуты для распространения, а также то, как это распространение будет происходить во время трассировки традиционной специализированной сети. Класс распространяющихся атрибутов определяет ключевое значение для контроллеров подсети, которое будет распределено по остальным объектам подсети. Например, в модели электрической сети вы можете распространить значение фазы. Примечание: Этот параметр доступен только для Python. Столбцы таблицы значений: Attribute–Filter by a network attribute. Substitution Attribute–The field used for substitution. Function–Filter by a function. Operator–Filter by an operator. Value–Filter by a specific value.	Value Table
Включить геометрию (Дополнительный)	Определяет, будет ли геометрия включена в результаты. Отмечено–Геометрия будет включена в результаты. Не отмечено–Геометрия не будет включена в результаты. Используется по умолчанию.	Boolean
Типы результатов (Дополнительный)	Задает типы возвращаемых результатов. Связность–Будут возвращены объекты, которые связаны через совпадение геометрии или связи связности. Возможности–Будет возвращена информация об уровне объектов. Связи содержания и прикрепления к структуре–Будут возвращены объекты, которые связаны через связи содержания или прикрепления к структуре. Связанные записи–Значения из связанных объектов будут возвращены для объектов в подсети для указанного класса отношений и поля. Примечание: Для многопользовательских баз геоданных эта опция требует наличия ArcGIS Enterprise 11.5 или более поздней версии.	String
Итоговые атрибуты сети (Дополнительный)	Атрибуты сети будут включены в результаты.	String
Поля результатов (Дополнительный)	Поля из класса объектов, которые будут возвращены как результаты. Значения полей будут возвращаться в результатах для объектов в подсети. Столбцы таблицы значений: Feature Class–A feature or object class that participates in the utility network. Field Name–The name of a field from the feature or object class that will have its values returned in the results.	Value Table
Включить описания домена (Дополнительный)	Определяет, будут ли описания доменов включены в выходной файл `.json` для передачи сопоставления домена для контроллеров, featureElements, связности и связей. Отмечено–Описания доменов будут включены в результат. Не отмечено–Описания доменов не будут включены в результат. Используется по умолчанию.	Boolean
Поля связанных записей (Дополнительный)	Поля из классов связанных объектов, которые будут возвращены как результаты. Значения полей будут возвращаться в результатах для объектов в подсети. Столбцы таблицы значений: Relationship Class–A relationship class that relates to a feature or object class that participates in the utility network. Field Name–The name of a field from the related object class that will have its values returned in the results.	Value Table
Включить направления стока (Дополнительный)	Задает, будут ли направления потока включаться в выходной файл `.json`. Если они включаются, файл будет содержать информацию о направлении потока, полученную от контроллеров подсети для пройденных линий, объектов ребер, внутренних ребер устройств с терминалами и соединений связности. Этот параметр применяется только к опциям типов результатов Связность и Объекты. Примечание: Для многопользовательских баз геоданных этот параметр требует наличия ArcGIS Enterprise 12.1 или более поздней версии. Отмечено–Направления стока будут включены в результаты. Не отмечено–Направления стока не будут включены в результаты. Используется по умолчанию.	Boolean
Включить распространяемые значения (Дополнительный)	Определяет, будут ли распространяемые значения включены в выходной файл `.json` для экспортируемой подсети. Этот параметр применим только для типа результатов Объекты. Примечание: Для многопользовательских баз геоданных этот параметр требует наличия ArcGIS Enterprise 12.1 или более поздней версии. Отмечено–Распространяемые значения будут включены в результаты. Не отмечено–Распространяемые значения не будут включены в результаты. Используется по умолчанию.	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}, {related_record_fields}, {include_flow_directions}, {include_propagated_values})

Имя	Объяснение	Тип данных
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`. Если объект удовлетворяет этому условию, трассировка остановится. При использовании более одного атрибута, можно применить параметр Комбинировать используя, чтобы задать условие И или Или. Более подробно об использовании множественных условных выражений Примечание: Этот параметр доступен только для Python. Столбцы таблицы значений: `Name`–Filter by network attribute name. `Operator`–Filter by an operator. `IS_EQUAL_TO`–The attribute is equal to the value. `DOES_NOT_EQUAL`–The attribute is not equal to the value. `IS_GREATER_THAN`–The attribute is greater than the value. `IS_GREATER_THAN_OR_EQUAL_TO`–The attribute is greater than or equal to the value. `IS_LESS_THAN`–The attribute is less than the value. `IS_LESS_THAN_OR_EQUAL_TO`–The attribute is less than or equal to the value. `INCLUDES_THE_VALUES`–A bitwise AND operation in which all bits in the value are present in the attribute (bitwise AND == value). `DOES_NOT_INCLUDE_THE_VALUES`–A bitwise AND operation in which not all of the bits in the value are present in the attribute (bitwise AND != value). `INCLUDES_ANY`–A bitwise AND operation in which at least one bit in the value is present in the attribute (bitwise AND == True). `DOES_NOT_INCLUDE_ANY`–A bitwise AND operation in which none of the bits in the value are present in the attribute (bitwise AND == False). `Type`–Filter by a specific type. `SPECIFIC_VALUE`–Filter by a specific value or network category. `NETWORK_ATTRIBUTE`–Filter by a network attribute. `Value`–Filter by a specific value. `Combine Using`–Use this parameter to combine multiple condition barriers. `AND`–Combine the condition barriers. `OR`–Use if either condition barrier is met.	Value Table
function_barriers [[Function, Attribute, Operator, Value, Use Local Values],...] (Дополнительный)	Задает барьер проходимости на объектах на основе функции. Барьеры функций можно применять для ограничения того, насколько далеко трассировка может уйти от начальной точки, или установки максимального значения, при котором трассировка остановится. Например, длина каждой пройденной линии добавляется к общему пройденному на данный момент расстоянию. Когда общая пройденная длина достигнет указанного значения, трассировка остановится. Примечание: Этот параметр доступен только для Python. Столбцы таблицы значений: `Function`–Filter by a function. `MIN`–The minimum of the input values will be identified. `MAX`–The maximum of the input values will be identified. `AVERAGE`–The average of the input values will be calculated. `COUNT`–The number of features will be identified. `ADD`–The sum of the input values will be calculated. `SUBTRACT`–The difference in the input values will be calculated. Subnetwork controllers and loops trace types do not support the subtract function. `Attribute`–Filter by a network attribute. `Operator`–Filter by an operator. `IS_EQUAL_TO`–The attribute is equal to the value. `DOES_NOT_EQUAL`–The attribute is not equal to the value. `IS_GREATER_THAN`–The attribute is greater than the value. `IS_GREATER_THAN_OR_EQUAL_TO`–The attribute is greater than or equal to the value. `IS_LESS_THAN`–The attribute is less than the value. `IS_LESS_THAN_OR_EQUAL_TO`–The attribute is less than or equal to the value. `INCLUDES_THE_VALUES`–A bitwise AND operation in which all bits in the value are present in the attribute (bitwise AND == value). `DOES_NOT_INCLUDE_THE_VALUES`–A bitwise AND operation in which not all of the bits in the value are present in the attribute (bitwise AND != value). `INCLUDES_ANY`–A bitwise AND operation in which at least one bit in the value is present in the attribute (bitwise AND == True). `DOES_NOT_INCLUDE_ANY`–A bitwise AND operation in which none of the bits in the value are present in the attribute (bitwise AND == False). `Value`–Filter by a specific value. `Use Local Values`–Boolean value to use local variables instead of a global variable.	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],...] (Дополнительный)	Указывает сетевые атрибуты для распространения, а также то, как это распространение будет происходить во время трассировки традиционной специализированной сети. Класс распространяющихся атрибутов определяет ключевое значение для контроллеров подсети, которое будет распределено по остальным объектам подсети. Например, в модели электрической сети вы можете распространить значение фазы. Примечание: Этот параметр доступен только для Python. Столбцы таблицы значений: `Attribute`–Filter by a network attribute. `Substitution Attribute`–The field used for substitution. `Function`–Filter by a function. `Operator`–Filter by an operator. `Value`–Filter by a specific value.	Value Table
include_geometry (Дополнительный)	Определяет, будет ли геометрия включена в результаты. `INCLUDE_GEOMETRY`–Геометрия будет включена в результаты. `EXCLUDE_GEOMETRY`–Геометрия не будет включена в результаты. Используется по умолчанию.	Boolean
result_types [result_types,...] (Дополнительный)	Задает типы возвращаемых результатов. `CONNECTIVITY`–Будут возвращены объекты, которые связаны через совпадение геометрии или связи связности. `FEATURES`–Будет возвращена информация об уровне объектов. `CONTAINMENT_AND_ATTACHMENT_ASSOCIATIONS`–Будут возвращены объекты, которые связаны через связи содержания или прикрепления к структуре. `RELATED_RECORDS`–Значения из связанных объектов будут возвращены для объектов в подсети для указанного класса отношений и поля. Примечание: Для многопользовательских баз геоданных эта опция требует наличия ArcGIS Enterprise 11.5 или более поздней версии.	String
result_network_attributes [result_network_attributes,...] (Дополнительный)	Атрибуты сети будут включены в результаты.	String
result_fields [[Feature Class, Field Name],...] (Дополнительный)	Поля из класса объектов, которые будут возвращены как результаты. Значения полей будут возвращаться в результатах для объектов в подсети. Столбцы таблицы значений: `Feature Class`–A feature or object class that participates in the utility network. `Field Name`–The name of a field from the feature or object class that will have its values returned in the results.	Value Table
include_domain_descriptions (Дополнительный)	Определяет, будут ли описания доменов включены в выходной файл `.json` для передачи сопоставления домена для контроллеров, featureElements, связности и связей. `INCLUDE_DOMAIN_DESCRIPTIONS`–Описания доменов будут включены в результат. `EXCLUDE_DOMAIN_DESCRIPTIONS`–Описания доменов не будут включены в результат. Используется по умолчанию.	Boolean
related_record_fields [[Feature Class, Field Name],...] (Дополнительный)	Поля из классов связанных объектов, которые будут возвращены как результаты. Значения полей будут возвращаться в результатах для объектов в подсети. Столбцы таблицы значений: `Relationship Class`–A relationship class that relates to a feature or object class that participates in the utility network. `Field Name`–The name of a field from the related object class that will have its values returned in the results.	Value Table
include_flow_directions (Дополнительный)	Задает, будут ли направления потока включаться в выходной файл `.json`. Если они включаются, файл будет содержать информацию о направлении потока, полученную от контроллеров подсети для пройденных линий, объектов ребер, внутренних ребер устройств с терминалами и соединений связности. Этот параметр применяется только к опциям типов результатов `CONNECTIVITY` и `FEATURES`. Примечание: Для многопользовательских баз геоданных этот параметр требует наличия ArcGIS Enterprise 12.1 или более поздней версии. `INCLUDE_FLOW_DIRECTIONS`–Направления стока будут включены в результаты. `EXCLUDE_FLOW_DIRECTIONS`–Направления стока не будут включены в результаты. Используется по умолчанию.	Boolean
include_propagated_values (Дополнительный)	Определяет, будут ли распространяемые значения включены в выходной файл `.json` при выполнении трассировки на основе подсети. Этот параметр применим только для типа результатов `FEATURES`. Примечание: Для многопользовательских баз геоданных этот параметр требует наличия ArcGIS Enterprise 12.1 или более поздней версии. `INCLUDE_PROPAGATED_VALUES`–Распространяемые значения будут включены в результаты. `EXCLUDE_PROPAGATED_VALUES`–Распространяемые значения не будут включены в результаты. Используется по умолчанию.	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, "INCLUDE_GEOMETRY", "FEATURES", None, None,
                          "INCLUDE_DOMAIN_DESCRIPTIONS", "INCLUDE_FLOW_DIRECTIONS")

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

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

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

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

Экспорт подсети (Инструменты инженерной сети)

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

Примечание:

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

Лицензия:

Параметры

Примечание:

Примечание:

Примечание:

Примечание:

Примечание:

Примечание:

Примечание:

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

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

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

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