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