Kerong
ПОСТАМАТ - KERONG LCS
Функциональность
- удаленный онлайн мониторинг всех событий с локерами в журнале событий.
- Удаленное открытие ячейки (при наличии разрешения в системе)
- Просмотр текущего состояния занятости ячеек локера.
Установка в качестве демона линукс:
Создать директорию /opt/kerong-gate и поместить в нее kerong-gate.jar, kerong-gate.conf, application.yml
mkdir /opt/kerong-gate
cp kerong-gate.jar /opt/kerong-gate
cp application.yml /opt/kerong-gate
cp kerong-gate.conf /opt/kerong-gate
Создать файл сервиса /etc/systemd/system/sigur-gate.service следующего содержания:
[Unit]
Description=kerong-gate
After=syslog.target
[Service]
User=root
Group=root
ExecStart=/opt/kerong-gate/kerong-gate.jar
SuccessExitStatus=143
[Install]
WantedBy=multi-user.target
Перечитать список сервисов linux
systemctl daemon-reload
Запуск и остановку сервиса можно осуществлять стандартынми командами, модуль работает только в режиме 2
service kerong-gate start
service kerong-gate status
service kerong-gate stop
Запуск
В режиме печати конфигурации Kerong
Используется для получения идентификаторов устройств при регистрации Провайдера
java -jar kerong-gate.jar print
В режиме интеграции Inspark - Kerong
java -jar kerong-gate.jar
Настройка схемы интеграции
- В Библиотеке устройств (Меню->Устройства) найти устройство Kerong.
- Если такого устройства нет, скачать устройство по ссылке и выполнить Импорт (Меню->Импорт).
Инфо
Согласно модели Inspark, Устройство является набором локеров (замков), и задает режимы доступа (PUBLIC, PRIVAT, CORPORAT).
Модель Kerong показана ниже
Топик канала | Тип значения | Представление в Kerong |
---|---|---|
accessMode | строковый | Режим доступа в постомате |
locksSetId | мгновенный | Идентификатор набора замков |
locksSetName | строковый | Название набора замков |
lock-0 | сигнальный | Замок подключеный к 0 входу платы |
lock-1 | сигнальный | Замок подключеный к 1 входу платы |
lock-2 | сигнальный | Замок подключеный к 2 входу платы |
lock-3 | сигнальный | Замок подключеный к 3 входу платы |
lock-4 | сигнальный | Замок подключеный к 4 входу платы |
lock-5 | сигнальный | Замок подключеный к 5 входу платы |
lock-6 | сигнальный | Замок подключеный к 6 входу платы |
lock-7 | сигнальный | Замок подключеный к 7 входу платы |
lock-8 | сигнальный | Замок подключеный к 8 входу платы |
lock-9 | сигнальный | Замок подключеный к 9 входу платы |
lock-10 | сигнальный | Замок подключеный к 10 входу платы |
lock-11 | сигнальный | Замок подключеный к 11 входу платы |
lock-12 | сигнальный | Замок подключеный к 12 входу платы |
lock-13 | сигнальный | Замок подключеный к 13 входу платы |
lock-14 | сигнальный | Замок подключеный к 14 входу платы |
lock-15 | сигнальный | Замок подключеный к 15 входу платы |
Инфо
1 - замок закрыт, 0 - замок открыт, null - замок не подключен или состояние не определено
- Собрать Типовую конфигурацию с таким Устройством, указав тип GATE.
- Подключить Типовую конфигурацию к контроллеру на объекте.
- Создать Провйдера для Kerong.
- В секции Устройства внешней системы создать зоны , в ID проставить номера зон локеров.
Чтобы получить все номера зон системы Kerong, выполните предварительно следующие действия:
запустить модуль интеграции в режиме печати конфигурации;
в логе модуля будут выданы все доступные наборы и их идентификаторы для интеграции.
realLockNumber - замок подключенный к входу платы управления замками, номера входов платы и соответственно номера замков
с 0-15;virtualLockNumber - ячейка, бокс с замком, характеризуется номером ячейки. Ячейки нумеруются с 1 - N в рамках зоны. Каждой ячейке соответствует один замок из набора замков. Например, в наборе 1,
для замка 0 определена ячейка 1
Примечание
Идентификатором наборов в помещении "Офис ИСС" будут наборы 10 и 11 которое необходимо прописать в схеме соединения в ТК.
Привязать к заведенным зонам экземпляры устройств платформы.
Каждой ячейке в поле Альтернативный код введите значение virtualNumber (см. выше), если планируется функция управления (открытие) ячейки.
В Справочнике Событий (Меню->Справочник событий) создайте события, которые планируется получать от системы Kerong (см. ниже материал по настройке действий Kerong)
В справочник типов помещения внести тип для зон ячеек, получить его ID .
Настройка модуля интеграции
Конфигурационный файл application.yml хорошо документирован, поэтому ниже приведены только уточняющие сведения.
Настройка на Провайдера.
В ключ sem-next.rest.extSystemId
- ID Провайдера, зарегистрироваванный в платформе.
Настройка на зону (помещение).
В ключ sem-next.rest.sensor-location-id необходимо внести ТИП ID ПОМЕЩЕНИЯ. Модуль интеграции будет использовать этот тип помещения для создания конкретных помещений из системы Kerong, и привязки параметров-ячеек к конкретным помещениям.
Настройка адресации ячейки
В ключ channels.locks.real-number
вписывается номер realLockNumber ячейки на плате, который соответствует топику устройства.
Важно!
Модуль интеграции может работать с любым количеством ячеек Kerong, но необходимо поддерживать одинаковую адресацию между физическим портом контроллера Kerong, куда подключается ячейка и топиком устройства в Inspark. На всех зонах должно быть одинаковое соответсвие.
[real-number -> topic]
Обновления значений ячеек
Api Kerong не позволяет отслеживать состояние замков по подписке, поэтому реализована отправка значений состояния
замков периодически при синхронизации метаданных интеграции.
# Настройка интеграции журнала событий Kerong для генерации событий Semnext
events:
# задание периодичности обновления метаданных интеграции в виде крон строки
# (устройства и параметры настроенные в Inspark и их и их представление в Kerong)
# при настройке интеграции предлагается установить каждые 15 минут часа: 0 0,15,30,45 * * * ?
# для штатной работы раз в час: 0 0 * * * ?
cron: 0 0 * * * ?
Инфо
Настройка раз в 15 минут будет означать, что данные внесенные в системы и значения параметров отправятся в это время даже если на постомате за этот интервал не было зафиксировано ни одного события.
Получение действий Kerong
Все типы событий по действиям (operation) от Kerong, которые могут быть получены модулем интеграции, приведены в конфигурационном файле.
Каждое событие в журнале Kerong связано с ячейкой, а через него с замком. Событие может вызывать изменение состояния
замка или нет, это определяется в конфигурационном файле для каждого события
# Настройка интеграции событий Kerong событиям Inspark
events:
refs:
# Сопоставление операций в журнале событий Kerong событиям Inspark
-
# Наименование операции в Kerong.
operation: Аренда
# значение отправляемое для связанного замка на данное событие:
# true - замок закрыт
# false - замок открыт
# если значение не указано, тогда значение замку не отправляется
value: true
# Идентификатор события в Semnext
semEventId: 5001
# Шаблон текста события, поддерживаются подстановки
# $LOCKNUMBER - номер замка
# $ZONENAME - имя зоны в Kerong
# $OPERATION - наименование операции
# $FIO - фио клиента связанного с событием
# $IDENTIFIER - это номер карты, телефона использованного клиентом
# $ZONEID - идентификатор зоны
semEventMessageTemplate: В постамате $ZONENAME ($ZONEID) $OPERATION ячейки $LOCKNUMBER клиентом $FIO идентификатор $IDENTIFIER
Чтобы по событию Kerong в Inspark отправлялось значение интеграционоого параметра, необходимо в конфиге для данного события задать значение параметра true или false
-
operation: Закончилась аренда
value: false
Пояснение
Это означает, что по событию "Закончилась аренда", для параметра замка связанного с этим событием будет отправлено значение 0. Если не задать ни какого значения по событию, будет означать, что состояние замка не меняется
и новое значение не отправляется
Чтобы на основании события Kerong создавалось событие в Inspark необходимо в конфиге для данного события задать
параметр semEventId
-
# Наименование операции в Kerong.
operation: Аренда
# Идентификатор события в Semnext
semEventId: 5001
semEventMessageTemplate: В постамате $ZONENAME ($ZONEID) $OPERATION ячейки $LOCKNUMBER клиентом $FIO
идентификатор $IDENTIFIER начата аренда
Работа с Kerong в Inspark
При корректной настройке и работе системы Kerong все ячейки должны иметь актуальный статус, в Журнал событий должны поступать настроенные события, у параметров-статусов ячейки заполнены помещения (проставляет интеграционный модуль).
Управление со стороны Inspark реализовано только в части открытия ячейки.
Создайте дашборд с виджетом под название Kerong. Один виджет описывает одну Зону замков. Привяжите к каждой ячейке параметр-ячейку. Для каждой ячейки доступна операция по ее Открытию.
Внимание
если для ячейки не прописан в Альтернативном коде номер ячейки в системе Kerong (virtualNumber), операция открытия не будет работать.
В административном приложении эта же операция может быть выполнена в разделе Внешние команды.