| Имя | Описание | Тип данных |
in_utility_network | Инженерная сеть, которая содержит подсеть. | Utility Network; Utility Network Layer |
domain_network | Специализированная сеть, которая содержит данную подсеть. | String |
tier | Уровень, содержащий подсеть. | String |
all_subnetworks_in_tier (Дополнительный) | Указывает, обновляются ли все подсети в уровне. Чтобы обновить поднабор подсетей данного уровня, используйте параметр subnetwork_name. - ALL_SUBNETWORKS_IN_TIER—Обновляет все подсети в уровне. Эта опция использует асинхронную обработку для обновления подсетей, использующих системный сервис геообработки UtilityNetworkTools. Этот сервис зарезервирован для задач геообработки инженерной сети и по умолчанию имеет более продолжительный интервал ожидания. Это значение по умолчанию
- SPECIFIC_SUBNETWORK—Обновляет только подсети, которые указаны в параметре subnetwork_name.
| Boolean |
subnetwork_name (Дополнительный) | Имя обновляемой подсети. Если все подсети будут обновлены с использованием параметра all_subnetworks_in_tier, этот параметр игнорируется. | String |
continue_on_failure (Дополнительный) | Указывает, следует ли останавливать процесс обновления, если не удается обновить подсеть при обновлении нескольких подсетей. - CONTINUE_ON_FAILURE—Продолжает обновлять подсети после ошибки.
- STOP_ON_FAILURE—Останавливает обновление подсетей после ошибки. Это значение по умолчанию
| Boolean |
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, где все биты в значении представлены в атрибуте (bitwise AND == value).
- DOES_NOT_INCLUDE_THE_VALUES—Побитовый оператор AND, где не все биты в значении представлены в атрибуте (bitwise AND != value).
- INCLUDES_ANY—Побитовый оператор AND, где как минимум один бит в значении представлен в атрибуте (bitwise AND == True).
- DOES_NOT_INCLUDE_ANY—Побитовый оператор AND, где ни один из битов в значении не представлен в атрибуте (bitwise AND == value).
Опции 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, где все биты в значении представлены в атрибуте (bitwise AND == value).
- DOES_NOT_INCLUDE_THE_VALUES—Побитовый оператор AND, где не все биты в значении представлены в атрибуте (bitwise AND != value).
- INCLUDES_ANY—Побитовый оператор AND, где как минимум один бит в значении представлен в атрибуте (bitwise AND == True).
- DOES_NOT_INCLUDE_ANY—Побитовый оператор AND, где ни один из битов в значении не представлен в атрибуте (bitwise AND == value).
| 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, где все биты в значении представлены в атрибуте (bitwise AND == value).
- DOES_NOT_INCLUDE_THE_VALUES—Побитовый оператор AND, где не все биты в значении представлены в атрибуте (bitwise AND != value).
- INCLUDES_ANY—Побитовый оператор AND, где как минимум один бит в значении представлен в атрибуте (bitwise AND == True).
- DOES_NOT_INCLUDE_ANY—Побитовый оператор AND, где ни один из битов в значении не представлен в атрибуте (bitwise AND == value).
| Value Table |