Notification module: различия между версиями
Brainroot (обсуждение | вклад) |
Admin (обсуждение | вклад) |
||
(не показаны 32 промежуточные версии 8 участников) | |||
Строка 1: | Строка 1: | ||
[[File:web-alarm.png|400px|thumb|right|Настройка модуля уведомлений]] | [[File:web-alarm.png|400px|thumb|right|Настройка модуля уведомлений]] | ||
Модуль уведомлений (алармов, Alarm) предназначен для быстрой настройки отправки СМС и email в случае изменения параметров контроллера или подключённых устройств | Модуль уведомлений (алармов, Alarm) предназначен для быстрой настройки отправки СМС и email в случае изменения параметров контроллера или подключённых устройств (например, показаний подключённого датчика температуры). | ||
== | ==Настройка модуля уведомлений== | ||
На уровне Linux для отправки email используется утилита [https://linux.die.net/man/8/ssmtp sSMTP]. | #Выполните предварительные действия: | ||
#*для отправки SMS проверьте, что вы вставили SIM-карту и подключили GSM антенну; | |||
#*для отправки email настройте почтовый сервер: | |||
#**f | |||
#**f | |||
#*:На уровне Linux для отправки email используется утилита [https://linux.die.net/man/8/ssmtp sSMTP]. В случае дополнительных вопросов, смотрите [http://askubuntu.com/questions/185070/why-i-get-hostname-name-or-service-not-known-error] и [https://wiki.archlinux.org/index.php/SSMTP]. | |||
Создать файл конфигурации для отправки писем /etc/ssmtp/ssmtp.conf по инструкции . Пример рабочей конфигурации лежит в папке. | |||
В | |||
#Зайдите на страницу | #Зайдите на страницу ''Configs - Alarm Configuraion'' веб-интерфейса. | ||
#Добавьте получателей уведомлений в разделе | #Добавьте получателей уведомлений в разделе ''Recipients'': | ||
#*нажмите кнопку | #*нажмите кнопку ''+ Recipient'', | ||
#* | #*выберите тип (''E-mail'' или ''SMS''), | ||
#*введите почтовый адрес или номер телефона. Для email можно также указать тему письма. | #*введите почтовый адрес или номер телефона. Для email можно также указать тему письма. | ||
#Настройте проверяемый параметр и условие в разделе | #Настройте проверяемый параметр и условие в разделе ''Alarms'': | ||
#*в ''Alarm name'' введите произвольное название для уведомления; | |||
#*в ''Cell'' введите параметр, за которым нужно следить. Параметр задаётся в виде ''Device/Control'', где названия Device и Control для каждого параметра можно найти на странице ''Settings'' веб-интерфейса в таблице ''MQTT Channels''. Например, для датчика 1-Wire, подключённого к внешнему Modbus сенсору WB-MS, эта строка будет выглядеть как ''wb-ms-thls-v2_101/External Sensor 2''; | |||
#*в ''Alarm activation message'' введите текст сообщения, которое будет отправлено. В него в произвольном месте можно ввести две фигурные скобки ''{}'', вместо которых в сообщение будет подставлено новое значение параметра, за которым производится слежение. | |||
#Нажмите ''Save'' в самом верху страницы: | |||
#*в | |||
#*в | |||
#*в | |||
#Нажмите | |||
#*если вы забыли указать какой-то обязательный параметр, кнопка ''Save'' будет неактивна, а рядом с параметром красным будет написана ошибка, которую нужно исправить; | #*если вы забыли указать какой-то обязательный параметр, кнопка ''Save'' будет неактивна, а рядом с параметром красным будет написана ошибка, которую нужно исправить; | ||
#*если всё в порядке, уведомления | #*если всё в порядке, уведомления начнут работать. | ||
==Как настроить уведомления с более сложными условиями== | ==Как настроить уведомления с более сложными условиями== | ||
Модуль уведомлений | Модуль уведомлений для быстрой настройки просты уведомлений. Если вам нужны более сложные сценарии уведомлений, их можно запрограммировать через [[Движок правил wb-rules | движок правил]]. Чтобы отправить сообщение, из правила нужно вызвать функцию | ||
<syntaxhighlight lang="ecmascript"> | <syntaxhighlight lang="ecmascript"> | ||
Notify.sendEmail( | Notify.sendEmail(to, subject, text); //отправляет почту указанному адресату (to), с указанной темой (subject) и содержимым (text) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
или | или | ||
<syntaxhighlight lang="ecmascript"> | <syntaxhighlight lang="ecmascript"> | ||
Notify.sendSMS( | Notify.sendSMS(to, text); //отправляет SMS на указанный номер (to) с указанным содержимым (text) | ||
</syntaxhighlight> | </syntaxhighlight> |
Версия 17:44, 6 октября 2016
Модуль уведомлений (алармов, Alarm) предназначен для быстрой настройки отправки СМС и email в случае изменения параметров контроллера или подключённых устройств (например, показаний подключённого датчика температуры).
Настройка модуля уведомлений
- Выполните предварительные действия:
Создать файл конфигурации для отправки писем /etc/ssmtp/ssmtp.conf по инструкции . Пример рабочей конфигурации лежит в папке.
- Зайдите на страницу Configs - Alarm Configuraion веб-интерфейса.
- Добавьте получателей уведомлений в разделе Recipients:
- нажмите кнопку + Recipient,
- выберите тип (E-mail или SMS),
- введите почтовый адрес или номер телефона. Для email можно также указать тему письма.
- Настройте проверяемый параметр и условие в разделе Alarms:
- в Alarm name введите произвольное название для уведомления;
- в Cell введите параметр, за которым нужно следить. Параметр задаётся в виде Device/Control, где названия Device и Control для каждого параметра можно найти на странице Settings веб-интерфейса в таблице MQTT Channels. Например, для датчика 1-Wire, подключённого к внешнему Modbus сенсору WB-MS, эта строка будет выглядеть как wb-ms-thls-v2_101/External Sensor 2;
- в Alarm activation message введите текст сообщения, которое будет отправлено. В него в произвольном месте можно ввести две фигурные скобки {}, вместо которых в сообщение будет подставлено новое значение параметра, за которым производится слежение.
- Нажмите Save в самом верху страницы:
- если вы забыли указать какой-то обязательный параметр, кнопка Save будет неактивна, а рядом с параметром красным будет написана ошибка, которую нужно исправить;
- если всё в порядке, уведомления начнут работать.
Как настроить уведомления с более сложными условиями
Модуль уведомлений для быстрой настройки просты уведомлений. Если вам нужны более сложные сценарии уведомлений, их можно запрограммировать через движок правил. Чтобы отправить сообщение, из правила нужно вызвать функцию
Notify.sendEmail(to, subject, text); //отправляет почту указанному адресату (to), с указанной темой (subject) и содержимым (text)
или
Notify.sendSMS(to, text); //отправляет SMS на указанный номер (to) с указанным содержимым (text)