Documentation – Робота з MIME повідомленнями

Python-Net: Створення та керування листами

Mon, 01 Jan 0001 00:00:00 +0000

Створення нового листа

The MailMessage клас представляє повідомлення електронної пошти та дозволяє розробникам створювати нові листи. Основні властивості листа, такі як From, To, Subject і body, можна легко приєднати до щойно створеного листа. Аналогічно, ми можемо зберігати лист у різних форматах, таких як EML, MSG і MHTML.

Створіть екземпляр MailMessage клас.
Встановіть властивості листа.
Збережіть лист у різних форматах.

Наступний фрагмент коду показує, як створити новий лист з різними властивостями.

Вказування декількох отримувачів

The MailMessage об’єкт представляє лист. Екземпляри MailMessage клас використовується для створення листів, які передаються до SMTP‑серверу за допомогою SmtpClient клас. У цій статті продемонстровано, як вказати більше однієї електронної адреси. Адреси можна задавати за допомогою MailMessage клас. Вони:

To — Адреси отримувачів можна вказати у полі ‘To’. Одержувачі в полі ‘To’ є основною аудиторією повідомлення. Може бути більше однієї адреси отримувача.
Cc – CC означає «копія», або «ввічлива копія», і дозволяє додати отримувачів листа, які повинні його бачити, але не обов’язково повинні діяти за ним. Наприклад, менеджери чи члени вашої команди, яким потрібно бути в курсі розмови. За допомогою Aspose.Email можна вказати адреси CC у вашому коді. Таким чином, автоматичні листи або всі листи на певну адресу можуть копіюватися відповідальним особам.
Bcc – Bcc (прихована копія) дозволяє надсилати лист отримувачу, який прихований від інших отримувачів. Там, де CC з’являється в інформації листа, яку бачать головні отримувачі, Bcc не відображається. Це призначено для прихованого сповіщення.

Щоб вказати декілька електронних адрес у листі, виконайте такі кроки:

Створіть екземпляр MailMessage клас.
Вкажіть адресу From та кілька адрес To, Cc і Bcc за допомогою MailMessage екземпляр.
Створіть екземпляр SmtpClient клас і надішліть лист, використовуючи метод Send.

Нижче наведений зразок коду показує, як можна вказати декілька адрес To, CC та BCC.

Встановлення імен відображення відправника та отримувача

Нижче наведені програмні приклади демонструють, як змінити електронні адреси на дружні імена у листі. Дружнє ім’я – це назва, більш зрозуміла людям, ніж електронна адреса, наприклад John Smith замість js346@domain.com. При надсиланні листа ми можемо асоціювати дружнє ім’я з електронною адресою у MailMessage конструктор класу.

Щоб змінити електронні адреси на дружні імена у листі, виконайте такі кроки:

Створіть екземпляр MailMessage клас і задайте електронні адреси у полях To і From разом із дружніми іменами.
Вкажіть електронні адреси Cc і Bcc разом із дружніми іменами, викликавши MailMessage конструктор класу в MailMessage екземпляр.
Створіть екземпляр SmtpClient клас і надішліть лист, використовуючи Надіслати метод.

Нижче наведений фрагмент коду показує, як відображати імена для електронних адрес.

Встановлення теми листа

The MailMessage клас дозволяє вказати короткий виклад вмісту повідомлення за допомогою тема властивість. Наступний приклад коду демонструє, як створити лист і встановити його тему:

from aspose.email import MailMessage

# Create a new email message
message = MailMessage()

# Set the subject of the email
message.subject = "Meeting Reminder: Project Update"

# Set other email properties (optional)
message.from_address = "sender@example.com"
message.to.append("recipient@example.com")
message.body = "This is a reminder for the upcoming project update meeting."

# Print the email details
print(f"Subject: {message.subject}")
print(f"From: {message.from_address}")
print(f"To: {', '.join(message.to)}")
print(f"Body: {message.body}")

Встановлення тіла листа

Крім теми повідомлення, тіло листа можна вказати за допомогою того ж MailMessage клас. Лист може мати кілька тіл. У цьому класі є два типи тіл листа:

HTML‑тіло
Текстове тіло

На додаток до HtmlBody і TextBody, у Aspose.Email є ще дві лише для читання властивості, пов’язані з тілом листа:

IsBodyText: вказує користувачеві, чи є тіло текстовим.
IsBodyHtml: повідомляє користувачеві, чи є тіло HTML чи звичайним текстом.

У цій статті показано, як визначити простий текст або HTML‑текст тіла, задати альтернативний текст і закодувати тіло листа.

Встановлення HTML‑тіла

Html body використовується для вказання HTML‑вмісту тіла повідомлення. Html body має бути обгорнутий тегами . Наступний фрагмент коду показує, як встановити HTML body.

Встановлення альтернативного тексту

Використайте AlternateView клас для вказання копій листа у різних форматах. Наприклад, якщо ви надсилаєте лист у HTML, ви можете також надати текстову версію, на випадок якщо деякі отримувачі використовують поштові програми, що не вміють відображати HTML. У цього класу є дві властивості, linked_resources і base_uri, які використовуються для розв’язання URL‑адрес у вмісті листа.

LinkedResources — це колекція об’єктів LinkedResources. При рендерингу URL‑и у вмісті листа спочатку зіставляються з URL‑ами у Content Link кожного об’єкта LinkedResources у колекції LinkedResources та розв’язуються.
BaseUri використовується читачем листа для розв’язання відносних URL-адрес у тілі, а також для розв’язання відносних URL‑посилань на контент у колекції LinkedResources.

Нижче наведений фрагмент коду показує, як задати альтернативний текст.

