Node-RED:Библиотеки/node-red-node-email: различия между версиями

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
Нет описания правки
Нет описания правки
Строка 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».

Ноды

Общение

См.также

Внешние ссылки