Тип: Строка. Идентификатор вложения.
Полное описание, параметры и ограничения
ИнтернетПочтовоеВложение.Идентификатор (InternetMailAttachment.CID)
ИнтернетПочтовоеВложение (InternetMailAttachment)
Идентификатор (CID)
Доступен, начиная с версии 8.0.
Использование:
Чтение и запись.
Описание:
Тип: Строка.
Идентификатор вложения.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Используется для сопоставления данных вложения с текстом письма.
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Прикрепить JSON в памяти и прочитать собственные байты
Вложения.Добавить принимает ДвоичныеДанные. Имя вложения — имя для почтового клиента, а не разрешение записывать файл по этому пути.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
В учебной базе выполните код на сервере. Письмо создаётся и разбирается в памяти; профиль почты, пароль, SMTP/IMAP и вызов Послать не нужны.
Все адреса заданы на учебном домене example.invalid. Не заменяйте их реальными адресами и не добавляйте отправку при первой проверке.
Письмо о двух учебных товарах не содержит персональных данных, реальных заказов и внешних HTML-ресурсов. Его текст не является счётом или подтверждением доставки.
Письмо = Новый ИнтернетПочтовоеСообщение;
Письмо.Кодировка = "UTF-8";
Письмо.Отправитель = "guide@example.invalid";
Письмо.ИмяОтправителя = "Учебный магазин";
Письмо.Получатели.Добавить("student@example.invalid");
Письмо.Тема = "Учебные товары";
Письмо.Тексты.Добавить("Книга: 3; Ручка: 1", ТипТекстаПочтовогоСообщения.ПростойТекст);
JSON = "{""code"":""A-01"",""quantity"":3}";
БайтыJSON = ПолучитьДвоичныеДанныеИзСтроки(JSON, КодировкаТекста.UTF8, Ложь);
Вложение = Письмо.Вложения.Добавить(БайтыJSON, "products.json");
Вложение.Имя = "products.json";
Вложение.Кодировка = "UTF-8";
Вложение.ТипСодержимого = "application/json";
Вложение.СпособКодирования = СпособКодированияИнтернетПочтовогоВложения.MIME;
Вложение.Идентификатор = "products@guide";
Сообщить(Письмо.Вложения.Количество() = 1);
Сообщить(Вложение.Имя = "products.json");
Сообщить(Вложение.Кодировка = "UTF-8");
Сообщить(Вложение.ТипСодержимого = "application/json");
Сообщить(Вложение.СпособКодирования = СпособКодированияИнтернетПочтовогоВложения.MIME);
Сообщить(Вложение.Идентификатор = "products@guide");
Сообщить(ПолучитьСтрокуИзДвоичныхДанных(Вложение.Данные, КодировкаТекста.UTF8) = JSON);
Сообщить("ИмяФайла, сообщённое платформой: " + Вложение.ИмяФайла);Разбор по шагам
Собственный JSON преобразуем в UTF-8 без BOM и передаём двоичные данные.
MIME-тип и кодировка задаются отдельно; способ MIME не является шифрованием.
Проверяем байты обратным преобразованием. ИмяФайла только выводим, не присваиваем и не используем для записи на диск.
Как проверить результат
Семь сравнений Истина; диагностическая строка ИмяФайла может зависеть от способа добавления.
Файл products.json на диске не создавался.
Ожидаемый результат
Одно JSON-вложение создано без файловой системы и отправки.
На что обратить внимание
Объект письма и успешный разбор MIME не доказывают отправку, доставку, подлинность отправителя или прочтение.
MIME-кодирование не защищает данные от прочтения третьими лицами.
Имя и MIME-тип неизвестного вложения не доказывают его фактический формат или безопасность.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Связать собственную HTML-картинку с вложением через cid
Знак SVG задан прямо в коде без внешних ресурсов. Идентификатор вложения сопоставляется cid-ссылке, не HTTP-адресу.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
В учебной базе выполните код на сервере. Письмо создаётся и разбирается в памяти; профиль почты, пароль, SMTP/IMAP и вызов Послать не нужны.
Все адреса заданы на учебном домене example.invalid. Не заменяйте их реальными адресами и не добавляйте отправку при первой проверке.
Письмо о двух учебных товарах не содержит персональных данных, реальных заказов и внешних HTML-ресурсов. Его текст не является счётом или подтверждением доставки.
Письмо = Новый ИнтернетПочтовоеСообщение;
Письмо.Кодировка = "UTF-8";
Письмо.Отправитель = "guide@example.invalid";
Письмо.ИмяОтправителя = "Учебный магазин";
Письмо.Получатели.Добавить("student@example.invalid");
Письмо.Тема = "Учебные товары";
Письмо.Тексты.Добавить("Книга: 3; Ручка: 1", ТипТекстаПочтовогоСообщения.ПростойТекст);
SVG = "<svg xmlns=""http://www.w3.org/2000/svg"" width=""32"" height=""32"" viewBox=""0 0 32 32""><rect width=""32"" height=""32"" rx=""6"" fill=""#146e32""/><path d=""M8 16l5 5 11-12"" fill=""none"" stroke=""white"" stroke-width=""3""/></svg>";
БайтыЗнака = ПолучитьДвоичныеДанныеИзСтроки(SVG, КодировкаТекста.UTF8, Ложь);
Знак = Письмо.Вложения.Добавить(БайтыЗнака, "guide-mark.svg");
Знак.ТипСодержимого = "image/svg+xml";
Знак.Идентификатор = "guide-mark@guide";
HTML = Письмо.Тексты.Добавить("<p>Товары подготовлены <img src=""cid:guide-mark@guide"" alt=""Учебный знак""></p>", ТипТекстаПочтовогоСообщения.HTML);
Сообщить(СтрНайти(HTML.Текст, "cid:" + Знак.Идентификатор) > 0);
Сообщить(Знак.ТипСодержимого = "image/svg+xml");
Сообщить(ПолучитьСтрокуИзДвоичныхДанных(Знак.Данные, КодировкаТекста.UTF8) = SVG);Разбор по шагам
SVG содержит только собственные фигуры и цвета, без script, внешнего href и скачивания.
Идентификатор guide-mark@guide связываем с src="cid:guide-mark@guide".
Проверяем связь в строке и собственные байты, не открывая HTML и не отправляя письмо.
Как проверить результат
Три сообщения Истина.
Рендеринг SVG в конкретном почтовом клиенте не проверен и не обещается.
Ожидаемый результат
Создана внутренняя связь собственной картинки и HTML-части письма.
На что обратить внимание
Объект письма и успешный разбор MIME не доказывают отправку, доставку, подлинность отправителя или прочтение.
Многие клиенты ограничивают SVG: для реальной рассылки нужен проверенный поддерживаемый формат.
Этот собственный SVG не является разрешением открывать недоверенные активные вложения.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.