SMS-уведомления 2.0

Материал из TekonWiki
Перейти к: навигация, поиск




Введение 

Модуль отправки SMS-сообщений существенно переработан в версии 2.6.0
Для предыдущих версий АСУД.SCADA см. статью SMS-уведомления

Модуль позволяет отправлять сообщения, формируемые примитивами на ситуационном плане SCADA, и фиксируемые Журналом событий АСУД.SCADA:

  • в текстовый файл - демонстрационный режим работы модуля
  • на мобильные телефоны с помощью SMS или Push-уведомлений
  • на адреса электронной почты 
  • в таблицы Google

Т.е. сообщения формируются Примитивами SCADA и передаются в Журнал событий SCADA, а также в  модуль SMS-уведомлений для их последующей пересылки.

Примитив --->>  Cообщение  ---->>  Журнал Событий
                           ---->>  SMS-уведомления -->> Обработка -->> Передача адресату

Внимание! Если в настройках примитива установлена опиция "Журнал" - Нет, примитив не будет формировать SMS-уведомления.

Для полноценной работы модуля требуется наличие: 

  • поключения к сети Интернет
  • или 3G USB-модема с поддержкой АТ-команд (о возможности подключения других USB-модемов уточняйте в тех.поддержке)

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

SMS-cообщения на мобильные телефоны могут отправляться: 

  • через USB-модем  - требуется предоплата за отправленные сообщения;
  • через сервис-провайдера - требуется регистрация и предоплата за отправленные сообщения.

Модуль позволяет отправлять следующие типы сообщений в зависимости от типа исходного сигнала: 

Тип сигнала Тип сообщения Комментарий
Дискретный Авария / Норма сигнал должен быть визуализирован на ситуационном плане 
Числовой Авария / Норма сигнал должен быть визуализирован на ситуационном плане с помощью примитива Цифровой индикатор, LED-индикатор
Управления Включение / Выключение сигнал должен быть визуализирован на ситуационном плане с помощью примитива Канал управления
Переговорной связи Входящий вызов сигнал должен быть визуализирован на ситуационном плане
Статус Нет связи / Норма сигнал должен быть визуализирован на ситуационном плане


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

  • Для сигнала Статус
    • ДАТА Сигнал[Устройство]: Нет связи, Адрес
  • Для прочих сигналов
    • ДАТА Сигнал: Название_события, Адрес

Например:

  • 23:29 НОРМА: Двери лифта, ул. Первая д.1
  • 23:30 АВАР.: Лифт, ул. Первая д.2
  • 23:32 НОРМА: Двери машинного помещения, ул. Первая д.2
  • 23:50 ВКЛ.: Освещение подъезда, ул. Первая д.1
  • 00:41 НОРМА[КУН-IP8 - 0]: Нет связи, ул. Первая д.2

Внимание!

Модуль SMS-уведомлений проигнорирует входящее сообщение, если в конфигураторе ОРС-сервера у концентратора (или другого устройства):

  • не заполнено поле Адрес;
  • не заполнено поле Журнал событий \ Название события.

Настрока модуля 

Для настройки модуля следует перейти в режим настройки и выбрать меню Сервис \ Настройки,   далее  Журналы \ SMS-уведомления

SCADASMS.PNG

Далее следует: 

  1. создать один или несколько фильтров (или правил)  обработки входящих сообщений
  2. выбрать Провайдера передачи сообщений.

Внимание! Сообщения передаются только на один выбранный провайдер.

Порядок обработки входящих сообщений:

  • Если сообщение удовлетворяет фильтру - дальнейшая проверка прекращается.
  • Если сообщение удовлетворяет фильтру, но Получатель сообщения в правиле не указан (пустой) - сообщение будет отброшено.
  • Если сообщение не удовлетворяет ни одному из филтров - сообщение будет отброшено.

Созданные фильтры обрабатываются последовательно (вы можете поменять порядок следования, выбрав фильтр и, нажав правой кнопкой мыши).


Фильтры обработки сообщений

Для работы модуля следует создать один или несколько фильтров обработки входящих сообщений. 

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

