Kerong

3 февраля 2025 г.Около 4 минGateПостаматSmartOffice

ПОСТАМАТ - KERONG LCS

Функциональность

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

Настройка схемы интеграции

В Библиотеке устройств (Меню->Устройства) найти устройство с типом KERONG_CU_16.
Если такого устройства нет, скачать устройство по ссылке и выполнить Импорт (Меню->Импорт).

Инфо

Согласно модели 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 - замок не подключен или состояние не определено

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

запустить модуль интеграции в режиме печати конфигурации;
в логе модуля будут выданы все доступные наборы и их идентификаторы для интеграции.
realLockNumber - замок подключенный к входу платы управления замками, номера входов платы и соответственно номера замков
с 0-15;
virtualLockNumber - ячейка, бокс с замком, характеризуется номером ячейки. Ячейки нумеруются с 1 - N в рамках зоны. Каждой ячейке соответствует один замок из набора замков. Например, в наборе 1,
для замка 0 определена ячейка 1

Примечание

Идентификатором наборов в помещении "Офис ИСС" будут наборы 10 и 11 которое необходимо прописать в схеме соединения в ТК.

В схеме соединения в поле Адрес поставьте требуемый номер.

Подключить Типовую конфигурацию к контроллеру на объекте.
Каждой ячейке в поле Альтернативный код введите значение virtualNumber (см. выше), если планируется функция управления (открытие) ячейки.

В Справочнике Событий (Меню->Справочник событий) создайте события, которые планируется получать от системы Kerong (см. ниже материал по настройке действий Kerong)
В справочник типов помещения внести тип для зон ячеек, получить его ID .

Настройка модуля интеграции

Конфигурационный файл хорошо документирован, поэтому ниже приведены только уточняющие сведения.

Важно!

В шине Inspark должна быть создана специальная очередь для команд управления по открытию ячейки (см. ключ sem-next.artemis.command.queue)

Настройка на зону (помещение).

В ключ sem-next.rest.sensor-location-id необходимо внести ТИП ID ПОМЕЩЕНИЯ, которое привязано к ячейкам в п.8. Модуль интеграции будет использовать этот тип помещения для создания конкретных помещений из системы 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), операция открытия не будет работать.

В административном приложении эта же операция может быть выполнена в разделе Внешние команды.