ИнтернетПочтовоеСообщение

Типы · InternetMailMessage · интернет почтовое сообщение

Почтовое сообщение (письмо).

Примеры платформы

Письмо = Новый ИнтернетПочтовоеСообщение;
Полное описание, параметры и ограничения

ИнтернетПочтовоеСообщение (InternetMailMessage)

ИнтернетПочтовоеСообщение (InternetMailMessage)

Доступен, начиная с версии 8.1.

Свойства:
АдресаУведомленияОДоставке (DeliveryReceiptAddresses)
АдресаУведомленияОПрочтении (ReadReceiptAddresses)
Важность (Importance)
Вложения (Attachments)
ДатаОтправления (PostingDate)
ДатаПолучения (DateReceived)
Заголовок (Header)
Идентификатор (UID)
ИдентификаторСообщения (MessageID)
ИмяОтправителя (SenderName)
Категории (Categories)
Кодировка (Encoding)
Копии (Cc)
ОбратныйАдрес (ReplyTo)
Организация (Organization)
Отправитель (From)
Получатели (To)
Размер (Size)
СлепыеКопии (Bcc)
СмещениеДатыОтправления (PostingDateOffset)
СпособКодированияНеASCIIСимволов (NonASCIISymbolsEncodingMode)
СтатусРазбора (ParseStatus)
Тексты (Texts)
Тема (Subject)
УведомитьОДоставке (RequestDeliveryReceipt)
УведомитьОПрочтении (RequestReadReceipt)
Частичное (Partial)

Методы:
ОбработатьТексты (ProcessTexts)
ПолучитьИсходныеДанные (GetSourceData)
ПолучитьИсходныйТекст (GetSourceText)
ПолучитьПолеЗаголовка (GetField)
УстановитьИсходныеДанные (SetSourceData)
УстановитьПолеЗаголовка (SetField)

Конструкторы:
По умолчанию

Описание:

Почтовое сообщение (письмо).

Доступность:

Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Сериализуется.

Пример:

Письмо = Новый ИнтернетПочтовоеСообщение;

См. также:
ИнтернетПочта, метод Послать
ИнтернетПочта, метод Выбрать
ИнтернетПочтовыйАдрес, свойство Кодировка
ИнтернетТекстПочтовогоСообщения, свойство Кодировка
ИнтернетПочтовоеВложение, свойство Кодировка
ИнтернетПочтовоеСообщение, свойство ОбратныйАдрес
ИнтернетПочтовоеСообщение, свойство Заголовок
ИнтернетПочтовыеВложения, метод Добавить

Использование в версии:

Доступен, начиная с версии 8.1.

Методическая информация

Практические примеры

Записать и прочитать собственный заголовок X-Guide-Code

В ПолучитьПолеЗаголовка вторым аргументом передаём значение ожидаемого типа — пустую строку, а не Тип("Строка"). Повторная установка заменяет прежнее значение.

Где и как запускать

Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.

Подготовка

  1. В учебной базе выполните код на сервере. Письмо создаётся и разбирается в памяти; профиль почты, пароль, SMTP/IMAP и вызов Послать не нужны.

  2. Все адреса заданы на учебном домене example.invalid. Не заменяйте их реальными адресами и не добавляйте отправку при первой проверке.

  3. Письмо о двух учебных товарах не содержит персональных данных, реальных заказов и внешних HTML-ресурсов. Его текст не является счётом или подтверждением доставки.

Письмо = Новый ИнтернетПочтовоеСообщение;
Письмо.Кодировка = "UTF-8";
Письмо.Отправитель = "guide@example.invalid";
Письмо.ИмяОтправителя = "Учебный магазин";
Письмо.Получатели.Добавить("student@example.invalid");
Письмо.Тема = "Учебные товары";
Письмо.Тексты.Добавить("Книга: 3; Ручка: 1", ТипТекстаПочтовогоСообщения.ПростойТекст);
ИмяПоля = "X-Guide-Code";
НовоеЗначение = "A-01";
Если СтрНайти(НовоеЗначение, Символы.ВК) > 0 Или СтрНайти(НовоеЗначение, Символы.ПС) > 0 Тогда
    ВызватьИсключение "Переносы строк в учебном значении заголовка запрещены";
КонецЕсли;
Письмо.УстановитьПолеЗаголовка(ИмяПоля, НовоеЗначение, СпособКодированияНеASCIIСимволовИнтернетПочтовогоСообщения.MIME);
Сообщить(Письмо.ПолучитьПолеЗаголовка(ИмяПоля, "") = "A-01");
Письмо.УстановитьПолеЗаголовка(ИмяПоля, "B-02");
Сообщить(Письмо.ПолучитьПолеЗаголовка(ИмяПоля, "") = "B-02");
Сообщить(Письмо.Тема = "Учебные товары");

Разбор по шагам

  1. Имя состоит из допустимых ASCII-символов без двоеточия; значение ограничено собственным кодом товара.

  2. УстановитьПолеЗаголовка добавляет пользовательский заголовок, не меняет тему.

  3. Пустая строка во втором аргументе чтения задаёт ожидаемый строковый тип; повторная установка перезаписывает A-01 на B-02.

Как проверить результат

  1. Три сообщения Истина.

  2. Проверка CR/LF выполняется до первой установки значения.

Ожидаемый результат

Установлен и изменён собственный служебный заголовок письма.

На что обратить внимание

  1. Объект письма и успешный разбор MIME не доказывают отправку, доставку, подлинность отправителя или прочтение.

  2. Защита двух переносов в уроке не является универсальной проверкой безопасности произвольных MIME-заголовков.

  3. Не заменяйте пользовательским заголовком обязательные правила адресации, подписи или авторизации.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Разобрать адрес и переименовать учебного получателя

Коллекция Добавить имеет вариант полного адреса и вариант пользователь/сервер. Сервер адреса только читаем, Пользователь допускает изменение.

Где и как запускать

Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.

Подготовка

  1. В учебной базе выполните код на сервере. Письмо создаётся и разбирается в памяти; профиль почты, пароль, SMTP/IMAP и вызов Послать не нужны.

  2. Все адреса заданы на учебном домене example.invalid. Не заменяйте их реальными адресами и не добавляйте отправку при первой проверке.

  3. Письмо о двух учебных товарах не содержит персональных данных, реальных заказов и внешних 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");

Разбор по шагам

  1. Начальную коллекцию очищаем только у собственного объекта письма.

  2. Добавить("student", "example.invalid") создаёт адрес из двух частей; отображаемое имя настраиваем отдельно.

  3. Изменение Пользователь обновляет полный Адрес. Сервер — readonly: не присваиваем его.

Как проверить результат

  1. Шесть сообщений Истина.

  2. Код не проверяет существование почтового ящика и не выполняет DNS-запрос.

Ожидаемый результат

Разделены машинный адрес, пользователь, сервер и подпись получателя.

На что обратить внимание

  1. Объект письма и успешный разбор MIME не доказывают отправку, доставку, подлинность отправителя или прочтение.

  2. Нельзя проверять доставляемость по наличию символа @ или отображаемого имени.

  3. Не переносите учебное изменение пользователя на адресаты рабочих уведомлений.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.