Функції MailMessage

The MailMessage class представляє вміст електронного листа. Екземпляри the MailMessage class використовується для створення електронного листа, який передається SMTP‑серверу для доставки за допомогою the SmtpClient class. У цій статті показано, як використовувати MailMessage class містить утилітні функції для керування наступними можливостями електронної пошти:

Date and time - Через the MailMessage Власність class Date дозволяє отримувати або встановлювати дату та час електронного листа.
Пріоритет повідомлення – MailPriority клас визначає рівні пріоритету для відправки електронного листа. Він може бути низьким, звичайним або високим. Пріоритет впливає на швидкість передачі та доставку.
Чутливість повідомлення – MailSensitivity клас визначає п’ять рівнів чутливості.
Повідомлення про доставку – Повідомлення про доставку інформують відправників про те, що їх лист було доставлено у вхідні повідомлення одержувача.

За замовчуванням, дата – це фактична дата, коли повідомлення було надіслано, а час – час його відправки, як відображає Microsoft Outlook. Однак реальний час доставки електронної пошти додається самим SMTP‑сервером у заголовку листа. Наприклад, нижче наведено типовий заголовок листа, у якому поле Date задає дату.

import aspose.email as ae
from aspose.email import MailMessage

# Create a new MailMessage instance
message = MailMessage()

# Add SMTP headers to the message
message.headers.add("Received", "from ip-123.56.99.216.dsl-cust.ca.inter.net ([216.99.56.123]) by Aspose.secureserver.net with MailEnable ESMTP; Thu, 22 Feb 2007 13:58:57 -0700")
message.headers.add("Return-Path", "<xyz@oikoscucine.it>")
message.headers.add("Received", "from 195.120.225.20 (HELO mail.oikoscucine.it) by aspose.com with esmtp (:1CYY+<LA*- *1WK@) id Q8,/O/-.N83@7-9M for abc@aspose.com; Thu, 22 Feb 2007 20:58:51 +0300")

# Set email details
message.from_address = "XYZ <xyz@oikoscucine.it>"
message.to.append("abc@aspose.com")
message.subject = "For ABC"
message.date = "Thu, 22 Feb 2007 20:58:51 +0300"
message.message_id = "<01c756c4$41b554d0$6c822ecf@dishonestyinsufferably>"
message.headers.add("MIME-Version", "1.0")
message.headers.add("Content-Type", "multipart/alternative; boundary=\"----=_NextPart_000_0006_01C7569A.58DF4CD0\"")
message.headers.add("X-Mailer", "Microsoft Office Outlook, Build 11.0.5510")
message.headers.add("X-MimeOLE", "Produced By Microsoft MimeOLE V6.00.2800.1106")
message.headers.add("Thread-Index", "Aca6Q:=ES0M(9-=(<.<1.<Q9@QE6CD==")
message.headers.add("X-Read", "1")

# Save the message as an EML file
message.save("output.eml", ae.EmlSaveOptions())

Нижче наведений фрагмент коду ілюструє, як можна використовувати кожну з описаних вище функцій.

import aspose.email as ae
from aspose.email import MailMessage, MailPriority, MailSensitivity
from datetime import datetime

# Create a new MailMessage instance
message = MailMessage("sender@gmail.com", "receiver@gmail.com", "Some subject", "Some body text")

# Set additional properties
message.date = datetime.now()
message.priority = MailPriority.HIGH
message.sensitivity = MailSensitivity.NORMAL
message.headers.add("X-Mailer", "Aspose.Email")

# Save the message as an EML file
message.save("output.eml", ae.EmlSaveOptions())

Запит підтвердження прочитання

Нижче наведені програмні приклади, які показують, як можна запросити підтвердження прочитання. The MailMessage клас DeliveryNotificationOptions Властивість Enumeration описує параметри повідомлення про доставку електронного листа. Щоб запросити підтвердження прочитання після відправлення листа, виконайте такі кроки:

Створіть екземпляр MailMessage клас.
Вкажіть відправника, отримувача та HTML‑тіло листа у MailMessage екземпляр.
Вкажіть DeliveryNotificationOptions в інших MailMessage екземпляри.
Створіть екземпляр SmtpClient клас та надішліть лист за допомогою методу Send.

Запити на підтвердження прочитання можуть не завжди виконуватись, бо:

Клієнт електронної пошти може не реалізовувати цю функцію.
У кінцевого користувача ця функція може бути вимкнена.
Кінцевий користувач може вирішити не надсилати його.

Нижче наведений фрагмент коду показує, як запросити підтвердження прочитання.

import aspose.email as ae
from aspose.email import MailMessage, SmtpClient, DeliveryNotificationOptions

# Create an instance of MailMessage class
message = MailMessage()

# Specify From, To, HtmlBody, and DeliveryNotificationOptions
message.from_address = "sender@sender.com"
message.to.append("receiver@receiver.com")
message.html_body = "<html><body>This is the Html body</body></html>"
message.delivery_notification_options = DeliveryNotificationOptions.ON_SUCCESS

message.headers.add("Return-Receipt-To", "sender@sender.com")
message.headers.add("Disposition-Notification-To", "sender@sender.com")

# Create an instance of SmtpClient class
client = SmtpClient()

# Specify your mailing host server, Username, Password, and Port
client.host = "smtp.server.com"
client.username = "Username"
client.password = "Password"
client.port = 25

try:
    # Client.send will send this message
    client.send(message)
    # Display 'Message sent' only if the message is sent successfully
    print("Message sent")
except Exception as ex:
    import traceback
    traceback.print_exc()

Встановити заголовки листа

