Тип: ИнтернетПочтовыеАдреса. Содержит коллекцию объектов ИнтернетПочтовыйАдрес.
Полное описание, параметры и ограничения
ИнтернетПочтовоеСообщение.Получатели (InternetMailMessage.To)
ИнтернетПочтовоеСообщение (InternetMailMessage)
Получатели (To)
Доступен, начиная с версии 8.0.
Использование:
Только чтение.
Описание:
Тип: ИнтернетПочтовыеАдреса.
Содержит коллекцию объектов ИнтернетПочтовыйАдрес.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Разобрать адрес и переименовать учебного получателя
Коллекция Добавить имеет вариант полного адреса и вариант пользователь/сервер. Сервер адреса только читаем, Пользователь допускает изменение.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
В учебной базе выполните код на сервере. Письмо создаётся и разбирается в памяти; профиль почты, пароль, SMTP/IMAP и вызов Послать не нужны.
Все адреса заданы на учебном домене example.invalid. Не заменяйте их реальными адресами и не добавляйте отправку при первой проверке.
Письмо о двух учебных товарах не содержит персональных данных, реальных заказов и внешних HTML-ресурсов. Его текст не является счётом или подтверждением доставки.
Письмо = Новый ИнтернетПочтовоеСообщение;
Письмо.Кодировка = "UTF-8";
Письмо.Отправитель = "guide@example.invalid";
Письмо.ИмяОтправителя = "Учебный магазин";
Письмо.Получатели.Добавить("student@example.invalid");
Письмо.Тема = "Учебные товары";
Письмо.Тексты.Добавить("Книга: 3; Ручка: 1", ТипТекстаПочтовогоСообщения.ПростойТекст);
Письмо.Получатели.Очистить();
Адресат = Письмо.Получатели.Добавить("student", "example.invalid");
Адресат.ОтображаемоеИмя = "Начинающий разработчик";
Адресат.Кодировка = "UTF-8";
Сообщить(Адресат.Адрес = "student@example.invalid");
Сообщить(Адресат.Пользователь = "student");
Сообщить(Адресат.Сервер = "example.invalid");
Адресат.Пользователь = "learner";
Сообщить(Адресат.Адрес = "learner@example.invalid");
Сообщить(Адресат.ОтображаемоеИмя = "Начинающий разработчик");
Сообщить(Адресат.Кодировка = "UTF-8");Разбор по шагам
Начальную коллекцию очищаем только у собственного объекта письма.
Добавить("student", "example.invalid") создаёт адрес из двух частей; отображаемое имя настраиваем отдельно.
Изменение Пользователь обновляет полный Адрес. Сервер — readonly: не присваиваем его.
Как проверить результат
Шесть сообщений Истина.
Код не проверяет существование почтового ящика и не выполняет DNS-запрос.
Ожидаемый результат
Разделены машинный адрес, пользователь, сервер и подпись получателя.
На что обратить внимание
Объект письма и успешный разбор MIME не доказывают отправку, доставку, подлинность отправителя или прочтение.
Нельзя проверять доставляемость по наличию символа @ или отображаемого имени.
Не переносите учебное изменение пользователя на адресаты рабочих уведомлений.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Прикрепить собственное письмо как вложенное сообщение
Перегрузка Добавить принимает ИнтернетПочтовоеСообщение, а Данные вложения могут быть письмом или двоичными данными. Тип проверяем до чтения Тема.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
В учебной базе выполните код на сервере. Письмо создаётся и разбирается в памяти; профиль почты, пароль, SMTP/IMAP и вызов Послать не нужны.
Все адреса заданы на учебном домене example.invalid. Не заменяйте их реальными адресами и не добавляйте отправку при первой проверке.
Письмо о двух учебных товарах не содержит персональных данных, реальных заказов и внешних HTML-ресурсов. Его текст не является счётом или подтверждением доставки.
Письмо = Новый ИнтернетПочтовоеСообщение;
Письмо.Кодировка = "UTF-8";
Письмо.Отправитель = "guide@example.invalid";
Письмо.ИмяОтправителя = "Учебный магазин";
Письмо.Получатели.Добавить("student@example.invalid");
Письмо.Тема = "Учебные товары";
Письмо.Тексты.Добавить("Книга: 3; Ручка: 1", ТипТекстаПочтовогоСообщения.ПростойТекст);
Внутреннее = Новый ИнтернетПочтовоеСообщение;
Внутреннее.Отправитель = "guide@example.invalid";
Внутреннее.Получатели.Добавить("mentor@example.invalid");
Внутреннее.Тема = "Учебное пояснение";
Внутреннее.Тексты.Добавить("Количество книги равно 3", ТипТекстаПочтовогоСообщения.ПростойТекст);
Вложение = Письмо.Вложения.Добавить(Внутреннее, "explanation.eml");
Вложение.ТипСодержимого = "message/rfc822";
ДанныеВложения = Письмо.Вложения.Получить(0).Данные;
Если ТипЗнч(ДанныеВложения) <> Тип("ИнтернетПочтовоеСообщение") Тогда
ВызватьИсключение "Для этой перегрузки ожидался собственный объект письма";
КонецЕсли;
Сообщить(ДанныеВложения.Тема = "Учебное пояснение");
Сообщить(Письмо.Тема = "Учебные товары");
Сообщить(Письмо.Вложения.Количество() = 1);Разбор по шагам
Внутреннее письмо тоже полностью собственное и не отправлено.
Добавить получает объект письма, не путь к существующему EML.
Проверяем тип Данные перед обращением к Тема. MIME-roundtrip этого вложения здесь не выполнялся.
Как проверить результат
Три сообщения Истина: внутренняя тема, внешняя тема, одно вложение.
Внешнее и внутреннее письма не перепутаны; файлов explanation.eml на диске нет.
Ожидаемый результат
Прикреплено собственное письмо с отдельной темой и текстом.
На что обратить внимание
Объект письма и успешный разбор MIME не доказывают отправку, доставку, подлинность отправителя или прочтение.
После разбора входного MIME представление Данные может отличаться: всегда проверяйте фактический тип.
Вложенный From не подтверждает происхождение внешнего письма.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.