Далее настроить фильтр:

  • Название  - просто имя фильтра (желательно уникальное)
  • Сообщение -  шаблон входящего сообщения 
    • символ звездочка - любое сообщение удовлетворяет фильтру
    • лифт - в сообщении должно быть слово "лифт", например:  
      • Авария лифта  - удовлетворяет фильтру
      • Открытие двери - нет
    • лифт; Планерная - в сообщении должны быть слова и "лифт" и "Планерная", например:
      • Неисправность лифта, ул. Первая  - нет
      • Неисправность лифта, ул. Планерная - удовлетворяет правилу 
  • Получатель сообщения - телефон (11 цифр), E-mail адрес или другой идентификатор устройства  в заивисимости от выбранного Провайдера (подробнее см. далее в описании работы конкретного провайдера)
    • если Получатель не указан (пустой) - сообщение будет отброшено (проигнорировано)
  • Тип сигнала - тип сигнала, сформировавшего сообщение
  • Уведомить о переходе в Норма - сформировать сообщение при переходе сигнала в нормальное состояние
    • норма - для дискретного сигнала 
    • выкл. - для канала управления
    • На связи - для канала статуса
  • Отключить  правило  - игнорировать правило (правило не удаляется, но не участвует в обработке)

Внимание! Важно!
Будьте внимательны при создании правила для сигналов типа Статус (особенно при платной отправке SMS-сообщений).
Т.к. в случае выхода из строя, например: USB-пульта сообщение "Нет связи" будет сформировано также для всех подключенных к USB-Пульту концентраторов.
Обратите внимание, что в сообщении "Нет связи", например:  "00:43 АВАР.[КУН-IP8 - 0]: Нет связи, ул. Первая д.1"  - в квадратных скобках указывается тип устройства (из адресного пространства ОРС-сервера), с которым отсутствует связь, что можно использовать при настройке поля "Сообщение" в правиле обработки сообщений. Кроме того, "Нет связи" будет сформировано при запуске Конфигуратора ОРС-сервера без предварительной закрытия программы АСУД.SCADA 

Сообщение, которое удовлетвеоряет хотя бы одному фильтру, сразу отправляется выбранному провайдеру для передачи. 

Как правило,  один сигнал - формирует одно сообщение (например: одно событие  - одна SMS).


Для некоторых провайдеров, например: E-mail, сообщения могут объединяться в группы при отправке.  Группа формируется из последовательно возникших сообщений в течение времения 5 с (интервал может быть изменен в конфигурационном файле).

Если при отправке сообщения провайдер не доступен: нет связи (подключения), программа  повторит отправку сообщения 3 раза через каждые 30 секунд. Если провайдер продолжит быть недоступным, сообщение будет отброшено. 

Провайдеры передачи сообщений

Текстовый файл

Это демонстрационный провайдер. Сообщения просто пишутся в файл log \ smsterminal_DDMMYY.txt

Может быть использован для проверки функционала модуля отправки сообщений.

Провайдер обрабатывает сообщения группами по 2 сообщения.

Поле Получатель в фильтре сообщений  - должно содержать либо валидный мобильный номер (11 цифр, например: 79011234567), либо валидный адрес email (например: mail@mail.com)

АТ-SMS модем 

Отправка SMS-сообщений через USB-модем с поддержкой АТ-команд (см. документацию на модем)

Провайдер обрабатывает по 1 сообщению.

Для настройки USB-модема, следует нажать кнопкку Настроить.

Пример настройки модемов марки ZTE см. в статье SMS-уведомления

Если ваш модем не поддерживает AT-команды, свяжитесь с тех. поддержкой Текон-автоматики для решения вопроса о поддержке вашего модема.

SMSЦентр SMS

Отправка SMS-сообщений через сервис-провайдера https://www.smsc.ru

Требуется подключение к Интернету.  Отправка сообщений - платная (тарифы на отправку см. на сайте сервис-провайдера).

Для настройки требуется предварительная регистрация на сайте сервис-провайдера.

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

Провайдер обрабатывает по 1 сообщению.

SMSЦентр Email

Отправка сообщений электронной почты через сервис-провайдера https://www.smsc.ru

Требуется подключение к Интернету.  Отправка сообщений - платная (тарифы на отправку см. на сайте сервис-провайдера).

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

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

Провайдер обрабатывает сообщения группами по 10 сообщений.

Email

Отправка сообщений электронной почты через корпоративный или бесплатный  Почтовый сервер.

Провайдер обрабатывает сообщения группами по 20 сообщений.

В качестве бесплатного Почтового сервера, вы можете использовать например http://www.mail.ru  Параметры настройки см. здесь 

SCADASMS EM.PNG

 

Если почтовый сервер mail.ru не позволяет отправлять сообщения на ваш e-mail, вы можете создать почтовый ящий на самом сервисе и отправлять сообщения на него.

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

Адрес получателя сообщений будет указываться при формировании Правил обработки сообщений.

Pushover

