Справочники

 

Типовые маршруты

 

Прикладной блок «Отправка электронного письма»

Назначение. Блок «Отправка электронного письма» предназначен для отправки электронного письма по заданным адресам с возможностью вложения копий электронных документов из системы DIRECTUM.

Базовый блок - «Сценарий».

Свойства, унаследованные от базового блока:

 

Имя

Заголовок

Тип

Отличия от свойств базового блока

Name

Наименование

Строка (Константа)

По умолчанию имеет значение «Отправка электронного письма»

Script

Вычисление

Строка (Вычисление)

Скрытое

Дополнительные свойства:

 

Имя

Заголовок

Тип

Описание

Recipients

Адресаты

Строка (Константа или параметр)

Адреса получателей электронного письма (если несколько, то разделяются ';')

CC

Копия

Строка (Константа или параметр)

Адреса получателей копии электронного письма (если несколько, то разделяются ';')

BCC

Скрытая копия

Строка (Константа или параметр)

Адреса получателей скрытой копии электронного письма (если несколько, то разделяются ';')

Subject

Тема

Строка (Константа или параметр)

Тема электронного письма

Text

Текст

Строка (Константа или параметр)

Текст электронного письма

Attachments

Вложения

Коллекция электронных документов (Константа или параметр)

Коллекция электронных документов, которые должны быть вложены в электронное письмо при отправке

Результаты выполнения. В результате выполнения блока возвращается одно из следующих значений:

 

Код

Наименование

Примечание

S

Успешно отправлено

Письмо было успешно отправлено получателям

N

Не отправлено

Во время отправки письма произошла ошибка, и письмо не было отправлено получателям

A

Электронный документ зашифрован

Во вложения был добавлен зашифрованный документ. Письмо не отправлено

Описание. Для корректной работы блока в системе должны быть корректно заданы следующие константы:

·         "MailOutgoingSettings" - настройки для подключения к почтовому серверу исходящей почты;

·         "ПЧПРОГ" - программа, от имени которой будет отправляться почта;

·         "ПЧОТПР" – адрес e-mail отправителя почты;

·         "ПЧИМОТПР" – имя отправителя почты.

Данные константы можно задать с помощью сценария Установки DIRECTUM, в разделе «Работа с почтой».

Если задано свойство Attachments, в электронное письмо будет вложено столько файлов, сколько электронных документов было указано в свойстве Attachments. Имена вкладываемых документов формируются на основе наименования электронного документа. Если наименование электронного документа содержит символы, которые нельзя использовать в именах файлов в файловой системе (такие, как \:/*?"<>|.‘’“”), то они будут заменены на символ «_».

Расширение файла-вложения формируется в зависимости от расширения, указанного в справочнике Приложения-редакторы для вложенного электронного документа.

Если у вложенного электронного документа из коллекции несколько версий, то номер экспортируемой версии будет выбран по следующим правилам:

·         если есть действующие версии документа, то экспортируется последняя действующая версия;

·         если действующих версий нет, то экспортируется последняя версия в разработке;

·         если версий в разработке нет, то экспортируется последняя устаревшая версия.

Если в свойстве Attachments указан документ, которого нет в системе DIRECTUM (был удален), то данный документ не будет вложен в отправляемое письмо.

Если хотя бы один электронный документ из вложений зашифрован, то письмо не будет отправлено и блок завершится с результатом «Электронный документ зашифрован».

Если все свойства были заданы корректно, и в процессе отправки не возникло никаких ошибок, то выполнение блока завершится с результатом «Отправлено», иначе блок завершится с результатом «Не отправлено».