Визуализация топологии

Компоненты Граф и Карта позволяют визуализировать топологию устройства, например, связи между устройствами.

Визуализация топологии настраивается определенными свойствами:

Выбирает тип поставщика топологических данных. Список доступных типов может разниться в различных инсталляциях SberMobile. Например, доступные типы включают:

• Пользовательский (визуализирует любые связи между устройствами, которые определены нестандартным образом)

• Сеть (топология сети всех типов, например, Уровень 2 и Уровень 3)

• Уровень 2 (OSI модель, слой топологии 2)

• Уровень 3 (OSI модель, слой топологии 3)

Для компонента Карта Поставщик может быть выставлен в пустую строку, чтобы отключить визуализацию топологии.

Имя свойства: provider

Тип свойства: String

Определяет, является ли контекстом входной и выходной режимы. Если этот флажок активен, различные выражения, которые оценивают свойства узла, могут посылать этот контекст как контекст по умолчанию. Если данный флажок неактивен, Входное выражение и Выходное выражение возвращают имена узлов вместо их путей контекста.

Имя свойства: contextMode

Тип свойства: Boolean

Определяет показанные узлы, которые не имеют ссылок.

Имя свойства: displayUnlinkedNodes

Тип свойства: Boolean

Используется только Пользовательским поставщиком топологии. Это выражение должно иметь результатом таблицу данных. Эта таблица данных становится таблицей данных по умолчанию для Выражения узлов и Выражения связей.

Имя свойства: topologyExpression

Тип свойства: String

Выражение связей

Используется только Пользовательским поставщиком топологии. Это выражение должно иметь результатом таблицу данных. Каждая запись в этой таблице будет определять одну связь топологии, то есть она должна каким-либо образом соотносить источник связи с целью, которая будет получена через Выражение идентификатора связей, Выражение источника и Выражение назначения. Запись может также определять и другие свойства связи, например, цвет, ширину, описание и пр. Эти свойства будут получены с помощью Выражения цвета, Выражения ширины и пр.

Имя свойства: linkExpression

Тип свойства: String

Используется только Пользовательским поставщиком топологии. Это выражение вычисляется для каждой записи таблицы, возвращенной Выражением связей. Результатом выражения должна быть строка, интерпретируемая как идентификатор связи.

Имя свойства: linkIdExpression

Тип свойства: String

Используется только Пользовательским поставщиком топологии. Это выражение оценивается для каждой записи таблицы, возвращенной Выражением топологии. Выражение должно иметь результатом Строку, интерпретируемую как путь контекста источника топологической связи (например, контекст устройства).

Имя свойства: sourceExpression

Тип свойства: String

Используется только Пользовательским поставщиком топологии. Это выражение оценивается для каждой записи таблицы, возвращенной Выражением топологии. Выражение должно иметь результатом Строку, интерпретируемую как путь контекста источника топологической связи (например, контекст устройства).

Имя свойства: targetExpression

Тип свойства: String

Используется только Пользовательским поставщиком топологии. Результат выражения должен быть Таблицей данных. Каждая запись этой таблицы будет опрелеять один узел топологии, поэтому она должна содержать информацию для Выражения идентификаторов связей.  Запись может также определять другие свойства узла, например, цвет, ширину, описание и пр.

Имя свойства: nodeExpression

Тип свойства: String

Используется только Пользовательским поставщиком топологии. Это выражение вычисляется для каждой записи таблицы, возвращенной Выражением узлов. Выражение должно иметь результатом Строку, интерпретируемую как идентификатор узла.

Property name: nodeIdExpression

Property type: String

Это опциональное выражение оценивается для каждого Контекста, являющегося источником или целью топологической связи. Оно должно иметь результатом Строку, которая определяет пользовательское описание топологического узла.

Имя свойства: nodeDescriptionExpression

Тип свойства: String

Это опциональное выражение оценивается для каждого Контекста, являющегося источником или целью топологической связи. Оно должно иметь результатом Цвет, используемый для отрисовки топологического узла.

Имя свойства: colorExpression

Тип свойства: String

Это выражение оценивается для каждого Контекста, являющегося источником или целью топологической связи. Оно должно иметь результатом Строку, которая будет приравнена к имени файла пиктограммы топологического узла.