Заголовки листа відповідають інтернет-стандарту, а RFC визначають поля заголовків, які включаються до інтернет‑повідомлень електронної пошти. Заголовок листа можна вказати за допомогою класу MailMessage. Типові типи заголовків визначені у класі HeaderType. Це запечатаний клас, що працює як звичайне перерахування.

Зазвичай заголовок електронного листа містить ці поля:

To: Адреси отримувачів можна вказати у полі To. Ці отримувачі є основною аудиторією листа. Може бути більше однієї адреси отримувача.
From: Це поле містить електронну адресу відправника повідомлення.
Cc: Дозволяє користувачам надсилати повідомлення як "Carbon Copy" (копія) або "Courtesy Copy" (пристор). Тобто, від отримувача не очікується відповіді або дії. Зазвичай, це використовується для інформування керівного персоналу.
Bcc: Означає Blind Carbon Copy, практику надсилання повідомлення декільком отримувачам так, щоб отримувані листи не містили повного списку одержувачів. Призначено для прихованих сповіщень.
ReplyTo: Це поле заголовка призначене вказати, куди відправник хоче отримувати відповіді.
Subject: Заголовок, назва, тема. Часто використовується як індикатор теми для повідомлень у відповідях чи коментарях.
Date: Цей заголовок вказує дату (і час). Зазвичай це дата, коли повідомлення було складено та надіслано.
XMailer: Інформація про клієнтське програмне забезпечення відправника. Приклад: X-Mailer: Aspose.Email. XMailer використовується поштовими клієнтами. Різні клієнти мають різні значення XMailer. Значення XMailer у MS Outlook – Microsoft Office Outlook, Build 11.0.5510. Воно ігнорується отримувачем листа або поштовим клієнтом.

Зазвичай заголовок електронного листа виглядає приблизно так:


Reply-To: reply@reply.com

From: sender@sender.com

To: guangzhou@guangzhoo.com

Subject: test mail

Date: 6 Mar 2006 8:2:2 +0800

X-Mailer: Aspose.Email

Щоб налаштувати заголовок електронного листа, виконайте такі кроки:

Створіть екземпляр MailMessage клас.
Вкажіть To, From, CC, Bcc, ReplyTo, Subject, Date та XMailer, використовуючи екземпляр MailMessage.
Створіть екземпляр MimeHeader клас і вкажіть секретний заголовок.
Додайте секретний заголовок до MailMessage екземпляр.

Наступний фрагмент коду показує, як встановити заголовки листа.

import aspose.email as ae
from aspose.email import MailMessage
from datetime import datetime

# Create an instance of MailMessage class
message = MailMessage()

# Specify email details
message.reply_to_list.append("reply@reply.com")
message.from_address = "sender@sender.com"
message.to.append("receiver1@receiver.com")
message.cc.append("receiver2@receiver.com")
message.bcc.append("receiver3@receiver.com")
message.subject = "test mail"
message.date = datetime(2006, 3, 6)
message.headers.add("X-Mailer", "Aspose.Email")

Наведений вище фрагмент коду створює заголовок листа у такому форматі. Це можна спостерігати, відкривши отриманий файл "MsgHeaders.msg" у Microsoft Outlook і переглянувши його властивості.


Reply-To: reply@reply.com

From: sender@sender.com

To: receiver1@receiver.com

CC: receiver2@receiver.com

BCC: receiver3@receiver.com

Subject: test mail

Date: 6 Mar 2006 8:2:2 +0800

X-Mailer: Aspose.Email

secret-header: mystery

Вставити заголовок у конкретному місці

The Додати метод HeadersCollection клас вставляє заголовок у кінець колекції. Однак іноді може бути необхідно вставити заголовок у певне місце. У такому випадку, Додати метод не допоможе. Щоб досягти цього, використайте Insert метод HeadersCollection. Якщо колекція містить заголовки з однаковою назвою, цей заголовок буде вставлений перед іншими заголовками з такою ж назвою.

Наступний фрагмент коду показує, як вставити заголовок у певному місці.

# Insert a header into the MailMessage instance
message.headers.insert("Received", "Value")

Додавання власних заголовків до листа

Нижче наведений приклад коду демонструє, як вказати користувацький заголовок у листі за допомогою MailMessage клас.

# Add a header into the MailMessage instance
message.headers.add("secret-header", "mystery")

Наведений вище фрагмент коду створює заголовок листа у такому форматі:

secret-header: mystery

Python-Net: Видобуток інформації з електронного листа

Mon, 01 Jan 0001 00:00:00 +0000

Відображення метаданих листа

The MailMessage представляє електронний лист і дозволяє розробникам отримувати доступ до його властивостей. Інформацію заголовка можна видобувати та маніпулювати нею різними способами. У цій статті пояснюється, як відобразити обрану інформацію заголовка листа та його тіло на екрані. Щоб відобразити інформацію листа на екрані, виконайте такі кроки:

Створіть екземпляр MailMessage клас.
Завантажте електронний лист у the MailMessage екземпляр.
Відобразіть вміст електронного листа на екрані.

Наведений нижче фрагмент коду показує, як відобразити інформацію про лист на екрані:

Витягування заголовків електронної пошти

Заголовок електронного листа представляє набір стандартних полів, визначених Інтернетом та RFC, що включаються до листів. Заголовок листа можна задати за допомогою класу MailMessage. Типові типи заголовків визначені у the HeaderType class. Це запечатаний клас, який працює як типове перерахування. Щоб видобути заголовки з листа, виконайте такі кроки:

Створіть екземпляр MailMessage клас.
Завантажте електронний лист у екземпляр the MailMessage клас.
Після завантаження електронного листа ми отримуємо його необроблений вміст.

