Отправить письмо (SMTP)

alt

Компонент отправляет почтовое сообщение по протоколу SMTP с поддержкой современных режимов защищённого соединения (SSL/TLS, STARTTLS).

Базовая активность для отправки почтового сообщения по протоколу SMTP.

Доступны две версии активности для отправки писем по протоколу SMTP:

Версия Описание

SMTP Базовая версия, входит в поставку Studio. Поддерживает стандартные параметры отправки (От, Кому, Тема, Содержимое, Вложения).

SMTP+ Расширенная версия с поддержкой копий (CC, BCC), защищённого пароля (SecureString) и дополнительных режимов шифрования. Включает поддержку SMTP SSL соединения на 465 порту (Implicit SSL). Требуется установка пакета Primo.Networking версии 1.1.6 и выше. Перейти к SMTP+

Версия	Описание
SMTP	Базовая версия, входит в поставку Studio. Поддерживает стандартные параметры отправки (От, Кому, Тема, Содержимое, Вложения).
SMTP+	Расширенная версия с поддержкой копий (CC, BCC), защищённого пароля (SecureString) и дополнительных режимов шифрования. Включает поддержку SMTP SSL соединения на 465 порту (Implicit SSL). Требуется установка пакета `Primo.Networking` версии 1.1.6 и выше. Перейти к SMTP+

Важно: SMTP+ не входит в базовую поставку Studio и требует установки дополнительного пакета через менеджер зависимостей. Подробнее см. Primo.Networking.

Настройка SSL/TLS в зависимости от порта

Режим шифрования определяется автоматически на основе указанного порта:

Порт	Режим SSL/TLS	Описание
465	`SslOnConnect` (Implicit SSL)	Соединение устанавливается сразу через SSL/TLS. Для этого порта необходимо установить `SSL = true`
587	`StartTls`	Соединение начинается как обычное (незашифрованное), затем шифрование активируется командой STARTTLS

Важно:

Для порта 465 требуется включить SSL-соединение явно (SSL = true).

Базовая версия SMTP не поддерживает порт 465 с Implicit SSL. Для работы с этим портом используйте SMTP+.

Порт 587 не поддерживает режим SslOnConnect, используйте StartTls.

Примечание: Для работы с портом 465 в базовой версии SMTP используйте свойство SSL = true. Если требуется более гибкая настройка SSL/TLS режимов, используйте расширенную версию SMTP+.

Свойства

Символом * отмечены обязательные для заполнения свойства. Описание общих свойств см. здесь.

Свойство	Тип	Описание
От*	String	Адресат - От кого
Кому*	String	Адресат - Кому
Копия	String	Адресат - Копия (CC)
Вторая копия	String	Адресат - Скрытая копия (BCC)
Тема	String	Тема сообщения
Содержимое*	String	Содержимое сообщения
HTML	Boolean	Признак HTML-содержимого сообщения
Вложения	List<String>	Пути к файлам вложений
Сервер*	String	Адрес почтового сервера
Порт*	Int32	Порт почтового сервера
Логин*	String	Логин почтового сервера
Пароль	String	Пароль почтового сервера
Защищенный пароль	SecureString	Защищенный пароль (приоритет выше обычного)
SSL*	Boolean	Признак использования сервером соединения SSL
Таймаут*	Int32	Предельное время ожидания завершения процесса (мс)

Только код (Pure code)

Ниже приведен пример использования элемента в процессе с типом Только код (Pure code):

C#


LTools.Network.MailApp.SMTPSend(wf, "from", "to", "subject", "body", "server", 443, "login", "password", false, false, new List<string>() { "file1" }, 10000);

Python


dt = List[String]()
dt.Add("file1")
LTools.Network.MailApp.SMTPSend(wf, "from", "to", "subject", "body", "server", 443, "login", "password", False, False, dt, 10000)

JavaScript


var host = new _lib.Microsoft.ClearScript.HostFunctions();
var lst = host.newObj(_lib.System.Collections.Generic.List(_lib.System.String));
lst.Add("file 1");
_lib.LTools.Network.MailApp.SMTPSend(wf, "from", "to", "subject", "body", "server", 443, "login", "password", false, false, lst, 10000);