Опрос счётчиков через Декаст Облако

ЛЭРС УЧЁТ позволяет считывать данные со счётчиков, которые подключаются к системе Декаст Облако.

Поддерживаются следующие модели:

• Декаст ВСКМ iWAN

Интеграция производится через вебхуки. Сервер Декаст Облако с определённой периодичностью будет передавать показания, которые примет и обработает сервер ЛЭРС УЧЁТ.

Обязательные требования

Для интеграции с облаком Декаст сервер ЛЭРС УЧЁТ обязательно должен иметь внешний статический IP-адрес, или доменное имя. Сервер должен быть доступен из внешних сетей, а не только изнутри вашего предприятия.

Это определяется самой технологией вебхуков, при которой один сервер обращается к другому.

Важно

Если на вашем сервере не настроен HTTPS, данные вебхуков будут переданы в открытом виде. Таким образом, данные могут быть перехвачены и использованы для передачи в систему заведомо неверных данных. Чтобы этого не произошло, настройте на сервере ЛЭРС защищённый обмен по протоколу https.

Настройка

Авторизация на сервере ЛЭРС

Сервер Декаст должен быть авторизован на сервере ЛЭРС, чтобы убедиться, что передаются не заведомо ложные показания. Для этого понадобится токен доступа службы опроса, будет нужен при настройке интеграции в Декаст Облако.

Чтобы получить токен, откройте список учётных записей, найдите учётную запись "Служба опроса" и откройте её свойства.

На закладке "Доступ" введите:

• Наименование приложения: любое понятное значение. Например, "Облако Декаст"
• Срок действия токена истекает: укажите достаточно большой срок, чтобы интеграция не сломалась в ближайшее время. Например, 30 лет.

Нажмите кнопку "Получить токен". Сохраните полученный токен, так как он понадобится в дальнейшем для настроек устройств в облаке Декаст.

Эту операцию нужно выполнить только один раз. Но если вы потеряли токен, вы можете повторить процедуру. Старые токены, которые уже используются в интеграциях, продолжат работать.

Адреса вебхуков

Для каждой модели устройства в ЛЭРС нужно указать свой адрес для вебхука. Адрес состоит из внешнего адреса вашего сервера ЛЭРС и пути запроса. В примерах мы будем использовать внешний адрес сервера https://my.lers.ru, но у вас адрес будет другой.

Модель	Путь запроса	Пример
Декаст ВСКМ iWAN	/api/v1/Poll/Hooks/Decast/DecastVskmiWan	https://my.lers.ru/api/v1/Poll/Hooks/Decast/DecastVskmiWan

Настройка в ЛЭРС

Чтобы настроить точку учёта для опрос через Декаст Облако выполните следующие действия:

1. Создайте точку учёта и на закладке Устройство создайте устройство с моделью Декаст ВСКМ iWAN. Обязательно укажите верный серийный номер устройства, иначе данные не будут получены.
2. Перейдите на закладку Подключения и создайте новое подключение с типом Webhook.
3. Перейдите на закладку Автоопрос и создайте новое расписание автоопроса через подключение Webhook.

Примечание

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

Настройка интеграции в облако Декаст

Общий принцип настройки вебхуков описан в документации.

Для каждого устройства нужно добавить интеграцию Webhook, в которой указать следующие параметры:

• Дата следующей передачи показаний: укажите сегодняшее число
• Повторить передачу показаний через: День
• URL: укажите путь для вебхуков нужной модели устройства.

Чтобы сервер Декаст смог авторизоваться на сервере ЛЭРС, в разделе "Заголовки" нажмите кнопку "Добавить" и создайте новый заголовок. Укажите имя Authorization и значение:

Bearer ТОКЕН_СЛУЖБЫ_ОПРОСА

Как получить токен службы опроса описано в этом разделе. Обратите внимание, что между словом Bearer и самим токеном нужно обязательно указать пробел.

Нажмите кнопку "Сохранить". После этого можете отправить первые показания через интерфейс облака Декаст.

Журнал опроса

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

Расчёт интеграторов и потребления

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

• Интеграторов интерполяцией
• Часового архива по интеграторам
• Суточного архива по часовому
• Месячного архива по суточному