Documentation – Работа с MIME съобщения

Python-Net: Създаване и управление на имейли

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

Създаване на ново имейл съобщение

Този MailMessage клас представлява имейл съобщение и позволява на разработчиците да създават нови имейл съобщения. Основни свойства на имейл като From, To, Subject и body могат лесно да бъдат прикрепени към новосъздаденото съобщение. По същия начин можем да запазим имейла в различни формати като EML, MSG и MHTML.

Създайте инстанция на MailMessage клас.
Задайте свойства на имейл съобщението.
Запазете имейл съобщението в различни формати.

Следният фрагмент от код показва как да създадете нов имейл с различни свойства.

Задаване на множество получатели

Този MailMessage обект представлява имейл съобщение. Екземпляри на MailMessage клас се използва за конструиране на имейл съобщения, които се предават до SMTP сървър чрез SmtpClient клас. Тази статия показва как да зададете повече от един имейл адрес. Имейл адресите могат да бъдат зададени чрез MailMessage клас. Те са:

To – Адресите на получателите могат да бъдат зададени в полето ‘To’. Получателите в полето ‘To’ са основната аудитория на съобщението. Може да има повече от един адрес на получател.
Cc - CC означава „carbon copy“ (копие) или „courtesy copy“ (учтиво копие) и ви позволява да добавите получатели, които трябва да видят имейла, но не са задължени да предприемат действия. Мениджъри, например, или членове на вашия екип, които трябва да бъдат информирани за разговор. С Aspose.Email, адресите за CC могат да се задават в кода. По този начин автоматичните имейли, или всички имейли към конкретен адрес, могат да се копират на съответния персонал.
Bcc - Bcc, слепо копиране (blind carbon copy), ви позволява да изпратите имейл до получател, който е скрит от другите получатели. Докато 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 клас и изпратете имейла, използвайки Изпрати метод.

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

Задаване на темата на имейл

Този 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 в колекцията и се разрешават.
BaseUri се използва от четеца на имейли за разрешаване на относителни URL адреси в тялото, както и за разрешаване на относителни URL адреси за връзки в съдържанието, в колекцията LinkedResources.

Следният кодов фрагмент показва как да зададете алтернативен текст.

Функции на MailMessage

Този MailMessage class представлява съдържанието на имейл съобщение. Екземпляри на MailMessage class се използва за създаване на имейл съобщение, което се предава на SMTP сървър за доставка чрез SmtpClient class. Тази статия показва как да се използва MailMessage class utility функции за управление на следните характеристики на имейла:

Дата и час - Чрез 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())

Искане на разписка за прочитане

Програмните образци по-долу показват как можете да поискате разписка за прочитане. Това MailMessage клас DeliveryNotificationOptions Свойството за изброяване описва опциите за известие за доставка на имейл. За да поискате разписка за прочитане след изпращане на имейл, следвайте тези стъпки:

Създайте инстанция на 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“. Т.е. получателят не се очаква да отговори или да предприеме действие. Обикновено се уведомява надзорен персонал чрез CC.
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

Вмъкване на заглавка на конкретно място

Този Добавяне метод на 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

Показване на метаданни на имейл

Този MailMessage представлява имейл съобщение и позволява на разработчиците да достъпят неговите свойства. Информацията от заглавието може да бъде извлечена и манипулирана по различни начини. Тази статия обяснява как да се покажат избрани данни от заглавието на имейла и тялото на имейла на екрана. За да покажете информация за имейл на екрана, следвайте тези стъпки:

Създайте инстанция на MailMessage клас.
Заредете имейл съобщение в MailMessage екземпляр.
Показване на съдържанието на имейла на екрана.

Следният фрагмент от код показва как да се покаже информация за имейл на екрана:

Извличане на заглавия на имейл

Заглавието на имейла представлява набор от полета, определени от Интернет и RFC стандарти, включени в имейл съобщенията. Заглавието на имейл може да се зададе с помощта на класа MailMessage. Общите типове заглавия са дефинирани в HeaderType class. Това е запечатан клас, който работи като типично изброяване. За да извлечете заглавия от имейл, следвайте тези стъпки:

Създайте инстанция на MailMessage клас.
Заредете имейл съобщение в екземпляра на MailMessage клас.
След като имейл съобщението бъде заредено, ще получим неговото сурово съдържание.

Този 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 съобщения. Това се постига чрез 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, използвайки съответната опция от 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 файлове

Този 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

Този 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 - Означава, че байтовете на Byte Order Mark (BOM) трябва да бъдат записани в тялото.
RENDER_V_CARD_INFO - Означава, че текстът от VCard AlternativeView трябва да бъде записан в изходния mhtml.
DISPLAY_AS_OUTLOOK - Означава, че заглавието From ще се показва както в Outlook.
RENDER_TASK_FIELDS - Означава, че специфичните полета на Task трябва да бъдат записани в изходния 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

Този 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 клас предоставя 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

Този 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 MB.

Try it out!

Добавяйте или премахвайте имейл прикачени файлове онлайн с безплатния 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 от прикачени файлове

Aspose.Email API предоставя възможност за четене на 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. Aspose.Email API позволява да четете имейл съобщения, които имат TNEF прикачени файлове и да модифицирате тяхното съдържание. След това имейлът може да бъде запазен като нормално съобщение или в същия формат, запазвайки тези прикачени файлове. Тази статия показва различни примерни кодове за работа със съобщения, съдържащи TNEF прикачени файлове. Тя също демонстрира как да се създадат TNEF EML файлове от Outlook MSG файлове.

Идентифициране на 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

Outlook MSG файловете понякога съдържат информация като таблици и текстови стилове, които могат да се повредят при конвертиране към EML. Създаването на TNEF съобщения от такива MSG файлове ви позволява да запазите форматирането и дори да изпратите такива съобщения чрез имейл клиентите, като запазите форматирането. Това 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:

Конфигурирайте файловите опции, използвайки 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. Това 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)