Типовые маршруты
Прикладной блок «Отправка электронного письма»
Назначение. Блок «Отправка электронного письма» предназначен для отправки электронного письма по заданным адресам с возможностью вложения копий электронных документов из системы DIRECTUM.
Базовый блок - «Сценарий».
Свойства, унаследованные от базового блока:
Имя |
Заголовок |
Тип |
Отличия от свойств базового блока |
Name |
Наименование |
Строка (Константа) |
По умолчанию имеет значение «Отправка электронного письма» |
Script |
Вычисление |
Строка (Вычисление) |
Скрытое |
Дополнительные свойства:
Имя |
Заголовок |
Тип |
Описание |
Recipients |
Адресаты |
Строка (Константа или параметр) |
Адреса получателей электронного письма (если несколько, то разделяются ';') |
CC |
Копия |
Строка (Константа или параметр) |
Адреса получателей копии электронного письма (если несколько, то разделяются ';') |
BCC |
Скрытая копия |
Строка (Константа или параметр) |
Адреса получателей скрытой копии электронного письма (если несколько, то разделяются ';') |
Subject |
Тема |
Строка (Константа или параметр) |
Тема электронного письма |
Text |
Текст |
Строка (Константа или параметр) |
Текст электронного письма |
Attachments |
Вложения |
Коллекция электронных документов (Константа или параметр) |
Коллекция электронных документов, которые должны быть вложены в электронное письмо при отправке |
Результаты выполнения. В результате выполнения блока возвращается одно из следующих значений:
Код |
Наименование |
Примечание |
S |
Успешно отправлено |
Письмо было успешно отправлено получателям |
N |
Не отправлено |
Во время отправки письма произошла ошибка, и письмо не было отправлено получателям |
A |
Электронный документ зашифрован |
Во вложения был добавлен зашифрованный документ. Письмо не отправлено |
Описание. Для корректной работы блока в системе должны быть корректно заданы следующие константы:
· "MailOutgoingSettings" - настройки для подключения к почтовому серверу исходящей почты;
· "ПЧПРОГ" - программа, от имени которой будет отправляться почта;
· "ПЧОТПР" – адрес e-mail отправителя почты;
· "ПЧИМОТПР" – имя отправителя почты.
Данные константы можно задать с помощью сценария Установки DIRECTUM, в разделе «Работа с почтой».
Если задано свойство Attachments, в электронное письмо будет вложено столько файлов, сколько электронных документов было указано в свойстве Attachments. Имена вкладываемых документов формируются на основе наименования электронного документа. Если наименование электронного документа содержит символы, которые нельзя использовать в именах файлов в файловой системе (такие, как \:/*?"<>|.‘’“”), то они будут заменены на символ «_».
Расширение файла-вложения формируется в зависимости от расширения, указанного в справочнике Приложения-редакторы для вложенного электронного документа.
Если у вложенного электронного документа из коллекции несколько версий, то номер экспортируемой версии будет выбран по следующим правилам:
· если есть действующие версии документа, то экспортируется последняя действующая версия;
· если действующих версий нет, то экспортируется последняя версия в разработке;
· если версий в разработке нет, то экспортируется последняя устаревшая версия.
Если в свойстве Attachments указан документ, которого нет в системе DIRECTUM (был удален), то данный документ не будет вложен в отправляемое письмо.
Если хотя бы один электронный документ из вложений зашифрован, то письмо не будет отправлено и блок завершится с результатом «Электронный документ зашифрован».
Если все свойства были заданы корректно, и в процессе отправки не возникло никаких ошибок, то выполнение блока завершится с результатом «Отправлено», иначе блок завершится с результатом «Не отправлено».
© 2009, Компания DIRECTUM
|
Отправить комментарий к этому разделу на
support@directum.ru
|