Pushover  позволяет легко получать PUSH-уведомления в режиме реального времени на Android, iPhone, iPad и ПК (Android Wear и Apple Watch). 

Провайдер обрабатывает сообщения группами по 10 сообщений.

Требуется подключение АРМ к Интернету.  Требуется установка приложения на мобильный телефон или ПК. 

Вы можете воспользоваться бесплатным тестовым 7-дневным периодом после регистрации на сайте.  

По окончании тестового периода, плата за пользование приложением составляет - 5$ (единовоременно,  Individual pricing). Число отправляемых PUSH-уведомлений - до 7500 в месяц.

После регистарации вы получите Pushover user key  (UserToken). Также вам будет предложено задать имя вашего устройства  - можете указать любое. 

Далее следует в личном кабине сформировать (бесплатно)  новое приложение (API Token). Если вы настраиваете несколько АРМ SCADA, вы можете использовать для них один и тот же API Token.

Указанные регистрационные данные внести в окно настройки провайдера 

Pushover.PNG
  • AppToken - API Token
  • UserToken - Pushover user key
  • Заголовок  - Заголовок сообщений, отпавляемых через провайдера

Остаток сообщений - это число сообщений, которое может быть отправлено с данным AppToken до конца текущего месяца. 

Если вы хотите, чтобы уведомления получали два (или более) человека одновременного, следует создать Группу в настройках личного кабинета на сайте. И в качестве UserToken - указывать идентификатор созданной группы.

Особенности настройки правил при использовании провайдера Pushover

В поле "Получатель" сообщения при настройке фильтров сообщений следует указывать none - тогда сообщение будет доставлено на все зарегистрированные устройства пользователя / группы.

Или указывать устройства через запятую, например:   iphone1, nexus, andr17


Таблицы Google

Позволяет записывать сообщения в указанную таблицу Google.

Провайдер обрабатывает сообщения группами по 10 сообщений.

Сообщения будут просто дописываться в новые строки указанной таблицы.

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


Настройка таблицы Google

Для возможности работы с провайдером следует: 

  • Создать учетную запись электронной почты на Gmail (если отсутствует).
  • Зайти под аккаунтом Gmail на Google Developers Console и создать новый проект (с любым названием).
  • Слева вверху выберать раздел меню API и сервисы.
  • Включить для проекта  Drive API и Sheets API (Меню API и сервисы \ Библиотека).
  • Создать сервисный аккаунт и сохранить сервисный ключ.
  • Создать таблицу Google.
  • Разрешить сервисному аккаунту доступ к таблице.
Google api5.PNG

 

Google api1.PNG
Название сервсисного аккаунта укажите любое, тип ключа - JSON.
Google api2.PNG
Выберите роль - Владелец.
Google api3.PNG

Создайте сервисный аккаунт,  нажмите Создать и и сохраните ключ в папке ..\Scada\settings

Ключ необходимо переименовать в файл ..\Scada\settings\gsheet.json

Далее создаем новую таблицу Google, содержащую один или несколько листов.

Google api4.PNG

Имя файла таблицы может быть любым. В примере указано: ASUDTable

Необходимо запомнить: 

  • идентификатор таблицы (SheetId), который выделен в адресной строке;
  • имя листа, в который будет записываься данные.
  • добавить в первой строке таблицы названия колонок, как указано выше

Далее необходимо нажать кнопку Настройки доступа

Google api6.PNG

И добавить адрес электронной почты сервисного аккаунта к списку разршенных людей (сняв галочку "Оповестить пользователей")

Google api7.PNG

 


Настройка провайдера

В окне настройки провайдера следует указать идентификатор таблицы и название листа.

Google api8.PNG
Для проверки корректности ввода параметров, можно отправить Тестовое сообщение - просто нажмите кнопку Отправить.  Если все данные введны правильно, вы получите сообщение "Успешно отправлено", а в таблицу будет добавлена строка со значениями в четырых столбцах  А1, B1, C1, D1

Пример отображения данных в таблице приведен ниже.

Google api9.PNG

 

Особенности настройки правил при использовании провайдера 

В поле "Получатель" сообщения при настройке фильтров сообщений следует указывать none.

 

Ограничения

Существующие ограничения:  max 100 запросов к Google API за 100 секунд для проекта.

Вы можете использовать один и тот же сервисный ключ (файл settings\gsheet.json) на нескольких АРМ (указывая при это в настроках провайдера - разные таблицы или разные листы одной таблицы).

Однако если число сообщений велико и вы превышаете бесплатный лимит,  то вам может потребоваться создавать отдельный проект под каждый АРМ.