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

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

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

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

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

• Сеть (топология сети всех типов, например, Уровень 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

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

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

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

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

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

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

Например, это выражение {info$type} == "group.device" ? "dashboard_admin_SwitchDashboard" : "manage" открывает предоставленную инструментальную панель SwitchDashboard для группы устройств и инструментальную панель по умолчанию для устройства.

Настройка динамических описаний, указывающих на текущее состояние устройства.

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

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

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

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

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

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

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

Пиктограммы топологического узла находятся в подпапке /images/shapes установочной папки AggreGate. Имя файла пиктограммы должно соответствовать Строке, возвращенной Выражением типа. Расширение файла пиктограммы должно быть .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})) берет изображения из Изображения устройства

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

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

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

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

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

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

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

Вы можете щелкнуть правой клавишей мыши по узлу, чтобы открыть меню действий узла. Щелчок по опции в этом меню генерирует событие с заданным именем.

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

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

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

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

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

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

Включение этого свойства может значительно снизить производительность.

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

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

Выражение, возвращающее коэффициент поворота объектов слоя.

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

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

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

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

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

В этом примере объясняется, как использовать Custom поставщика топологии для визуализации отношений «родитель-потомок» устройств, определенных моделью Связность устройства, включенной в продукт AggreGate Network Manager.

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

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

• Выражение топологии: 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"). Это выражение выполняет запрос, который возвращает список всех связей «устройство-родитель», определенных в AggreGate Server и доступных от имени текущего пользователя. Таблица результатов запроса содержит parent и child поля, содержащие пути контекстов конечных точек связей.

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

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

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

В этом примере объясняется, как выражения пользовательской топологии взаимосвязаны и как создавать топологии с помощью этих выражений.

Для простоты в этом примере используются две таблицы данных в качестве источника всех данных о топологии. Если вы хотите применить этот пример к другим сценариям, замените выражения Node Expression и Link Expression на выражения, которые возвращают соответствующие данные в аналогичном формате.

Коренным выражением для пользовательской топологии является выражение «Выражение топологии». Data Table, возвращаемая этим выражением, содержит все данные для топологии. Два других выражения, «Выражение узла» и «Выражение связей», используют эту таблицу в качестве таблицы данных по умолчанию. «Выражение узла» использует ее для извлечения информации об узлах. «Выражение связей» использует ее для извлечения информации о соединениях между узлами. Поскольку гораздо проще использовать две разные таблицы данных для связей и для узлов, можно оставить «Выражение топологии» пустым и указать «Выражение узла» и «Выражение связей» независимо друг от друга. Таблицы данных, возвращаемые «Выражением узла» и «Выражением связей», будут использоваться всеми другими выражениями.

Таблица данных, возвращаемая выражением «Link Expression», является источником информации о связях. Поскольку пользовательская топология является гибкой, вы сами определяете способ хранения данных и их извлечения из этой таблицы данных другими выражениями для связей. Минимальный набор, необходимый для топологии, — это выражения «Выражение идентификаторов связей», «Source Expression» и «Target Expression». Если вы определите эти три свойства, топология будет построена исключительно на основе этих данных. AggreGate получит данные об узлах из выражений «Source Expression» и «Target Expression» и построит связи между этими узлами. Все выражения, использующие Data Table, возвращаемую выражением «Link Expression»: «Link Id Expression», «Source Expression», «Target Expression», «Interface Expression», «Выражение направленности», «Width Expression», «Выражение цвета описания», «Выражение цвета описания».

Таблица данных, возвращаемая выражением Node Expression, является источником информации об узлах. Опять же, вам решать, какой объем данных об узлах вы хотите сохранить и отобразить. Все выражения, использующие таблицу данных, возвращаемую выражением Node Expression: выражение Node Id Expression, выражение Type Expression, выражение Node Description Expression, выражение Color Expression.

В этом примере вы создадите две Data Tables.

В первой таблице будет храниться информация о связях. Это единственная таблица, обязательная для построения топологии.

Таблица linkData имеет следующие поля:

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

Таблица nodeData содержит следующие поля:

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

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

Выражение узла. Это выражение должно приводить к таблице данных, описанной выше. Например, можно выполнить запрос, возвращающий все данные для вашей топологии. В этом примере используется ссылка на переменную, в которой хранится таблица данных узла: {users.admin.models.customTopology:nodeData}. Эта таблица данных становится таблицей данных по умолчанию для всех других выражений, связанных с узлами.

Выражение связей. Это выражение должно привести к Data Table, описанной выше. В этом примере используется ссылка на переменную, в которой хранится Data Table связи: {users.admin.models.customTopology:linkData}. Эта таблица данных становится таблицей данных по умолчанию для всех других выражений, связанных с связями.

Выражение идентификаторов связей. Это выражение должно возвращать идентификатор связи. Каждый идентификатор связи соответствует одной связи между двумя узлами. В этом примере используется поле linkId таблицы данных связи: {linkId}.

Выражение источника. Каждая ссылка должна иметь узел-источник, откуда она берет начало. Это выражение определяет, как определяется этот узел-источник. В этом примере используется поле sourceNode таблицы данных ссылок, в которой хранятся идентификаторы узлов: {sourceNode}.

Выражение целевого узла. Это выражение определяет, как определять целевой узел для связи. В этом примере используется поле targetNode Data Table, в которой хранятся идентификаторы узлов: {targetNode}.

Выражение направленности. Это выражение определяет, должна ли связь отображаться как направленная. В этом примере для этого используется поле isDirected: {isDirected}

Выражение ширины. Это выражение определяет отображаемую ширину ссылки. В этом примере для этого используется поле linkWidth: {linkWidth}.

Выражение цвета связи. Это выражение определяет цвет отображаемой ссылки. В данном примере для этого используется поле linkColor: {linkColor}.

Описание связи. Это выражение определяет метку, отображаемую для ссылки. В данном примере для этого используется поле linkDescription: {linkDescription}.

Выражение идентификаторов узлов. Это выражение должно возвращать идентификатор узла. Каждый идентификатор узла соответствует одному узлу. Идентификаторы узлов должны совпадать с идентификаторами, используемыми в Data Table для связей. В этом примере для этого используется поле nodeName: {nodeName}.

Выражение цвета. Это выражение определяет цвет отображаемого узла. В данном примере для этого используется поле nodeColor: {nodeColor}.

Выражение описания узла. Это свойство представляет собой Data Table, которая определяет размещение меток для узлов. В этом примере в качестве значения поля «Выражение» используется поле nodeDescription: {nodeDescription}. Все остальные поля определяют визуальные свойства метки.

Пример набора данных узлов для пользовательской топологии:

Пример набора данных ссылки для пользовательской топологии:

Was this page helpful?

Tell us more

Send

Thank you!