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

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

Свойства

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

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

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

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

Шифрование
Указывает использовать ли защищенное соединение (SSL) для подключения к почтовому серверу.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Один файл

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

{filename: values[2][0]["title"], path: values[2][0]["url"]}

В этом примере показано, как прикрепить к письму первый файл (предположим, что данные записи хранятся в переменой values, а сами файлы указаны во втором поле записи (values[2]). Это выражение даст ошибку, если во 2-м поле записи нет прикрепленных файлов. Нужно до этого проверить его наличие.

Несколько файлов

Скрипт ниже поможет преобразовать все прикрепленные к записи файлы (сколько бы их не было) в структуру данных прикрепляемых к письму файлов:

values[2].map(i=>({filename: i.title, path: i.url}))

В этом примере показано, как прикрепить к письму все файлы записи (предположим, что данные записи хранятся в переменой values, а сами файлы указаны во втором поле записи (values[2]). Этот скрипт сработает, даже если во 2-м поле нет файлов.


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

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

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

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


results matching ""

    No results matching ""