Электронная почта

Используется для отправки email-сообщений по протоколу SMTP.

Свойства

Секция «Подключение»

Способ подключения Позволяет выбрать способ задания параметров подключения к почтовому серверу. Возможные варианты: параметры и строка подключения. Вариант параметры позволяют указать параметры подключения по отдельности. Вариант строка подключения — единой строкой со всеми параметрами.

Адрес сервера Адрес (домен или IP-адрес) почтового сервера без указания протокола. Например, "smtp.yandex.ru". Формат: "значение в кавычках" или выражение.

Порт Порт почтового сервера. Например, 465. Формат: "значение в кавычках" или выражение.

Шифрование Указывает использовать ли защищенное соединение (SSL) для подключения к почтовому серверу. Вариант «не использовать» сначала пробует соединиться используя технологию STARTTLS, при неуспехе пробует без шифрования.

Логин Логин для авторизации на почтовом сервере. Как правило совпадает с адресом электронной почты. Формат: "значение в кавычках" или выражение.

Пароль Пароль для авторизации на почтовом сервере. Как правило совпадает с паролем от адреса электронной почты. Формат: "значение в кавычках" или выражение.

Секция «Письмо»

От Адрес отправителя письма. Допустимо указывать адрес электронный почты или строку с именем отправителя конструкцией вида: "Имя <email@email.ru>". Формат: "значение в кавычках" или выражение. Примеры:

"bpium@bpium.ru"
"Bpium <bpium@bpium.ru>"

Кому Адрес электронной почты получателя отправителя письма. Адресатов может быть несколько. Формат: список "значений в кавычках" или выражений. Примеры:

"user1@bpium.ru"
"user1@bpium.ru, user2@bpium.ru, user3@bpium.ru"

Тема Заголовок письма. Формат: "значение в кавычках" или выражение.

Текст Содержание письма. Формат: "значение в кавычках" или выражение.

Для удобства ввода содержания писем используйте выражение а формате шаблонов. Шаблоны позволяют использовать многострочный текст и переменные внутри текста. В отличие от текстовых констант шаблоны заключаются в обратные одинарные кавычки (`), а не обычные двойные (") или обычные одинарные ('). Подробнее в статье «Выражения». Пример использования шаблона в качестве значения выражения:

`Здравствуйте, ${name}!
Рады сообщить вам, что...`

Формат Определяет формат содержания письма: Простой текст или HTML. В случае простого текста письмо будет отправлено без форматирования, в случае HTML — в формате HTML, это значит что в тексте письма могут быть использованы разрешенные для писем HTML-теги.

Вложения Вложения к письмо. Бипиум поддерживает прикрепление файлов, размещенных где-либо в интернете. Например файлов прикрепленных к записям в каталогах и хранящимся в облачном хранилище. Вложений может быть несколько. Чтобы прикрепить к письму файл укажите в это свойство объект с 2 параметрами:

{
title: 'Название файла.doc',
url: 'http://URL к файлу'
}

Если требуется прикрепить несколько файлов — укажите массив из таких объектов:

[
{
title: 'Договор.doc',
url: 'http://URL к файлу'
},
{
title: 'Счет.xls',
url: 'http://URL к файлу'
}
]

Пример прикрепления файлов из поля записи каталога

Файлы в записях каталога также хранятся в массиве и могут использоваться без преобразований. Если к записи прикреплен один файл, то достаточно просто передать данные из поля "файл":

[
{
id: 1,
title: "Документ.pdf",
size: 1024,
url: "https://...",
mimeType: "application/pdf",
metadata: null
}
]

Вышеуказанное представляет собой коллекцию данных из поля "Файл", однако система возьмет только значения по ключам "title" и "url".

Параметры подключения к популярным сервисам

Gmail

  • Адрес сервера: "smtp.gmail.com"

  • Порт: 465

  • Шифрование: использовать

  • Логин: полный адрес эл.почты

  • Пароль: ваш пароль

Если письма не отправляются Gmail может заблокировать отправку письма, так как письма отправляются с наших серверов. Google может посчитать их подозрительными, так как они находятся в непривычном для вас территориальном месте.

Чтобы решить проблему, зайдите на страницу со списком последних устройств, которые пытались авторизоваться — https://myaccount.google.com/device-activity. Вы увидите попытку входа из Дублина/Ирландии и вопрос, считать ли это подключения вашим. Подтвердите.

Пограничные события

Компонент поддерживает 2 типа пограничных событий:

  • Ошибка — выход из компонента, если произошла какая-либо ошибка

  • Таймаут — выход из компонента, спустя заданное ограничение по времени

Если компонент завершился с ошибкой, но на нем не было пограничного события, то процесс завершается. Сообщение ошибки возвращается в результатах процесса.