Release 2.12

Список основных изменений в платформе

Основные изменения

новый раздел «События»;
расширение модели — обработка топлива;
настройка отображения полей конфигурации;
уведомления в телеграм;
MQTT — QoS в интерфейсе моделей и объектов;
использование в источнике модели идентификатора объекта и конфигурационных параметров;
CTRL+S для сохранения;
исправления графиков;
новое меню.

Исправление багов

белый экран в редактировании кода в переходах автомата;
при обновлении страницы выбиралась сущность внизу списка.

Основные изменения

Новый раздел «События»

Добавлен новый раздел «События». Там можно посмотреть основные события, возникающие в проекте, и изучить детальную информацию по ним. Например, это могут быть события:

онлайн/офлайн объекта;
вход и выход объекта в геозону;
изменение объекта (в событии также фиксируется информация, кто и что изменил в объекте);
отправка команд на объекты;
пользовательские события из автомата и т.д.

Расширения модели — Обработка топлива

Добавлен новый механизм расширений моделей, который позволит использовать специальные возможности для моделей. Чтобы добавить расширение при добавлении новой модели необходимо при создании модели выбрать «Fuel» из списка доступных расширений.

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

Первым в список расширений добавлено расширение Fuel (Топливо). Оно позволяет запустить механизм обработки топлива, полученного по данным датчика уровня топлива (ДУТ). Для этого необходимо:

В модели устройства включить расширение Fuel.

В объекте в разделе данные появится соответствующее меню, в котором необходимо настроить баки:

указать количество топливных баков;
выбрать тип обработки, если баков несколько;
выбрать параметр из модели устройства, в который приходят данные ДУТ;
заполнить тарировочную таблицу;
выбрать параметр, в который будет записан обработанный результат.

Если баков несколько, то доступны дополнительные типы обработки, а именно:

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

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

Настройка отображения полей конфигурации

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

Всего доступны четыре настройки отображения:

значение — для строк и чисел;
диапазон (поле ввода) — для чисел;
диапазон (слайдер) — для чисел;
выпадающий список — для строк и чисел.

Значение — никак не ограничивает поле ввода значения параметра. В интерфейсе объекта оно будет обычным инпутом.

Диапазон (поле ввода) — позволяет выбрать максимальное и минимальное значение для параметра конфигурации. В объекте при попытке ввести некорректное значение появится соответствующая ошибка.

Диапазон (слайдер) — так же, как и диапазон (поле ввода), позволяет определить границы допустимых значений, однако настройка параметра в объекте принимает вид слайдера. Кроме того, добавляется возможность выбрать шаг для слайдера.

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

Уведомления в телеграм

В автоматы добавлено новое действие — «Отправить сообщение в Телеграм». Сообщение может быть отправлено как в личные сообщения пользователю, так и в телеграм-группу или в телеграм-канал.

Выбор действия в автомате:

Чтобы добавить возможность отправки сообщений в Телеграм, необходимо создать интеграцию в разделе «Настройки проекта» — «Уведомления».

Создание интеграции:

При создании интеграции предстоит выбрать один из двух типов бота: бот Rightech или личный. Бот Rightech отлично подойдет для первоначального тестирования механизма отправки уведомлений через Телеграм. При добавлении собственного бота необходимо указать его секретный токен. Для создания бота воспользуйтесь инструкцией.

Выбор типа бота:

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

Созданная интеграция:

MQTT — QoS в интерфейсе моделей и объектов

Для команд, отправляемых по протоколу MQTT, в интерфейс добавлена возможность указать требуемый QoS (quality of service). Настройка QoS позволяет указать необходимый уровень качества обслуживания при передаче сообщений.

Доступные варианты значений:

0 — At most once / Не более одного раза;
1 — At least once / Как минимум один раз;
2 — Exactly once / Ровно один раз.

Выбор QoS для команды в интерфейсе модели:

Выбор QoS для команды при ее формировании в интерфейсе объекта:

Использование в источнике в модели идентификатора объекта и конфигурационных параметров

Добавлена возможность в поле параметра модели «Источник» использовать переменные вида {{object.id}}. Это позволит применять идентификатор объекта для настройки «Источника» узла в модели. Гибкая настройка источника будет полезной, если нужно использовать динамический источник, значение которого будет изменяться в зависимости от объекта. Например есть 2 объекта, которые присылают данные по протоколу MQTT, и при генерации данных в топике передается идентификатор объекта device1/room/light и device2/room/light, где device1 — это client_id первого объекта, а device2 — client_id второго. В этом случае для параметра света вы можете задать источник вида {{object.id}}/room/light и использовать эту модель на обоих объектах.

Аналогично идентификатору, в поле “Источник” можно указывать значение параметра из конфигурации. В этом случае формируется конструкция вида

{{object.<...>.id_of_parameter}}, где

<...> — подсистемы вложенности, в которых находится параметр, указываются через точку;

id_of_parameter — идентификатор параметра.

Например, {{object.config.param.place}}, {object.config.root.setting1} и т.д.

Тогда полный вид источника может выглядеть, например, так:

data/{{object.config.param.place}}/temp

Кроме того, добавлена удобная возможность посмотреть путь до параметра через API объекта.

CTRL+S для сохранения

В основных инструментах платформы была добавлена возможность сохранять изменения по нажатию комбинации клавиш Ctrl+S.

Исправления графиков

Решена проблема, когда точки графика становились практически неразличимы, а цвет линии графика сливался с фоном (до/после):

Исправлена проблема, из-за которой график мог очиститься в процессе работы

Новое меню

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

Исправление багов

Белый экран в редактировании кода в переходах автомата

Исправлена проблема, из-за которой, в некоторых случаях, при нажатии на редактирование условия перехода возникал белый экран.

При обновлении страницы выбиралась сущность внизу списка

Исправлена проблема, из-за которой при обновлении страницы открывался не ранее выбранный объект, а последний в списке.