Отправка почты

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

Свойства

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

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

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

    • Вариант «параметры» позволяет указать параметры подключения по отдельности.

    • Вариант «строка подключения» — единой строкой со всеми параметрами.

Способ подключения: Параметры

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

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

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

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

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

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

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

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

    • Пример использования шаблона: Здравствуйте, ${name}! Рады сообщить вам, что...

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

  • Вложения — вложения к письму. КОСКО BPM поддерживает прикрепление файлов, размещенных где-либо в интернете, например файлов, прикрепленных к записям в каталогах и хранящимся в облачном хранилище. Вложений может быть несколько.

    • Чтобы прикрепить к письму один файл, укажите в этом свойстве объект с двумя параметрами:

{ title: 'Название файла.doc', url: 'http://URL к файлу' }
  • Если требуется прикрепить несколько файлов — укажите массив из таких объектов:

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

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

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

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

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

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

Яндекс

  • Адрес сервера: "smtp.yandex.ru"

  • Порт: 465

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

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

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

Gmail

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

  • Порт: 465

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

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

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

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

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

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

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

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

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

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