| Имя | Описание | Тип данных |
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 задано 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 – выбрать среди различных операторов.
- Type — укажите Specific value или Network attribute для типа значения параметра Name, который будет служить барьером. Параметр Type должен быть задан как Specific value, когда параметр Name равен Category.
- 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_INCLUDE_ANY—Побитовая операция AND, где ни один из битов в значении не присутствует в атрибуте (побитовый AND == False).
| Value Table |