TingsBoard виджеты (основы)
Виджеты ThingsBoard — это дополнительные модули пользовательского интерфейса, которые легко интегрируются в любую панель инструментов IoT. Они обеспечивают функционал для конечного пользователя, такой как визуализация данных, удаленное управление устройствами, управление аварийными сигналами и отображение статического пользовательского HTML-контента. В соответствии с предоставленными функционалом каждый виджет относится к определенному типу.
Типы виджетов
- Latest values (последнее значение) отображает последние значения определенного атрибута сущности или точки данных временного ряда (например, любой виджет «Датчик» или виджет «Таблица сущностей»). Этот тип виджетов использует значения атрибутов объекта или временных рядов в качестве источника данных. Примером такого виджета является датчик температуры, выводящие текущее (последнее) значение.
- Timeseries (временные ряды) отображает значение, собранные в разные моменты времени, либо последние значения в определенном временном окне. Классический пример такого виджета – различные графики и диаграммы. Но при этом виджет используется только для отрисовки самих временных рядов сущностей. А для временных рамок отображаемых значений используются настройки Timewindow (временное окно) на странице панели инструментов или в деталях виджета.
- RPC (Control widget) (виджет управления) позволяет отправлять команды на устройство, получать и обрабатывать ответ от устройства. Например, переключение какого-то режима и отображения текущего состояния этого режима.
- Alarm widget (виджет тревоги) – отображает тревоги, относящиеся к указанному объекту, в определенном временном окне (например, «Таблица тревог» для отображения последнего сигнала тервоги). Имеет различные настройки для указания типа тревоги (напр. “высокая температура”), статуса (текущего состояния) и серьезности (с какой периодичностью сообщать). Как и виджет Timeseries имеет настройки временного окна (Timewindow).
- Static widget (статический виджет) отображает статический настраиваемый HTML-контент (например, «HTML-карта»). Статические виджеты не используют никаких источников данных и обычно настраиваются путем указания статического содержимого HTML и, при необходимости, стилей CSS.
Пакеты виджетов
Виджеты сгруппированы в пакеты виджетов в соответствии с их назначением. Существуют пакеты виджетов уровня системы и уровня арендатора. Первоначальная установка ThingsBoard поставляется с базовым набором пакетов виджетов системного уровня:
- Alarm widgets (виджеты тревоги) для визуализации сигналов тревоги для конкретных объектов как в режиме реального времени, так и в режиме истории.
- Analog Gauges (аналоговые датчиики) для визуализации температуры, влажности, скорости и других целых чисел или значений с плавающей запятой
- Cards (карточки) для визуализации данных временных рядов или атрибутов в виджетах таблиц или карточек
- Charts (графики) для визуализации исторических данных или данных в реальном времени с временным окном
- Control widgets (виджеты управления) для визуализации текущего состояния и отправки RPC-команд на целевые устройства
- Date widgets (виджеты даты) для изменения диапазона данных для других виджетов на панели инструментов
- Digital Gauges (цифровые датчики) для визуализации температуры, влажности, скорости и других целых или плавающих значений.
- Entity admin widgets (виджеты администратора сущности / объекта) – это шаблоны сложных виджетов, которые позволяют перечислять и создавать/обновлять/удалять устройства и активы.
- Gateway widgets (виджеты шлюза) для управления расширениями.
- GPIO widgets (виджет интерфейса ввода-вывода) для визуализации и управления состоянием GPIO для целевых устройств.
- Input widgets (виджет ввода) для изменения атрибутов объекта.
- Maps widgets (виджеты карт) для визуализации географического положения устройств и отслеживания маршрутов устройств как в режиме реального времени, так и в режиме истории.
- Scheduling widgets (виджеты планирования) для планирования различных типов событий с гибкой настройкой расписания. Доступно только в PE и PaaS (на облачных серверах, наверное).
Добавление пакетов виджетов
Если системный администратор добавляет новый пакет виджетов, он автоматически становится системным, т.е. только сисадмин сможет его редактировать и добавлять типы виджетов.
Если же администратор арендаторов добавляет пакет, то у него будут права на их редактирование.
Экспорт/импорт пакетов и тпиов виджетов
Можно экспортировать пакет виджетов или отдельный тип в формате JSON и затем его импортировать в другую панель ThingsBoard.