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

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
(Новая страница: «{{Node-RED/Панель перехода}} {{Перевод от Сubewriter}} {{Myagkij-редактор}} =node-red-node-email= ==Общение== * Node-…»)
 
Нет описания правки
 
(не показаны 4 промежуточные версии 1 участника)
Строка 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>=


==Общение==
Ноды этого модуля предназначены для отправки и получения простых имейлов.


* [[Node-RED:Библиотеки/node-red-node-email/Email in|Email in]]
== Требования ==
* [[Node-RED:Библиотеки/node-red-node-email/Email out|Email out]]
 
Вам понадобятся корректные учетные данные вашего [[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»''') команду ниже:
 
<syntaxhighlight lang="bash">
cd ~/.node-red
npm i node-red-node-email
</syntaxhighlight>
 
== Использование ==
 
=== Нода «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»'''.
 
==Ноды==
 
{{Node-RED/Библиотеки/node-red-node-email}}


=См.также=
=См.также=
Строка 17: Строка 65:
<references />
<references />
{{Навигационная таблица/Node-RED библиотеки}}
{{Навигационная таблица/Node-RED библиотеки}}
{{Навигационная таблица/Телепорт}}
[[Категория:Модуль]]
[[Категория:Модуль]]
[[Категория:Модуль Node-RED]]
[[Категория:Модуль Node-RED]]
[[Категория:Node-RED модуль]]
[[Категория:Node-RED модуль]]
[[Категория:Модуль node-red-node-email]]
[[Категория:Модуль node-red-node-email]]

Текущая версия от 18:14, 14 мая 2023

Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.


Модуль «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».

Ноды

Общение

См.также

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