The MailMessage class сам по собі містить властивості, такі як From, To, Cc, Subject тощо. Ці властивості можна видобути із заголовків.

Наведений нижче фрагмент коду показує, як видобути заголовки листа:

Декодування значень заголовків

Наведений нижче фрагмент коду показує, як отримати декодовані значення заголовків.

Python-Net: Завантаження, збереження та конвертація листів

Mon, 01 Jan 0001 00:00:00 +0000

Виявлення форматів електронної пошти

Aspose.Email API надає можливість визначити формат файлу наданого повідомлення. The DetectFileFormat метод FileFormatUtil Клас можна використати для досягнення цього. Наступні класи та методи можна використати для визначення формату завантаженого файлу:

Перелічення FileFormatType
Клас FileFormatInfo
Клас FileFormatUtil
Метод detect_file_format(stream)
Метод detect_file_format(file_path)

Наведений нижче фрагмент коду показує, як виявити формати файлів:

from aspose.email.tools import FileFormatUtil

# Detect file format and get the detected load format
info = FileFormatUtil.detect_file_format(data_dir + "message.msg")
print("The message format is: " + str(info.file_format_type))

Завантаження повідомлення з параметрами завантаження

Наведений нижче фрагмент коду показує, як завантажити повідомлення з параметрами завантаження.

from aspose.email import MailMessage, EmlLoadOptions, HtmlLoadOptions, MhtmlLoadOptions, MsgLoadOptions

# Load Eml, html, mhtml, msg, and dat files
mail_message = MailMessage.load(data_dir + "message.eml", EmlLoadOptions())
MailMessage.load(data_dir + "description.html", HtmlLoadOptions())
MailMessage.load(data_dir + "message.mhtml", MhtmlLoadOptions())
MailMessage.load(data_dir + "message.msg", MsgLoadOptions())

# Loading with custom options
eml_load_options = EmlLoadOptions()
eml_load_options.preferred_text_encoding = "utf-8"
eml_load_options.preserve_tnef_attachments = True

MailMessage.load(data_dir + "description.html", eml_load_options)

html_load_options = HtmlLoadOptions()
html_load_options.preferred_text_encoding = "utf-8"
html_load_options.should_add_plain_text_view = True
html_load_options.path_to_resources = data_dir

MailMessage.load(data_dir + "description.html", html_load_options)

Збереження формату вбудованих повідомлень під час завантаження

from aspose.email import MailMessage, EmlLoadOptions, HtmlLoadOptions, MhtmlLoadOptions, MsgLoadOptions
from aspose.email.tools import FileFormatUtil

eml_load_options = EmlLoadOptions()
eml_load_options.preserve_embedded_message_format = True

mail = MailMessage.load(data_dir + "message.eml", eml_load_options)

file_format = FileFormatUtil.detect_file_format(mail.attachments[0].content_stream).file_format_type

print("Embedded message file format: " + str(file_format))

Збереження та конвертація листів

Aspose.Email спрощує конвертацію будь‑якого типу повідомлення в інший формат. Щоб продемонструвати цю можливість, код у цій статті завантажує три типи повідомлень з диска та зберігає їх у інших форматах. Базовий клас SaveOptions і класи EmlSaveOptions, MsgSaveOptions, MhtSaveOptions, HtmlSaveOptions може бути використано для додаткових налаштувань при збереженні листів у інших форматах. У статті показано, як використати ці класи для збереження прикладного листа у вигляді:

EML‑формат.
Outlook MSG.
MHTML‑формат.
HTML‑формат.

Збереження у EML

Наведений нижче фрагмент коду показує, як завантажити повідомлення EML і зберегти його на диск у тому ж форматі.

from aspose.email import MailMessage, SaveOptions

# Initialize and Load an existing EML file by specifying the MessageFormat
mail_message = MailMessage.load(data_dir + "message.eml")

mail_message.save(data_dir + "LoadAndSaveFileAsEML_out.eml", SaveOptions.default_eml)

Збереження меж у файлах EML

Наведений нижче фрагмент коду показує, як завантажити файл EML та зберегти його у тому ж форматі, зберігаючи оригінальні межі.

from aspose.email import MailMessage, EmlSaveOptions, MailMessageSaveType

mail_message = MailMessage.load(data_dir + "message.eml")

# Save as eml with preserved original boundaries
eml_save_options = EmlSaveOptions(MailMessageSaveType.eml_format)

mail_message.save(data_dir + "PreserveOriginalBoundaries_out.eml", eml_save_options)

Налаштування рядків меж MIME

Aspose.Email для .NET дозволяє налаштувати шаблон меж, що використовується у MIME‑повідомленнях. Це досягається через the boundaries_template властивість EmlSaveOptions клас.