Пиктограммы топологического узла находятся в подпапке /images/shapes установочной папки SberMobile. Имя файла пиктограммы должно соответствовать Строке, возвращенной Выражением типа. Расширение файла пиктограммы должно быть .svg, т.e. все пиктограммы - это векторные SVG изображения.

Каждое SVG изображение, используемое как пиктограмма топологического узла, должно включать единственный элемент (тег) внутри его тегов <svg></svg>. Этот тег может быть, например, <path>, <circle> или любым другим разрешенным SVG элементом. Вложенные элементы не разрешаются.

Имя свойства: typeExpression

Тип свойства: String

Это опциональное выражение оценивается для каждого Контекста, являющегося источником или целью топологической связи. Оно должно иметь результатом целое число, которое определяет интерфейс узла источника/цели, к которому принадлежит текущая связь.

Имя свойства: interfaceExpression

Тип свойства: String

Это опциональное выражение оценивается для каждой топологической связи. Оно должно иметь результатом логическое значение, определяющее, направлена или не направлена связь (например, направляется из своего Источника к Цели). По умолчанию все связи не направлены.

Это свойство недоступно для компоновки типа Дерево, Радиальная и Пузырьковая. Эти компоновки не рекомендуются для визуализации топологий, т.к. изначальная информация направления связи перекрывается алгоритмом компоновки.

Имя свойства: directedExpression

Тип свойства: String

Это опциональное выражение оценивается для каждой топологической связи. Оно должно иметь результатом число с плавающей точкой, определяющее ширину топологической связи. Ширина связи по умолчанию - 1 пиксель.

Имя свойства: widthExpression

Тип свойства: String

Это опциональное выражение оценивается для каждой топологической связи. Оно должно иметь результатом строку, определяющую пользовательское описание топологической связи.

Имя свойства: linkDescriptionExpression

Тип свойства: String

Если этот флажок активирован, будет отображаться описание связи.

Имя свойства: linkDescriptionShowMode

Тип свойства: Boolean

Это опциональное выражение оценивается для каждой топологической связи. Оно должно иметь результатом Цвет, используемый для отрисовки топологической связи.

Имя свойства: linkColorExpression

Тип свойства: String

Выражение, которое вернет изображения объектов слоя.

Имя свойства: imageExpression

Тип свойства: String

Выражение по умолчанию (select({users.admin.models.deviceImages:deviceImages}, 'image', 'name', {.:genericProperties$type})) берет изображения из Изображения устройства

Отключает возможность удаления или сохранения расположений.

Конфигурация динамических меток, обозначающих текущее состояние устройства.

Свойства метки:

Имя свойства: labels

Тип свойства: Data Table

Этот пример объясняет, как использовать поставщика топологии Custom для визуализации отношения "устройство-родитель дочернему устройству", определенное моделью Подключаемость устройств, включенной в продукт SberMobile Network Manager.

Модель Подключаемость устройств прикрепляет табличное свойство Родители к каждому устройству Хост сети (можно легко прикрепить ко всем устройствам). Таблица Родители имеет поле Путь, представляющее путь контекста устройства-родителя. Таблица содержит список устройств, влияющих на подключаемость к сети текущего устройства.

Чтобы визуализировать все связи "дочернее устройство устройству-родителю" на топологическом графике или карте, необходима следующая настройка Пользовательского поставщика топологии:

• Выражение топологии: callFunction("", "executeQuery", "SELECT parents.parents$path as parent, children.info$remotePath as child FROM users.*.devices.*:parents as parents LEFT OUTER JOIN users.*.devices.*:info as children ON children$CONTEXT_ID = parents$CONTEXT_ID"). Это выражение выполняет запрос, возвращающий список всех связей "устройство-родителю", определяемых в SberMobile Server и доступных текущему пользователю. Таблица результатов запроса имеет поля parent и child, содержащие пути контекстов конечной точки связи.

• Выражение источника: {parent}. Это выражение извлекает путь контекста источника связи из каждой строки вышеобозначенных результатов запроса.

• Выражение цели: {child}. Это выражение извлекает путь контекста цели связи из каждой строки вышеобозначенных результатов запроса.

• Все другие выражения могут сохранять настройки по умолчанию, поскольку извлекают данные из источника связи и контекстов цели.