Node-RED:Библиотеки/node-red-node-email: различия между версиями
Myagkij (обсуждение | вклад) Нет описания правки |
Myagkij (обсуждение | вклад) Нет описания правки |
||
| Строка 4: | Строка 4: | ||
{{Myagkij-редактор}} | {{Myagkij-редактор}} | ||
=node-red-node-email= | =Модуль «node-red-node-email»<ref>[https://flows.nodered.org/node/node-red-node-email flows.nodered.org - node-red-node-email]</ref>= | ||
Ноды этого модуля предназначены для отправки и получения простых имейлов. | |||
== Требования == | |||
Вам понадобятся корректные учетные данные вашего email-сервера. Если вы используете Gmail и если у вас включена 2-факторная аутентификация, то это значит, что вам нужен будет пароль приложения. | |||
{{Спойлер|'''Примечание:''' Версия 1.x этой ноды требует Node.js v8 или новее.}} | |||
== Установка == | |||
Версия 0.x этих нод, как правило, устанавливается вместе с Node-RED. Если у вас Node-RED версии 0.19.x или новее, вы можете установить новую версию «node-red-node-email» либо при помощи меню «Manage palette», либо запустив в пользовательской директории Node-RED (как правило, это «~/.node-red») команду ниже: | |||
cd ~/.node-red | |||
npm i node-red-node-email | |||
== Использование == | |||
=== Нода «E-mail in» === | |||
Эта нода с заданной периодичностью извлекает имейлы с IMAP- или POP3-сервера, а затем, если они еще не были просмотрены, отправляет их дальше по потоку в виде сообщений. | |||
Тема письма сохраняется в свойство «msg.topic», а тело (если это обычный текст) – в «msg.payload». Если в теле содержится не только обычный текст, но и HTML-код, то эти данные сохраняются в «msg.html». Если вам нужны дата и отправитель, то эти данные будут сохранены в свойства «msg.from» и «msg.date». | |||
Кроме того, в выходном сообщении будет свойство «msg.header», содержащее объект со всеми заголовками, включая «to», «cc» и другие потенциально полезные свойства. | |||
Примечание: Эта нода извлекает из «Входящих» лишь самый последний имейл, поэтому время повторного опроса (в поле «every … seconds») нужно задать соответствующе. | |||
Эта нода использует npm-модуль «imap». | |||
=== Нода «E-mail out» === | |||
Отправляет электронное письмо в свойстве «msg.payload» и тему письма в свойстве «msg.topic». | |||
В настройках ноды в поле «To» можно задать получателя, но если оставить это поле пустым, то получателя нужно задать в свойстве «msg.to» входящего сообщения. | |||
Кроме того, вы можете переписать адрес отправителя при помощи свойства «msg.from». В противном случае нода воспользуется настройкой «userid» из данных о подключении к серверу. | |||
Данные в «msg.payload» могут быть в формате HTML. | |||
Если данные в «msg.payload» – это буфер с бинарными данными, то он будет преобразован в приложение к письму. | |||
Название файла задается с помощью свойства «msg.filename». Опционально к телу текста можно добавить свойство «msg.description». | |||
В качестве альтернативы вы можете добавить к сообщению свойство «msg.attachments», содержащее массив с одним или более приложений к письму в формате Nodemailer. | |||
Эта нода использует npm-модуль «nodemailer». | |||
==Ноды== | ==Ноды== | ||
Версия от 19:23, 4 июня 2019
Модуль «node-red-node-email»[1]
Ноды этого модуля предназначены для отправки и получения простых имейлов.
Требования
Вам понадобятся корректные учетные данные вашего email-сервера. Если вы используете Gmail и если у вас включена 2-факторная аутентификация, то это значит, что вам нужен будет пароль приложения.
|
Примечание: Версия 1.x этой ноды требует Node.js v8 или новее. |
Установка
Версия 0.x этих нод, как правило, устанавливается вместе с Node-RED. Если у вас Node-RED версии 0.19.x или новее, вы можете установить новую версию «node-red-node-email» либо при помощи меню «Manage palette», либо запустив в пользовательской директории Node-RED (как правило, это «~/.node-red») команду ниже:
cd ~/.node-red npm i node-red-node-email
Использование
Нода «E-mail in»
Эта нода с заданной периодичностью извлекает имейлы с IMAP- или POP3-сервера, а затем, если они еще не были просмотрены, отправляет их дальше по потоку в виде сообщений.
Тема письма сохраняется в свойство «msg.topic», а тело (если это обычный текст) – в «msg.payload». Если в теле содержится не только обычный текст, но и HTML-код, то эти данные сохраняются в «msg.html». Если вам нужны дата и отправитель, то эти данные будут сохранены в свойства «msg.from» и «msg.date».
Кроме того, в выходном сообщении будет свойство «msg.header», содержащее объект со всеми заголовками, включая «to», «cc» и другие потенциально полезные свойства.
Примечание: Эта нода извлекает из «Входящих» лишь самый последний имейл, поэтому время повторного опроса (в поле «every … seconds») нужно задать соответствующе.
Эта нода использует npm-модуль «imap».
Нода «E-mail out»
Отправляет электронное письмо в свойстве «msg.payload» и тему письма в свойстве «msg.topic».
В настройках ноды в поле «To» можно задать получателя, но если оставить это поле пустым, то получателя нужно задать в свойстве «msg.to» входящего сообщения.
Кроме того, вы можете переписать адрес отправителя при помощи свойства «msg.from». В противном случае нода воспользуется настройкой «userid» из данных о подключении к серверу.
Данные в «msg.payload» могут быть в формате HTML.
Если данные в «msg.payload» – это буфер с бинарными данными, то он будет преобразован в приложение к письму.
Название файла задается с помощью свойства «msg.filename». Опционально к телу текста можно добавить свойство «msg.description».
В качестве альтернативы вы можете добавить к сообщению свойство «msg.attachments», содержащее массив с одним или более приложений к письму в формате Nodemailer.
Эта нода использует npm-модуль «nodemailer».
