Приклади роботи з функціями надсилання повідомлень до БСП 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
