| Имя | Описание | Тип данных |
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 |