Примеры работы с функциями отправки сообщений в БСП 1с.
// Проверяет, настроена ли учетная запись для отправки и/или получения почты.
// Параметры:
// УчетнаяЗапись - Справочники.УчетныеЗаписиЭлектроннойПочты - проверяемая учетная запись;
// ДляОтправки - Булево - проверять параметры, необходимые для отправки почты;
// ДляПолучения - Булево - проверять параметры, необходимые для получения почты.
// Возвращает Булево.
Результат = РаботаСПочтовымиСообщениями.УчетнаяЗаписьНастроена( УчетнаяЗапись, ДляОтправки, ДляПолучения);// Открывает форму создания нового письма.
// Параметры:
// ПараметрыОтправки - Структура - параметры для заполнения в форме отправки нового письма (все необязательные):
// * Отправитель - СправочникСсылка.УчетныеЗаписиЭлектроннойПочты - учетная запись, с которой может
// быть отправлено почтовое сообщение;
// - СписокЗначений - список учетных записей, доступных для выбора в форме:
// ** Представление - Строка- наименование учетной записи;
// ** Значение - СправочникСсылка.УчетныеЗаписиЭлектроннойПочты - учетная запись.
// * Получатель - список почтовых адресов.
// - Строка - список адресов в формате:
// [ПредставлениеПолучателя1] ; [[ПредставлениеПолучателя2] ;...]
// - СписокЗначений - Список адресов.
// ** Представление - Строка - представление получателя,
// ** Значение - Строка - почтовый адрес.
// * Тема - Строка - тема письма.
// * Текст - Строка - тело письма.
// * Вложения - Массив - файлы, которые необходимо приложить к письму (описания в виде структур):
// ** Структура - описание вложения:
// *** Представление - Строка - имя файла вложения;
// *** АдресВоВременномХранилище - Строка - адрес двоичных данных вложения во временном хранилище.
// *** Кодировка - Строка - кодировка вложения (используется, если отличается от кодировки письма).
// *** Идентификатор - Строка - (необязательный) используется для отметки картинок, отображаемых в теле письма.
// * УдалятьФайлыПослеОтправки - Булево - удалять временные файлы после отправки сообщения.
// ОповещениеОЗакрытииФормы - ОписаниеОповещения - процедура, в которую необходимо передать управление после закрытия формы отправки письма.
РаботаСПочтовымиСообщениямиКлиент.СоздатьНовоеПисьмо( ПараметрыОтправкиПисьма, ОповещениеОЗакрытииФормы);// Получает ссылку на учетную запись по виду назначения учетной записи.
// Возвращаемое значение:
// УчетнаяЗапись - СправочникСсылка.УчетныеЗаписиЭлектроннойПочты - ссылка на описание учетной записи.
Результат = РаботаСПочтовымиСообщениями.СистемнаяУчетнаяЗапись();
ОтправительEmail = Результат.АдресЭлектроннойПочты;// Выполняет отправку почтовых сообщений.
// Параметры:
// УчетнаяЗапись - СправочникСсылка.УчетныеЗаписиЭлектроннойПочты - ссылка на учетную запись электронной почты.
// ПараметрыПисьма - Структура - содержит всю необходимую информацию о письме:
// * Кому - Массив структур, строка - (обязательный) Интернет адрес получателя письма.
// Адрес - строка - почтовый адрес.
// Представление - строка - имя адресата.
// * ПолучателиСообщения - Массив - массив структур, описывающий получателей:
// * ИсточникКонтактнойИнформации - СправочникСсылка - владелец контактной информации.
// * Адрес - Строка - Почтовый адрес получателя сообщения.
// * Представление - Строка - представление адресата.
// * Копии - Массив - коллекция структур адресов:
// * Адрес - строка - почтовый адрес (должно быть обязательно заполнено).
// * Представление - строка - имя адресата.
// - Строка - интернет адреса получателей письма, разделитель - ";".
// * СлепыеКопии - Массив, Строка - см. описание поля Копии.
// * Тема - Строка - (обязательный) тема почтового сообщения.
// * Тело - Строка - (обязательный) текст почтового сообщения (простой текст в кодировке win-1251).
// * Важность - ВажностьИнтернетПочтовогоСообщения.
// * Вложения - Соответствие - список вложений, где:
// * ключ - Строка - наименование вложения
// * значение - ДвоичныеДанные, АдресВоВременномХранилище - данные вложения;
// - Структура - содержащая следующие свойства:
// * ДвоичныеДанные - ДвоичныеДанные - двоичные данные вложения
// * Идентификатор - Строка - идентификатор вложения, используется для хранения картинок, отображаемых в теле письма.
// * АдресОтвета - Соответствие - см. описание поля Кому.
// * Пароль - Строка - пароль для доступа к учетной записи.
// * ИдентификаторыОснований - Строка - идентификаторы оснований данного письма.
// * ОбрабатыватьТексты - Булево - необходимость обрабатывать тексты письма при отправке.
// * УведомитьОДоставке - Булево - необходимость запроса уведомления о доставке.
// * УведомитьОПрочтении - Булево - необходимость запроса уведомления о прочтении.
// * ТипТекста - Строка, Перечисление.ТипыТекстовЭлектронныхПисем, ТипТекстаПочтовогоСообщения - определяет тип переданного теста допустимые значения:
// HTML/ТипыТекстовЭлектронныхПисем.HTML - текст почтового сообщения в формате HTML.
// ПростойТекст/ТипыТекстовЭлектронныхПисем.ПростойТекст - простой текст почтового сообщения. Отображается "как есть" (значение по умолчанию).
// РазмеченныйТекст/ТипыТекстовЭлектронныхПисем.РазмеченныйТекст - текст почтового сообщения в формате Rich Text.
// Соединение - ИнтернетПочта - существующее соединение с почтовым сервером. Если не указано, то соединение устанавливается в теле функции.
// Возвращает Строка - идентификатор отправленного почтового сообщения на SMTP сервере.
// ПРИМЕЧАНИЕ: функция может вызвать исключение, которое требуется обработать.
Результат = РаботаСПочтовымиСообщениями.ОтправитьПочтовоеСообщение( УчетнаяЗапись, Письма, ТекстОшибки);// Проверяет email адрес на соответствие требованиям стандартов RFC 5321, RFC 5322, а также RFC 5335, RFC 5336 и RFC 3696.
// Кроме того, функция ограничивает использование спецсимволов.
// Параметры:
// Адрес - Строка - проверяемый email.
// РазрешитьЛокальныеАдреса - Булево - не выдавать ошибку в случае отсутствия зоны домена в адресе.
// Возвращает Булево - Истина, если ошибок нет.
Результат = ОбщегоНазначенияКлиентСервер. АдресЭлектроннойПочтыСоответствуетТребованиям(Адрес, РазрешитьЛокальныеАдреса);// Возвращает Истину, если доступна по меньшей мере одна настроенная учетная запись для отправки почты, либо достаточно прав на настройку учетной записи.
Результат = РаботаСПочтовымиСообщениями.ДоступнаОтправкаПисем();// Разбирает строку с адресами электронной почты согласно стандарту RFC 5322 с ограничениями.
// Ограничения:
// 1. В адресе разрешаются только буквы, цифры, символ подчеркивания, дефис и символ "@".
// 2. Символы скобок "[]()" допускаются, но игнорируются путем замены на пробелы.
// 3. Группы запрещены.
// Параметры:
// Строка - Строка - Строка, содержащая электронные адреса (mailbox-list).
// Возвращаемое значение:
// Массив - содержит массив структур адресов.
// Поля структуры:
// Псевдоним - Строка - представление адресата.
// Адрес - Строка - найденный и соответствующий требованиям почтовый адрес;
// Если текст, похожий на адрес найден, но не соответствует требованиям стандартов, то такой текст записывается в поле "Псевдоним".
// ОписаниеОшибки - Строка - текстовое представление ошибки, либо пустая строка, если ошибок нет.
Результат = ОбщегоНазначенияКлиентСервер. АдресаЭлектроннойПочтыИзСтроки(СписокАдресов);
2024-06-28
