Модель Объекта контроля

Модель Объекта контроля - формализованное представление логических и аппаратных функций Устройств, управляющих Объектом контроля. Данное представление состоит из наборов Атомов (базовых элементов): аргументов, событий и действий.

Основная задача Модели - поднять уровень абстракции с уровня протоколов и аппаратной реализации до "человекочитаемых" наименований функций Объекта контроля, с которыми становится удобно работать программисту без необходимости разбираться в протоколе. Преобразованные таким образом данные принимают форму REST API на основе JSON, привычный для разработчиков уровня приложений.

Модель Устройства используется для сериализации и десериализации данных, нормализации данных, рендеринга интерфейсов, а также при создании Сценариев автоматизации. Единожды созданная Модель может использоваться для любого количества одинаковых Объектов контроля.

Нет необходимости создавать Модель для каждого из однотипных Объектов контроля. Одну и ту же Модель можно указать для множества Объектов контроля.

Атомы Модели Устройства

Процесс описания Модели Объекта контроля заключается в определении параметров Модели в виде следующих узлов древовидной структуры:

Связь Модели с базовым протоколом

При создании в Модели новых аппаратных команд, параметров и событий всегда производится "наследование" от базового протокола. Для создания новой команды необходимо "отнаследоваться" от базовой команды протокола, по которому работает Устройство, и ввести аргументы, с которыми команда или несколько команд будут исполняться. Аналогичным образом это работает для событий и параметров.

Для удобства последующего использования вновь созданных атомов Модели лучше присваивать им "человекочитаемые" имена. Для нормализации в JSON в качестве ключа аргумента используется идентификатор вновь созданного атома. Структура данных, полученных в результате нормализации, будет соответствовать структуре Модели.

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

Конфигурирование Модели

Процесс конфигурирования Модели представляет собой создание древовидной структуры, состоящей из атомов. При этом сами атомы создаются путем наследования от базовых функций протокола, по которому работает Устройство.

Конфигурирование Модели для конкретных протоколов подробно рассмотрено в разделе примеров.

ВНИМАНИЕ! В случае отсутствия у пользователя доступа к Модели Устройства, которая назначена на Объект контроля, рендеринг интерфейсов, связанных с просмотром данных, производиться не будет.

Создание виртуальной Модели физического Устройства включает следующие шаги:

  1. Войти в панель "Администрирование"
  2. Открыть вкладку Модели
  3. Вызвать диалоговое окно создания новой Модели

Базовая Модель широко используемых протоколов, таких как MQTT, предлагает структуру всего лишь для примера и пользователю в любом случае предстоит модифицировать ее под себя. В случае проприетарного протокола, например, Wialon, Модель уже представляет собой готовую к использованию структуру.

После нажатия кнопки "Создать" будет создана новая Модель, и можно приступать к ее конфигурированию.

По умолчанию созданная Модель будет выглядеть так:

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

Параметры узлов Модели

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

Существует возможность добавления новых разделов нажатием на иконку "+". Разделы свободно переименовываются.

Общие

Идентификатор является именем поля для внутреннего состояния Устройства, по которому происходит обращение через API

Поле "Описание" выводится в качестве всплывающей подсказки при наведении на Устройство

Аппаратное событие

Программное событие

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

Аргумент

"Использовать для индикации" открывает дополнительные поля.

В данный момент количество отображаемых аргументов ограничено 7 позициями

Действие