Встановивши власний шаблон, ви можете визначити, як генеруються межі MIME. Шаблонний символ {#} буде замінено інкрементальним номером межі, що дозволяє створювати динамічні та читабельні рядки меж.

Якщо boundaries_template не встановлено (за замовчуванням None), бібліотека використовує свій внутрішній формат меж.

Наведений нижче приклад коду показує, як налаштувати рядки меж MIME під час збереження електронного листа у формат .eml:

import aspose.email as ae

# Create a sample MailMessage
message = ae.MailMessage()
message.subject = "Custom MIME Boundary"
message.body = "This message uses a custom MIME boundary template."
message.to.append(ae.MailAddress("recipient@example.com"))

# Configure save options with a custom boundary template
save_options = ae.EmlSaveOptions(ae.MailMessageSaveType.EML_FORMAT)
save_options.boundaries_template = "boundary--{#}"

# Save the message to .eml with custom boundaries
message.save("Custom_Boundary_Message.eml", save_options)

Ось приклад структури повідомлення з користувацькими межами, збереженими за допомогою коду, наведеного вище:

From: sender@example.com  
To: recipient@example.com  
Subject: Custom_Boundary_Message  
Date: Fri, 27 Dec 2024 12:00:00 +0000
Content-Type: multipart/mixed;
 boundary="boundary--1"

This is a multi-part message in MIME format.

--boundary--1
Content-Type: multipart/alternative; boundary="boundary--2"


--boundary--2
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: quoted-printable

Content-Type: text/plain; charset="us-ascii"

This is the plain text content of the email.


--boundary--2
Content-Type: text/html; charset="windows-1251"
Content-Transfer-Encoding: quoted-printable

<html>
  <body>
    <p>This is the <b>HTML</b> content of the email.</p>
  </body>
</html>

--boundary--2--

--boundary--1
Content-Type: application/octet-stream; name="report-2023-08.xlsx"
Content-Transfer-Encoding: base64
Content-Disposition: attachment; filename="report-2023-08.xlsx"

UEsDBBQABgAIAAAAIQBi7...

--boundary--1--

Збереження TNEF‑вкладень у файлах EML

Наведений нижче фрагмент коду показує, як зберегти файл EML, зберігаючи TNEF‑вкладення.

from aspose.email import MailMessage, EmlSaveOptions, MailMessageSaveType, FileCompatibilityMode

mail_message = MailMessage.load(data_dir + "message.eml")

# Save as eml with preserved attachment
eml_save_options = EmlSaveOptions(MailMessageSaveType.eml_format)
eml_save_options.file_compatibility_mode = FileCompatibilityMode.PRESERVE_TNEF_ATTACHMENTS

mail_message.save(data_dir + "PreserveTNEFAttachment_out.eml", eml_save_options)

Збереження у MSG

Наведений нижче фрагмент коду показує, як завантажити повідомлення EML і конвертувати його у MSG, використовуючи відповідну опцію з the SaveOptions.

from aspose.email import MailMessage, SaveOptions, MailMessageSaveType, FileCompatibilityMode

# Initialize and Load an existing EML file by specifying the MessageFormat
eml = MailMessage.load(data_dir + "message.eml")

# Save the Email message to disk in ASCII format and Unicode format
eml.save(data_dir + "AnEmail_out.msg", SaveOptions.default_msg_unicode)

Збереження дат у файлах MSG

The MsgSaveOptions class дозволяє зберегти вихідне повідомлення у файл Outlook Message (MSG), зберігаючи дати. Наведений нижче фрагмент коду показує, як зберегти файл EML як MSG та зберегти дати.

from aspose.email import MailMessage, MsgSaveOptions, MailMessageSaveType, FileCompatibilityMode

# Initialize and Load an existing EML file by specifying the MessageFormat
eml = MailMessage.load(data_dir + "message.eml")

# Save as msg with preserved dates
msg_save_options = MsgSaveOptions(MailMessageSaveType.outlook_message_format_unicode)
msg_save_options.preserve_original_dates = True

eml.save(data_dir + "outTest_out.msg", msg_save_options)

Збереження у MHTML

Різні параметри MHTML можна використати для досягнення потрібних результатів. Наступний фрагмент коду показує, як завантажити EML‑повідомлення у MailMessage і конвертувати його у MHTML.

from aspose.email import MailMessage, SaveOptions, MailMessageSaveType, FileCompatibilityMode

# Initialize and Load an existing EML file by specifying the MessageFormat
eml = MailMessage.load(data_dir + "message.eml")

eml.save(data_dir + "AnEmail_out.mhtml", SaveOptions.default_mhtml)

Користувацькі налаштування конвертації MHTML

The MhtSaveOptions клас надає додаткові параметри для збереження електронних листів у формат MHTML. Перелічувач MhtFormatOptions дає можливість записати додаткову інформацію листа у вихідний MHTML. Можна записати наступні додаткові поля:

NONE – Не вказано жодних конкретних налаштувань.
WRITE_HEADER – вказує, що інформація заголовка має бути записана.
WRITE_OUTLINE_ATTACHMENTS – вказує, що повинні бути записані контурні (outline) вкладення.
WRITE_COMPLETE_EMAIL_ADDRESS – вказує, що повна електронна адреса має бути записана у всі заголовки листа.
NO_ENCODE_CHARACTERS – вказує, що не слід використовувати кодування передачі символів.
HIDE_EXTRA_PRINT_HEADER – вказує, що PageHeader буде невидимим.
WRITE_COMPLETE_TO_EMAIL_ADDRESS – вказує, що повна електронна адреса має бути записана у заголовок ‘To’.
WRITE_COMPLETE_FROM_EMAIL_ADDRESS – вказує, що повна електронна адреса має бути записана у заголовок ‘From’.
WRITE_COMPLETE_CC_EMAIL_ADDRESS – вказує, що повна електронна адреса має бути записана у заголовок ‘Cc’.
WRITE_COMPLETE_BCC_EMAIL_ADDRESS – вказує, що повна електронна адреса має бути записана у заголовок ‘Bcc’.
RENDER_CALENDAR_EVENT – вказує, що текст події календаря має бути записаний у вихідному mhtml.
SKIP_BYTE_ORDER_MARK_IN_BODY – вказує, що байти маркера порядку байтів (BOM) мають бути записані в тіло.
RENDER_V_CARD_INFO – вказує, що текст з VCard AlternativeView має бути записаний у вихідному mhtml.
DISPLAY_AS_OUTLOOK – вказує, що заголовок From буде відображатися як у Outlook.
RENDER_TASK_FIELDS – вказує, що специфічні поля завдання мають бути записані у вихідному mhtml.

Наведений нижче фрагмент коду показує, як конвертувати файл EML у MHTML з необов’язковими параметрами.

from aspose.email import MailMessage, MhtSaveOptions, MhtFormatOptions, MailMessageSaveType, FileCompatibilityMode

# Load an existing EML file
eml = MailMessage.load(data_dir + "message.eml")

# Save as mht with header
mht_save_options = MhtSaveOptions()

# Specify formatting options required
# Here we are specifying to write header information to output without writing extra print header
# and the output headers should be displayed as the original headers in the message
mht_save_options.mht_format_options = MhtFormatOptions.WRITE_HEADER | MhtFormatOptions.HIDE_EXTRA_PRINT_HEADER | MhtFormatOptions.DISPLAY_AS_OUTLOOK

# Check the body encoding for validity.
mht_save_options.check_body_content_encoding = True

eml.save(data_dir + "outMessage_out.mht", mht_save_options)

Включення подій календаря у конвертацію MHTML

The MhtFormatOptions.RenderCalendarEvent відображає події Календаря у вихідному MHTML. Наведений нижче фрагмент коду показує, як відобразити події календаря під час конвертації у MHTML:

from aspose.email import MailMessage, MhtSaveOptions, MhtFormatOptions, MhtTemplateName, MailMessageSaveType, FileCompatibilityMode

file_name = "message.msg"

# Load the MSG file
msg = MailMessage.load(data_dir + file_name)

# Create MHT save options
options = MhtSaveOptions()
options.mht_format_options = MhtFormatOptions.WRITE_HEADER | MhtFormatOptions.RENDER_CALENDAR_EVENT

# Save the message as MHTML
msg.save(data_dir + "Meeting with Recurring Occurrences.mhtml", options)

Експорт листа у MHT без вбудованих зображень

from aspose.email import MailMessage, MhtSaveOptions, MhtFormatOptions, MhtTemplateName, MailMessageSaveType, FileCompatibilityMode

# Load the EML file
eml = MailMessage.load(data_dir + "message.eml")

# Create MHT save options
mht_save_options = MhtSaveOptions()
mht_save_options.skip_inline_images = True

# Save the message as MHTML without inline images
eml.save(data_dir + "EmlToMhtmlWithoutInlineImages_out.mht", mht_save_options)

Експорт листа у MHT з користувацьким часовим поясом

MailMessage class надає TimeZoneOffset властивість для встановлення користувацького часового поясу під час експорту у MHT. Наведений нижче фрагмент коду показує, як експортувати лист у MHT з кастомізованим часовим поясом:

from aspose.email import MailMessage, MhtSaveOptions, MhtFormatOptions, MhtTemplateName, MailMessageSaveType, FileCompatibilityMode
from datetime import timedelta

# Load the EML file
eml = MailMessage.load(data_dir + "message.eml")

# Set the local time for message date
eml.time_zone_offset = timedelta(hours=-8)

# The dates will be rendered by the local system time zone
mht_save_options = MhtSaveOptions()
mht_save_options.mht_format_options = MhtFormatOptions.WRITE_HEADER
eml.save(data_dir + "ExportEmailToMHTWithCustomTimezone_out.mhtml", mht_save_options)

Збереження у HTML

The HtmlSaveOptions class дозволяє експортувати тіло повідомлення у HTML з можливістю збереження вбудованих ресурсів. Наведений нижче фрагмент коду показує, як зберегти повідомлення у форматі HTML, де значення за замовчуванням embed_resources дорівнює true.

from aspose.email import MailMessage, SaveOptions, HtmlSaveOptions, HtmlFormatOptions

# Load the EML file
message = MailMessage.load(data_dir + "message.eml")

# Save the Email message as HTML
message.save(data_dir + "SaveAsHTML_out.html", SaveOptions.default_html)

# OR

eml = MailMessage.load(data_dir + "message.eml")
options = HtmlSaveOptions()
options.embed_resources = False
options.html_format_options = (
    HtmlFormatOptions.WRITE_HEADER
    | HtmlFormatOptions.WRITE_COMPLETE_EMAIL_ADDRESS
)  # save the message headers to output HTML using the formatting options
eml.save(data_dir + "SaveAsHTML1_out.html", options)

Збереження як шаблон Outlook (.OFT)

Наведений нижче фрагмент коду показує, як зберегти повідомлення у вигляді шаблону Outlook (.oft).

from aspose.email import MailMessage, SaveOptions

eml = MailMessage("test@from.to", "test@to.to", "template subject", "Template body")

oft_eml_file_name = "EmlAsOft_out.oft"
options = SaveOptions.default_msg_unicode
options.save_as_template = True
eml.save(data_dir + oft_eml_file_name, options)

Python-Net: Обробка вкладень та вбудованих об’єктів

Mon, 01 Jan 0001 00:00:00 +0000

Керування вкладеннями електронної пошти

Вкладення електронної пошти — це комп’ютерний файл, який надсилається разом із листом. Файл може бути надісланий окремим повідомленням, а також частиною повідомлення, до якого він прикріплений. Attachment клас, який використовується для керування та маніпулювання прикріпленими файлами в повідомленні електронної пошти.

Усі повідомлення містять тіло. Окрім тіла, ви можете захотіти надіслати додаткові файли. Вони надсилаються як вкладення та представляються як екземпляр Attachment клас. Ви можете надсилати будь-яку кількість вкладень, проте розмір вкладення обмежується поштовим сервером. Gmail, наприклад, не підтримує файли розміром більше 10 МБ.

Спробуйте!

Додавайте або видаляйте вкладення електронної пошти онлайн за допомогою безкоштовного Aspose.Email Editor App.

Додавання вкладень

Щоб прикріпити файл до листа, виконайте такі кроки:

Створіть екземпляр MailMessage клас.
Створіть екземпляр Attachment клас.
Завантажте вкладення у екземпляр Attachment.
Додайте екземпляр Attachment у MailMessage екземпляр класу.

Наступний фрагмент коду показує, як додати вкладення до електронного листа.

Вище ми описали, як додавати вкладення до вашого повідомлення електронної пошти за допомогою Aspose.Email. Далі показано, як видаляти вкладення та відображати інформацію про них на екрані.

Видалення вкладень

Щоб видалити вкладення, виконайте наведені нижче кроки:

Створіть екземпляр MailMessage клас.
Завантажте вкладення за вказаним шляхом до файлу за допомогою Attachment клас.
Додайте вкладення до MailMessage колекція вкладень екземпляра.
Виведіть кількість вкладень перед їх видаленням.
Видаліть вкладення з MailMessage колекція вкладень екземпляра.
Виведіть кількість вкладень після видалення вкладення.

Наступний фрагмент коду показує, як видалити вкладення:

Отримання імен файлів вкладень

Щоб відобразити назву файлу вкладення, виконайте такі кроки:

Переберіть вкладення у завантаженому листі.
Для кожного вкладення виведіть його назву за допомогою циклу, що перебирає вкладення.

Наступний фрагмент коду показує, як відобразити назву файлу вкладення на екрані.

Витягнення вкладень

У Aspose.Email MailMessage клас використовується для роботи з вкладеннями. Вкладення електронної пошти — це комп’ютерний файл, який надсилається разом з листом. Він може бути надісланий окремим повідомленням, а також частиною повідомлення, до якого прикріплений. Файл представлений як екземпляр Attachment класі. Щоб витягнути вкладення з листів, виконайте наступні кроки:

Створіть екземпляр MailMessage клас.
Завантажте файл електронного листа у MailMessage екземпляр.
Створіть екземпляр Attachment клас та використовуйте його в циклі для витягнення всіх вкладень.
Збережіть вкладення та відобразіть його на екрані.
Вкажіть адресу відправника та отримувача в MailMessage екземпляр.
Тепер ви можете надсилати листи за допомогою SmtpClient клас.

Наступний фрагмент коду показує, як витягнути вкладення листа:

|Витягнуті вкладення в електронному листі| | :- | ||

Отримання Content-Description з вкладень

API Aspose.Email забезпечує можливість читання Content-Description з заголовків вкладень. Наступний фрагмент коду показує, як отримати опис вмісту з вкладення:

Ідентифікація вбудованих вкладень повідомлень

Робота з вбудованими об’єктами

Вбудований об’єкт — це об’єкт, створений в одній програмі та вбудований у документ або файл, створений іншою програмою. Наприклад, електронна таблиця Microsoft Excel може бути вбудована у звіт Microsoft Word, або відеофайл може бути вбудований у презентацію Microsoft PowerPoint. Коли файл вбудований, а не вставлений або скопійований у інший документ, він зберігає свій початковий формат. Вбудований документ можна відкрити в оригінальній програмі та змінити.

Витягування вбудованих об’єктів

Наступний приклад коду демонструє, як витягнути вбудовані об’єкти з файлу листа, використовуючи Aspose.Email для Python через .NET.

Створіть екземпляр MailMessage клас.
Завантажте файл листа у екземпляр MailMessage.
Створіть цикл і екземпляр Attachment клас у цьому.
Збережіть вкладення та відобразіть його на екрані.
Вкажіть адресу відправника та отримувача у екземплярі MailMessage.
Надіслати електронний лист, використовуючи SmtpClient клас.

|Витягнуті вбудовані об’єкти у листі| | :- | ||

Python-Net: Обробка TNEF‑вкладень у електронних листах

Mon, 01 Jan 0001 00:00:00 +0000

Листи, що містять TNEF‑вкладення

Transport Neutral Encapsulation Format (TNEF) — це пропрієтарний формат вкладень електронної пошти, що використовується Microsoft Outlook та Microsoft Exchange Server. API Aspose.Email дозволяє читати листи, які містять TNEF‑вкладення, та змінювати їхній вміст. Після цього лист можна зберегти як звичайне повідомлення або у тому ж форматі, зберігаючи ці вкладення. У цій статті показані різні приклади коду для роботи з листами, що містять TNEF‑вкладення. Також продемонстровано, як створювати TNEF‑файли EML з MSG‑файлів Outlook.

Визначення TNEF‑вкладень у листі

Наведений нижче фрагмент коду показує, як визначити, чи містить лист TNEF‑вкладення:

from aspose.email import MailMessage

mail = MailMessage.load(data_dir + "message.eml")
is_tnef = mail.original_is_tnef

Читання листів зі збереженням TNEF‑вкладень

Наведений нижче фрагмент коду показує, як прочитати повідомлення та зберегти TNEF‑вкладення.

from aspose.email import MailMessage, SaveOptions, EmlLoadOptions, MessageFormat, FileCompatibilityMode

options = EmlLoadOptions()
# This will Preserve the TNEF attachment as it is, file contains the TNEF attachment
options.preserve_tnef_attachments = True

eml = MailMessage.load(data_dir + "message.eml", options)
for attachment in eml.attachments:
    print(attachment.name)

Конвертація MSG у TNEF

MSG‑файли Outlook іноді містять інформацію, таку як таблиці та стилі тексту, які можуть бути пошкоджені при конвертації в EML. Створення TNEF‑повідомлень з таких MSG‑файлів дозволяє зберегти форматування та навіть надсилати такі повідомлення через поштові клієнти, зберігаючи форматування. The convert_as_tnef властивість використовується для досягнення цього. Наведений нижче фрагмент коду показує, як створити TNEF‑лист з MSG.

from aspose.email.mapi import MapiMessage, MailConversionOptions, OutlookMessageFormat

mapi_msg = MapiMessage.from_file(data_dir + "message.msg")

mail_conversion_options = MailConversionOptions()
mail_conversion_options.convert_as_tnef = True

message = mapi_msg.to_mail_message(mail_conversion_options)

Створення TNEF‑листа

Наведений нижче приклад коду можна використати для створення листа у форматі TNEF:

Налаштуйте параметри файлу за допомогою the MsgLoadOptions клас.
Забезпечте збереження TNEF‑вкладень у листі під час завантаження файлу, встановивши options.preserve_tnef_attachments на True.
Використайте MailMessage.load(eml_file_name, options) метод для завантаження вхідного файлу листа з одночасним застосуванням раніше налаштованих параметрів. Це особливо забезпечує збереження TNEF‑пов’язаної інформації (наприклад, вкладень або пропрієтарних форматів Microsoft Outlook) у завантаженому листі.

from aspose.email import MailMessage, SaveOptions, MsgLoadOptions, MessageFormat, FileCompatibilityMode

options = MsgLoadOptions()
# The PreserveTnefAttachments option with MessageFormat.Msg will create the TNEF eml.
options.preserve_tnef_attachments = True

eml = MailMessage.load(eml_file_name, options)

Виявлення TNEF‑повідомлень

Наведений нижче фрагмент коду показує, як виявити, чи повідомлення є TNEF. The original_is_tnef властивість MailMessage об’єкт перевіряється, щоб визначити, чи був лист спочатку у форматі TNEF (Transport Neutral Encapsulation Format). Якщо is_tnef дає True, це означає, що лист містить кодування TNEF, що зазвичай трапляється у листах, створених у Microsoft Outlook або Exchange.

from aspose.email import MailMessage

mail = MailMessage.load(data_dir + "message.eml")
is_tnef = mail.original_is_tnef

Python-Net: Виявлення та обробка повернутих листів у Python

Mon, 01 Jan 0001 00:00:00 +0000

Обробка повернутих листів

Дуже часто повідомлення, надіслане отримувачу, може повернутися з певної причини, наприклад через неправильну адресу одержувача. Aspose.Email API має можливість перевіряти, чи є лист повернутим або звичайним, і обробляти його. The check_bounced метод MailMessage Клас повертає коректний результат, якщо повідомлення електронної пошти є повернутим. Нижче наведено фрагмент коду, який показує, як обробляти повернуті повідомлення за допомогою BounceResult Клас, що надає детальну інформацію про отримувачів, виконану дію та причину сповіщення.

from aspose.email import MailMessage, SaveOptions, MsgLoadOptions, MessageFormat, FileCompatibilityMode

mail = MailMessage.load(data_dir + "message.eml")
result = mail.check_bounced()

print("IsBounced: " + str(result.is_bounced))
print("Action: " + str(result.action))
print("Recipient: " + str(result.recipient))
print()
print("Reason: " + str(result.reason))
print("Status: " + str(result.status))
print()

Python-Net: Використання баєсового спам-фільтра для класифікації електронних листів у Python

Mon, 01 Jan 0001 00:00:00 +0000

Використання баєсового спам‑фільтру

Aspose.Email надає функціональність фільтрації електронної пошти за допомогою баєсового спам‑аналізатора. Він забезпечує SpamAnalyzer клас для цієї мети. У цій статті показано, як навчити фільтр розрізняти спам і звичайну пошту на основі словникової бази.

Вкажіть шляхи до папок для листів‑не‑спам (ham_folder), листів‑спам (spam_folder), тестових листів (test_folder) та файл бази даних (database_file) для спам‑фільтра.
Визначте допоміжну функцію print_result щоб вивести, чи повідомлення класифіковано як спам, чи ні, на основі розрахованої ймовірності спаму.
Створіть Spam Analyzer, використовуючи файл бази даних, навчіть його листами з ham_folder (не спам) та spam_folder (спам), потім збережіть натреновану базу даних.
Завантажте файли .eml з папки ’test_folder’, проаналізуйте кожен за допомогою SpamAnalyzer.test, щоб отримати ймовірність спаму, і виведіть тему листа та класифікацію за допомогою ‘print_result’.

from aspose.email import MailMessage, SaveOptions, MsgLoadOptions, MessageFormat, FileCompatibilityMode
from aspose.email.antispam import SpamAnalyzer
import os

ham_folder = "/hamFolder"
spam_folder = "/Spam"
test_folder = data_dir
database_file = "SpamFilterDatabase.txt"

def print_result(probability):
    if probability >= 0.5:
        print("The message is classified as spam.")
    else:
        print("The message is classified as not spam.")
    print("Spam Probability: " + str(probability))
    print()

def teach_and_create_database(ham_folder, spam_folder, database_file):
    analyzer = SpamAnalyzer(database_file)
    analyzer.teach_from_directory(ham_folder, True)
    analyzer.teach_from_directory(spam_folder, False)
    analyzer.save_database()

teach_and_create_database(ham_folder, spam_folder, database_file)

test_files = [f for f in os.listdir(test_folder) if f.endswith(".eml")]
analyzer = SpamAnalyzer(database_file)

for file in test_files:
    file_path = os.path.join(test_folder, file)
    msg = MailMessage.load(file_path)
    print(msg.subject)
    probability = analyzer.test(msg)
    print_result(probability)