Documentation – Làm việc với các tin nhắn MIME

Python-Net: Tạo và Quản lý Email

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

Tạo Tin Nhắn Email Mới

Cái MailMessage lớp đại diện cho một tin nhắn email và cho phép các nhà phát triển tạo tin nhắn email mới. Các thuộc tính email cơ bản như From, To, Subject và body có thể dễ dàng được gắn vào tin nhắn email mới tạo. Tương tự, chúng ta có thể lưu tin nhắn email vào các định dạng khác nhau như EML, MSG và MHTML.

Tạo một đối tượng của MailMessage lớp.
Đặt các thuộc tính của tin nhắn email.
Lưu tin nhắn email ở các định dạng khác nhau.

Đoạn mã dưới đây cho bạn cách tạo một email mới với các thuộc tính khác nhau.

Chỉ định Nhiều Người Nhận

Cái MailMessage đối tượng đại diện cho một tin nhắn email. Các thể hiện của MailMessage lớp được sử dụng để tạo các tin nhắn email được truyền tới máy chủ SMTP bằng SmtpClient lớp. Bài viết này trình bày cách chỉ định nhiều hơn một địa chỉ email. Địa chỉ email có thể được chỉ định bằng MailMessage lớp. Chúng là:

To - Địa chỉ người nhận có thể được chỉ định trong trường ‘To’. Người nhận trong trường ‘To’ là khán giả chính của tin nhắn. Có thể có nhiều hơn một địa chỉ người nhận.
Cc - CC nghĩa là "carbon copy" (bản sao), hoặc "courtesy copy" (bản sao lễ phép), cho phép bạn thêm người nhận email cần xem nội dung nhưng không nhất thiết phải hành động. Ví dụ, quản lý hoặc thành viên nhóm cần biết về cuộc trò chuyện. Với Aspose.Email, các địa chỉ CC có thể được chỉ định trong mã của bạn. Như vậy, email tự động hoặc mọi email tới một địa chỉ nhất định có thể được sao chép tới nhân viên liên quan.
Bcc - Bcc, bản sao giấu (blind carbon copy), cho phép bạn gửi email cho một người nhận được ẩn khỏi các người nhận khác. Khi CC xuất hiện trong thông tin email mà người nhận chính thấy, Bcc thì không. Nó dùng để thông báo ẩn.

Để chỉ định nhiều địa chỉ email trong một tin nhắn, hãy thực hiện các bước sau:

Tạo một đối tượng của MailMessage lớp.
Chỉ định địa chỉ From và nhiều địa chỉ To, Cc và Bcc bằng MailMessage thể hiện.
Tạo một đối tượng của SmtpClient lớp và gửi email bằng phương thức Send.

Mẫu mã dưới đây cho thấy cách chỉ định nhiều địa chỉ To, CC và BCC.

Đặt Tên Hiển Thị Người Gửi và Người Nhận

Các mẫu lập trình dưới đây minh họa cách thay đổi địa chỉ email thành tên thân thiện trong một email. Tên thân thiện là một tên dễ hiểu hơn địa chỉ email, ví dụ John Smith thay vì js346@domain.com. Khi gửi email, chúng ta có thể liên kết tên thân thiện với địa chỉ email trong MailMessage hàm khởi tạo lớp.

Để thay đổi địa chỉ email thành tên thân thiện trong một email, hãy thực hiện các bước sau:

Tạo một đối tượng của MailMessage lớp và chỉ định địa chỉ email trong các trường To và From cùng tên hiển thị.
Chỉ định địa chỉ email Cc và Bcc cùng tên hiển thị bằng cách gọi MailMessage hàm tạo lớp trong MailMessage thể hiện.
Tạo một đối tượng của SmtpClient lớp và gửi email bằng cách sử dụng Gửi phương thức.

Đoạn mã sau cho thấy cách hiển thị Tên cho các địa chỉ email.

Đặt Tiêu Đề cho Email

Cái MailMessage lớp cho phép bạn chỉ định bản tóm tắt ngắn gọn nội dung tin nhắn bằng tiêu đề thuộc tính. Đoạn mã sau đây minh họa cách tạo một email và đặt tiêu đề của nó:

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}")

Đặt Phần Thân Email

Cũng như tiêu đề của tin nhắn, phần thân email có thể được chỉ định bằng cùng MailMessage lớp. Một email có thể có nhiều phần thân. Có hai loại phần thân mail trong lớp:

Phần thân dạng HTML
Phần thân dạng Văn bản

Ngoài HtmlBody và TextBody, Aspose.Email có hai thuộc tính chỉ đọc khác liên quan đến phần thân mail:

IsBodyText: cho người dùng biết phần thân là văn bản hay không.
IsBodyHtml: cho người dùng biết phần thân là HTML hay văn bản thuần.

Bài viết này chỉ ra cách xác định nội dung văn bản thuần hoặc HTML, đặt văn bản thay thế và mã hoá phần thân email.

Đặt Phần Thân HTML

Phần thân Html được sử dụng để chỉ định nội dung HTML của phần thân tin nhắn. Phần thân Html phải được bao quanh bởi thẻ . Đoạn mã dưới đây cho bạn cách đặt phần thân HTML.

Đặt Văn Bản Thay Thế

Sử dụng AlternateView lớp để chỉ định các bản sao của tin nhắn email ở các định dạng khác nhau. Ví dụ, nếu bạn gửi một tin nhắn dạng HTML, bạn cũng có thể muốn cung cấp một phiên bản văn bản thuần để trường hợp một số người nhận dùng trình đọc email không hỗ trợ hiển thị HTML. Lớp này có hai thuộc tính, linked_resources và base_uri, được sử dụng để giải quyết các URL trong nội dung email.

LinkedResources là một tập hợp các đối tượng LinkedResources. Khi hiển thị, các URL trong nội dung email sẽ được so sánh với các URL trong Content Link của mỗi đối tượng LinkedResources trong tập hợp, và được giải quyết.
BaseUri được trình đọc email sử dụng để giải quyết các URL tương đối trong phần thân, và cũng để giải quyết các URL liên kết nội dung tương đối trong bộ sưu tập LinkedResources.

Đoạn mã sau cho thấy cách đặt văn bản thay thế.

Các Tính Năng của MailMessage

Cái MailMessage class đại diện cho nội dung của một tin nhắn email. Các thể hiện của MailMessage class được sử dụng để xây dựng một tin nhắn email được truyền tới máy chủ SMTP để giao bằng cách sử dụng SmtpClient class. Bài viết này chỉ ra cách sử dụng MailMessage Các tính năng tiện ích của class để kiểm soát các tính năng email sau:

Date and time - Thông qua MailMessage Thuộc tính class Date cho phép chúng ta lấy hoặc đặt ngày và thời gian của email.
Mức độ ưu tiên của tin nhắn - MailPriority lớp xác định các mức độ ưu tiên khi gửi email. Nó có thể là thấp, bình thường hoặc cao. Độ ưu tiên ảnh hưởng đến tốc độ truyền và giao nhận.
Mức độ nhạy cảm của tin nhắn - MailSensitivity lớp xác định năm mức độ nhạy cảm.
Thông báo giao nhận - Thông báo giao nhận cho người gửi biết rằng email họ đã gửi đã được chuyển đến hộp thư đến của người nhận.

Theo mặc định, ngày là ngày thực tế mà tin nhắn được gửi, và thời gian là thời gian nó được gửi, như hiển thị trong Microsoft Outlook. Tuy nhiên, thời gian giao email thực tế được thêm bởi máy chủ SMTP trong phần tiêu đề email. Ví dụ, dưới đây là một tiêu đề email phổ biến, trong đó Date đặt trường 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())

Đoạn mã dưới đây minh họa cách sử dụng từng tính năng đã đề cập ở trên.

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())

Yêu cầu Biên nhận Đọc

Các mẫu lập trình dưới đây cho thấy cách bạn có thể yêu cầu biên nhận đã đọc. The MailMessage lớp DeliveryNotificationOptions Thuộc tính enumeration mô tả các tùy chọn thông báo giao nhận cho một email. Để yêu cầu biên nhận đã đọc sau khi gửi email, hãy thực hiện các bước sau:

Tạo một đối tượng của MailMessage lớp.
Chỉ định người gửi, người nhận và phần thân HTML cho email trong MailMessage thể hiện.
Chỉ định DeliveryNotificationOptions trong các MailMessage các thể hiện.
Tạo một đối tượng của SmtpClient lớp và gửi email bằng phương thức Send.

Yêu cầu biên nhận đọc có thể không luôn được chấp nhận vì:

Một client email có thể không thực hiện chức năng đó.
Người dùng cuối có thể đã tắt chức năng này.
Người dùng cuối có thể chọn không gửi.

Đoạn mã sau cho thấy cách yêu cầu biên nhận đọc.

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()

Đặt Tiêu đề Email

Tiêu đề email đại diện cho một tiêu chuẩn Internet và RFC định nghĩa các trường tiêu đề được bao gồm trong các tin nhắn email trên Internet. Tiêu đề email có thể được chỉ định bằng lớp MailMessage. Các loại tiêu đề thông thường được định nghĩa trong lớp HeaderType. Đây là một lớp sealed hoạt động giống như một enumeration thông thường.

Thông thường một tiêu đề email chứa các trường sau:

To: Địa chỉ người nhận có thể được chỉ định trong trường To. Những người nhận này là khán giả chính của tin nhắn. Có thể có nhiều hơn một địa chỉ người nhận.
From: Trường này hiển thị địa chỉ email của người gửi tin nhắn.
Cc: Cho phép người dùng gửi tin nhắn dưới dạng "Carbon Copy" hoặc "Courtesy Copy". Nghĩa là người nhận không cần trả lời hoặc hành động. Thông thường, các nhân viên cấp trên được thông báo qua CC.
Bcc: Viết tắt của Blind Carbon Copy, chỉ việc gửi một tin nhắn tới nhiều người nhận sao cho họ không thấy danh sách đầy đủ các người nhận. Dùng để thông báo ẩn danh.
ReplyTo: Trường tiêu đề này nhằm chỉ ra nơi mà người gửi muốn nhận các phản hồi.
Subject: Tiêu đề, đề mục, chủ đề. Thường được dùng làm chỉ báo chuỗi hội thoại cho các tin nhắn trả lời hoặc bình luận trên các tin nhắn khác.
Date: Tiêu đề này chỉ định ngày (và giờ). Thông thường, đây là ngày mà tin nhắn được soạn và gửi.
XMailer: Thông tin về phần mềm khách hàng của người gửi. Ví dụ: X-Mailer: Aspose.Email. XMailer được sử dụng bởi các client email. Các client email khác nhau sẽ có giá trị XMailer khác nhau. Giá trị XMailer của MS Outlook là Microsoft Office Outlook, Build 11.0.5510. Nó bị các bộ nhận email hoặc trình đọc email bỏ qua.

Thông thường, một tiêu đề email trông như sau:


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

Để tùy chỉnh tiêu đề email, thực hiện các bước sau:

Tạo một đối tượng của MailMessage lớp.
Chỉ định To, From, CC, Bcc, ReplyTo, Subject, Date & XMailer bằng một thể hiện của MailMessage.
Tạo một đối tượng của MimeHeader lớp và chỉ định tiêu đề bí mật.
Thêm tiêu đề bí mật vào MailMessage thể hiện.

Đoạn mã dưới đây cho bạn cách đặt tiêu đề email.

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")

Đoạn mã trên tạo ra một tiêu đề email ở định dạng sau. Bạn có thể quan sát bằng cách mở tệp kết quả "MsgHeaders.msg" trong Microsoft Outlook và xem Thuộc tính.


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

Chèn Tiêu đề tại Vị trí Cụ thể

Cái Thêm phương thức của HeadersCollection lớp chèn tiêu đề vào cuối bộ sưu tập. Tuy nhiên, đôi khi có thể cần chèn tiêu đề vào vị trí cụ thể. Trong trường hợp đó, Thêm phương thức sẽ không hữu ích. Để thực hiện điều này, sử dụng Insert phương thức của HeadersCollection. Nếu bộ sưu tập chứa các tiêu đề cùng tên, tiêu đề này sẽ được chèn trước các tiêu đề khác có cùng tên.

Đoạn mã dưới đây cho bạn cách chèn tiêu đề ở vị trí cụ thể.

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

Thêm Tiêu đề Tùy chỉnh vào email

Mẫu lập trình dưới đây minh họa cách chỉ định tiêu đề tùy chỉnh trong tin nhắn email bằng MailMessage lớp.

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

Đoạn mã trên tạo ra một tiêu đề email ở định dạng sau:

secret-header: mystery

Python-Net: Trích xuất thông tin email

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

Hiển thị siêu dữ liệu email

Cái MailMessage đại diện cho một tin nhắn email và cho phép các nhà phát triển truy cập các thuộc tính của nó. Thông tin tiêu đề có thể được trích xuất và thao tác theo các cách khác nhau. Bài viết này giải thích cách hiển thị thông tin tiêu đề email đã chọn và nội dung email trên màn hình. Để hiển thị thông tin email trên màn hình, hãy thực hiện các bước sau:

Tạo một đối tượng của MailMessage lớp.
Tải một tin nhắn email vào MailMessage thể hiện.
Hiển thị nội dung email trên màn hình.

Đoạn mã dưới đây cho bạn thấy cách hiển thị thông tin email trên màn hình:

Trích xuất Tiêu đề Email

Tiêu đề email đại diện cho một tập hợp các trường tiêu đề chuẩn được định nghĩa bởi Internet và RFC trong các tin nhắn email. Tiêu đề email có thể được chỉ định bằng lớp MailMessage. Các loại tiêu đề phổ biến được định nghĩa trong HeaderType class. Đây là một lớp sealed hoạt động giống như enumeration thông thường. Để trích xuất tiêu đề từ một email, hãy thực hiện các bước sau:

Tạo một đối tượng của MailMessage lớp.
Tải một tin nhắn email trong thể hiện của MailMessage lớp.
Sau khi một tin nhắn email đã được tải, chúng ta sẽ lấy nội dung thô của nó.

Cái MailMessage class tự nó chứa các thuộc tính như From, To, Cc, Subject và các thuộc tính khác. Các thuộc tính này có thể được trích xuất từ tiêu đề.

Đoạn mã dưới đây cho bạn thấy cách trích xuất tiêu đề email:

Giải mã giá trị tiêu đề

Đoạn mã dưới đây cho bạn thấy cách lấy các giá trị tiêu đề đã giải mã.

Python-Net: Tải, lưu và chuyển đổi email

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

Phát hiện định dạng tệp Email

API Aspose.Email cung cấp khả năng phát hiện định dạng tệp của tệp tin tin nhắn được cung cấp. The DetectFileFormat phương thức của FileFormatUtil Lớp có thể được sử dụng để đạt được điều này. Các lớp và phương thức sau có thể được sử dụng để phát hiện định dạng tệp đã tải:

Enum FileFormatType
Lớp FileFormatInfo
Lớp FileFormatUtil
Phương thức detect_file_format(stream)
Phương thức detect_file_format(file_path)

Đoạn mã dưới đây cho bạn thấy cách phát hiện các định dạng tệp:

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))

Tải tin nhắn với các tùy chọn tải

Đoạn mã dưới đây cho bạn thấy cách tải một tin nhắn với các tùy chọn tải.

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)

Giữ định dạng tin nhắn nhúng khi tải

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))

Lưu và chuyển đổi email

Aspose.Email giúp dễ dàng chuyển đổi bất kỳ loại tin nhắn nào sang định dạng khác. Để minh họa tính năng này, mã trong bài viết này tải ba loại tin nhắn từ đĩa và lưu chúng lại ở các định dạng khác. Lớp cơ sở SaveOptions và các lớp EmlSaveOptions, MsgSaveOptions, MhtSaveOptions, HtmlSaveOptions có thể được sử dụng cho các cài đặt bổ sung khi lưu tin nhắn sang các định dạng khác. Bài viết chỉ ra cách sử dụng các lớp này để lưu một email mẫu dưới dạng:

Định dạng EML.
Outlook MSG.
Định dạng MHTML.
Định dạng HTML.

Lưu dưới dạng EML

Đoạn mã dưới đây cho bạn thấy cách tải một tin nhắn EML và lưu nó vào đĩa ở cùng định dạng.

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)

Giữ ranh giới trong tệp EML

Đoạn mã dưới đây cho bạn thấy cách tải tệp EML và lưu lại ở cùng định dạng, giữ nguyên các ranh giới gốc.

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)

Tùy chỉnh chuỗi ranh giới MIME

Aspose.Email cho .NET cho phép bạn cấu hình mẫu ranh giới được sử dụng trong các tin nhắn MIME. Điều này được thực hiện thông qua boundaries_template thuộc tính của EmlSaveOptions lớp.

Bằng cách thiết lập một mẫu tùy chỉnh, bạn có thể định nghĩa cách các ranh giới MIME được tạo. Ký tự đại diện {#} trong mẫu sẽ được thay thế bằng một số ranh giới tăng dần, cho phép các chuỗi ranh giới động và dễ đọc.

Nếu boundaries_template không được đặt (mặc định là None), thư viện sẽ sử dụng định dạng ranh giới nội bộ.

Mẫu mã dưới đây cho thấy cách tùy chỉnh chuỗi ranh giới MIME khi lưu một tin nhắn email dưới định dạng .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)

Đây là một ví dụ về cấu trúc tin nhắn với các ranh giới tùy chỉnh được lưu bằng mã ở trên:

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--

Giữ tệp đính kèm TNEF trong tệp EML

Đoạn mã dưới đây cho bạn thấy cách lưu tệp EML mà vẫn giữ các tệp đính kèm 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)

Lưu dưới dạng MSG

Đoạn mã dưới đây cho bạn thấy cách tải một tin nhắn EML và chuyển đổi nó sang MSG bằng tùy chọn thích hợp từ 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)

Giữ ngày tháng trong tệp MSG

Cái MsgSaveOptions class cho phép bạn lưu tin nhắn nguồn dưới dạng tệp Outlook Message (MSG) giữ nguyên ngày tháng. Đoạn mã dưới đây cho bạn thấy cách lưu tệp EML dưới dạng MSG và giữ ngày tháng.

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)

Lưu dưới dạng MHTML

Các tùy chọn khác nhau của MHTML có thể được sử dụng để đạt được kết quả mong muốn. Đoạn mã dưới đây cho bạn cách tải một tin nhắn EML vào MailMessage và chuyển đổi nó sang 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)

Cài đặt chuyển đổi MHTML tùy chỉnh

Cái MhtSaveOptions lớp cung cấp các tùy chọn bổ sung để lưu các tin nhắn email ở định dạng MHTML. Bộ liệt kê MhtFormatOptions cho phép ghi thêm thông tin email vào MHTML đầu ra. Các trường bổ sung sau có thể được ghi:

NONE - Không có cài đặt nào được chỉ định.
WRITE_HEADER - Cho biết thông tin tiêu đề sẽ được ghi.
WRITE_OUTLINE_ATTACHMENTS - Cho biết các tệp đính kèm outline sẽ được ghi.
WRITE_COMPLETE_EMAIL_ADDRESS - Cho biết địa chỉ email đầy đủ sẽ được ghi trong tất cả các tiêu đề email.
NO_ENCODE_CHARACTERS - Cho biết không sử dụng mã hóa truyền ký tự nào.
HIDE_EXTRA_PRINT_HEADER - Cho biết PageHeader sẽ không hiển thị.
WRITE_COMPLETE_TO_EMAIL_ADDRESS - Cho biết địa chỉ email đầy đủ sẽ được ghi trong tiêu đề ‘To’.
WRITE_COMPLETE_FROM_EMAIL_ADDRESS - Cho biết địa chỉ email đầy đủ sẽ được ghi trong tiêu đề ‘From’.
WRITE_COMPLETE_CC_EMAIL_ADDRESS - Cho biết địa chỉ email đầy đủ sẽ được ghi trong tiêu đề ‘Cc’.
WRITE_COMPLETE_BCC_EMAIL_ADDRESS - Cho biết địa chỉ email đầy đủ sẽ được ghi trong tiêu đề ‘Bcc’.
RENDER_CALENDAR_EVENT - Cho biết văn bản từ sự kiện lịch sẽ được ghi trong mhtml đầu ra.
SKIP_BYTE_ORDER_MARK_IN_BODY - Cho biết các byte Byte Order Mark (BOM) sẽ được ghi vào phần thân.
RENDER_V_CARD_INFO - Cho biết văn bản từ VCard AlternativeView sẽ được ghi trong mhtml đầu ra.
DISPLAY_AS_OUTLOOK - Cho biết tiêu đề From sẽ được hiển thị như trong Outlook.
RENDER_TASK_FIELDS - Cho biết các trường Task cụ thể sẽ được ghi trong mhtml đầu ra.

Đoạn mã dưới đây cho bạn thấy cách chuyển đổi tệp EML sang MHTML với các cài đặt tùy chọn.

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)

Bao gồm sự kiện Lịch trong chuyển đổi MHTML

Cái MhtFormatOptions.RenderCalendarEvent kết xuất các sự kiện Lịch vào MHTML đầu ra. Đoạn mã dưới đây cho bạn thấy cách kết xuất các sự kiện lịch khi chuyển đổi sang 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)

Xuất email sang MHT mà không có hình ảnh nhúng

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)

Xuất email sang MHT với múi giờ tùy chỉnh

MailMessage class cung cấp TimeZoneOffset thuộc tính để đặt múi giờ tùy chỉnh khi xuất sang MHT. Đoạn mã dưới đây cho bạn thấy cách xuất một email sang MHT với múi giờ tùy chỉnh:

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)

Lưu dưới dạng HTML

Cái HtmlSaveOptions class cho phép bạn xuất phần thân tin nhắn ra HTML với tùy chọn lưu các tài nguyên nhúng. Đoạn mã dưới đây cho bạn thấy cách lưu một tin nhắn dưới dạng HTML trong đó giá trị mặc định của embed_resources là 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)

Lưu dưới dạng mẫu Outlook (.OFT)

Đoạn mã dưới đây cho bạn thấy cách lưu một tin nhắn dưới dạng tệp mẫu 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: Xử lý tệp đính kèm và các đối tượng nhúng

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

Quản lý Tệp đính kèm Email

Tệp đính kèm email là một tệp máy tính được gửi kèm với tin nhắn email. Tệp có thể được gửi như một tin nhắn riêng biệt hoặc như một phần của tin nhắn mà nó được đính kèm. Attachment lớp được sử dụng để quản lý và thao tác các tệp đính kèm trong một tin nhắn email.

Tất cả tin nhắn đều có phần nội dung. Ngoài phần nội dung, bạn có thể muốn gửi các tệp bổ sung. Chúng được gửi dưới dạng tệp đính kèm và được biểu diễn dưới dạng thể hiện của Attachment lớp. Bạn có thể gửi bất kỳ số lượng tệp đính kèm nào nhưng kích thước của tệp đính kèm bị giới hạn bởi máy chủ mail. Gmail, ví dụ, không hỗ trợ tệp lớn hơn 10MB.

Try it out!

Thêm hoặc xoá tệp đính kèm email trực tuyến với phiên bản miễn phí Aspose.Email Editor App.

Thêm Tệp Đính Kèm

Để đính kèm một tệp vào tin nhắn email, vui lòng thực hiện các bước sau:

Tạo một đối tượng của MailMessage lớp.
Tạo một đối tượng của Attachment lớp.
Tải tệp đính kèm vào thể hiện Attachment.
Thêm thể hiện Attachment vào MailMessage đối tượng lớp.

Đoạn mã dưới đây cho bạn thấy cách thêm một tệp đính kèm vào email.

Ở trên, chúng tôi đã mô tả cách thêm tệp đính kèm vào tin nhắn email của bạn với Aspose.Email. Tiếp theo là cách loại bỏ tệp đính kèm và hiển thị thông tin về chúng trên màn hình.

Xóa Tệp Đính Kèm

Để loại bỏ một tệp đính kèm, hãy thực hiện các bước dưới đây:

Tạo một đối tượng của MailMessage lớp.
Tải một tệp đính kèm từ đường dẫn tệp đã chỉ định bằng Attachment lớp.
Thêm tệp đính kèm vào MailMessage bộ sưu tập tệp đính kèm của thể hiện.
In số lượng tệp đính kèm trước khi xóa bất kỳ tệp nào.
Xóa tệp đính kèm khỏi MailMessage bộ sưu tập tệp đính kèm của thể hiện.
In số lượng tệp đính kèm sau khi xóa tệp.

Đoạn mã dưới đây cho bạn cách xóa một tệp đính kèm:

Lấy Tên Tệp Đính Kèm

Để hiển thị tên tệp đính kèm, thực hiện các bước sau:

Duyệt qua các tệp đính kèm trong email đã tải.
Đối với mỗi tệp đính kèm, in tên của nó bằng một vòng lặp duyệt qua các tệp đính kèm.

Đoạn mã dưới đây cho bạn thấy cách hiển thị tên tệp đính kèm trên màn hình.

Trích xuất Tệp Đính Kèm

Trong Aspose.Email, MailMessage lớp được sử dụng để làm việc với tệp đính kèm. Tệp đính kèm email là một tệp máy tính được gửi kèm với tin nhắn email. Nó có thể được gửi như một tin nhắn riêng hoặc như một phần của tin nhắn mà nó được đính kèm. Tệp được biểu diễn dưới dạng thể hiện của Attachment lớp. Để trích xuất tệp đính kèm từ các tin nhắn email, thực hiện các bước sau:

Tạo một đối tượng của MailMessage lớp.
Tải một tệp email vào MailMessage thể hiện.
Tạo một đối tượng của Attachment lớp và sử dụng nó trong một vòng lặp để trích xuất tất cả các tệp đính kèm.
Lưu tệp đính kèm và hiển thị nó trên màn hình.
Chỉ định địa chỉ người gửi và người nhận trong MailMessage thể hiện.
Bây giờ bạn có thể gửi email bằng SmtpClient lớp.

Đoạn mã dưới đây cho bạn cách trích xuất tệp đính kèm email:

|Tệp đính kèm đã được trích xuất trong email| | :- | ||

Lấy Content-Description từ Tệp Đính Kèm

API Aspose.Email cung cấp khả năng đọc Content-Description từ tiêu đề tệp đính kèm. Đoạn mã dưới đây cho bạn cách lấy mô tả nội dung từ một tệp đính kèm:

Xác Định Tệp Đính Kèm Tin Nhắn Nhúng

Làm việc với các đối tượng nhúng

Một đối tượng nhúng là đối tượng được tạo bằng một ứng dụng và nhúng vào tài liệu hoặc tệp được tạo bằng một ứng dụng khác. Ví dụ, một bảng tính Microsoft Excel có thể được nhúng trong báo cáo Microsoft Word, hoặc tệp video có thể được nhúng trong bản trình chiếu Microsoft PowerPoint. Khi một tệp được nhúng, thay vì chèn hoặc dán vào tài liệu khác, nó giữ nguyên định dạng ban đầu. Tài liệu nhúng có thể được mở trong ứng dụng gốc và chỉnh sửa.

Trích xuất các đối tượng nhúng

Đoạn mã sau đây minh họa cách trích xuất các đối tượng nhúng từ tệp email bằng Aspose.Email cho Python qua .NET.

Tạo một đối tượng của MailMessage lớp.
Tải một tệp email vào thể hiện MailMessage.
Tạo một vòng lặp và một thể hiện của Attachment lớp trong đó.
Lưu tệp đính kèm và hiển thị nó trên màn hình.
Chỉ định địa chỉ người gửi và người nhận trong thể hiện MailMessage.
Gửi email bằng cách sử dụng SmtpClient lớp.

|Các đối tượng nhúng đã trích xuất trong email| | :- | ||

Python-Net: Xử lý tệp đính kèm TNEF trong tin nhắn email

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

Tin nhắn email chứa tệp đính kèm TNEF

Transport Neutral Encapsulation Format (TNEF) là định dạng tệp đính kèm email độc quyền được Microsoft Outlook và Microsoft Exchange Server sử dụng. API Aspose.Email cho phép bạn đọc các tin nhắn email có tệp đính kèm TNEF và chỉnh sửa nội dung của chúng. Email sau đó có thể được lưu dưới dạng tin nhắn bình thường hoặc cùng định dạng, giữ lại các tệp đính kèm này. Bài viết này trình bày các mẫu mã khác nhau để làm việc với các tin nhắn chứa tệp đính kèm TNEF. Nó cũng minh họa cách tạo tệp EML TNEF từ các tệp MSG của Outlook.

Xác định tệp đính kèm TNEF trong email

Đoạn mã dưới đây cho bạn thấy cách phát hiện xem một email có chứa tệp đính kèm TNEF hay không:

from aspose.email import MailMessage

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

Đọc email trong khi giữ lại tệp đính kèm TNEF

Đoạn mã dưới đây cho bạn thấy cách đọc một tin nhắn và giữ lại các tệp đính kèm 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)

Chuyển đổi MSG sang TNEF

Các tệp Outlook MSG đôi khi chứa thông tin như bảng và kiểu văn bản có thể bị hỏng khi chuyển đổi sang EML. Tạo tin nhắn TNEF từ các tệp MSG như vậy cho phép bạn giữ nguyên định dạng và thậm chí gửi các tin nhắn này qua các khách hàng email mà vẫn giữ định dạng. The convert_as_tnef thuộc tính được sử dụng để thực hiện điều này. Đoạn mã dưới đây cho bạn thấy cách tạo email TNEF từ 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)

Tạo email TNEF

Mã mẫu dưới đây có thể được sử dụng để tạo một email ở định dạng TNEF:

Cấu hình các tùy chọn tệp bằng cách sử dụng MsgLoadOptions lớp.
Đảm bảo rằng các tệp đính kèm TNEF trong email được giữ lại khi tải tệp bằng cách đặt options.preserve_tnef_attachments to True.
Sử dụng MailMessage.load(eml_file_name, options) phương thức tải tệp email đầu vào trong khi áp dụng các tùy chọn đã cấu hình trước. Điều này đặc biệt đảm bảo rằng email đã tải giữ lại thông tin liên quan đến TNEF (như đính kèm hoặc định dạng Microsoft Outlook độc quyền).

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)

Phát hiện tin nhắn TNEF

Đoạn mã dưới đây cho bạn thấy cách phát hiện xem một tin nhắn có phải là TNEF hay không. The original_is_tnef thuộc tính của MailMessage đối tượng được kiểm tra để xác định xem email có nguyên gốc ở định dạng TNEF (Transport Neutral Encapsulation Format) không. Nếu is_tnef đánh giá thành True, nghĩa là email chứa mã hóa TNEF, thường xuất hiện trong các email đến từ Microsoft Outlook hoặc Exchange.

from aspose.email import MailMessage

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

Python-Net: Phát hiện và Xử lý Email Bị trả lại trong Python

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

Xử lý Email Bị trả lại

Thường rất phổ biến khi một tin nhắn gửi tới người nhận có thể bị trả lại vì một số lý do như địa chỉ người nhận không hợp lệ. API Aspose.Email có khả năng kiểm tra xem email có phải là email bị trả lại hay bình thường và xử lý nó. The check_bounced phương thức của MailMessage lớp trả về kết quả hợp lệ nếu tin nhắn email là tin bị trả lại. Đoạn mã sau cho bạn thấy cách xử lý các tin nhắn bị trả lại bằng cách sử dụng the BounceResult lớp cung cấp thông tin chi tiết về người nhận, hành động đã thực hiện và lý do của thông báo.

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: Sử dụng lọc thư rác Bayesian để phân loại email trong Python

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

Sử dụng Lọc Spam Bayesian

Aspose.Email cung cấp chức năng lọc email bằng bộ phân tích spam Bayesian. Nó cung cấp SpamAnalyzer lớp cho mục đích này. Bài viết này trình bày cách huấn luyện bộ lọc để phân biệt giữa spam và email thông thường dựa trên cơ sở dữ liệu từ.

Chỉ định đường dẫn thư mục cho các email ham (ham_folder), email spam (spam_folder), email kiểm tra (test_folder), và tệp cơ sở dữ liệu (database_file) cho bộ lọc spam.
Định nghĩa hàm trợ giúp print_result để in ra thông báo liệu một tin nhắn có được phân loại là spam hay không dựa trên xác suất spam đã tính.
Tạo Spam Analyzer bằng tệp cơ sở dữ liệu, huấn luyện nó với các email từ ham_folder (không phải spam) và spam_folder (spam), rồi lưu cơ sở dữ liệu đã huấn luyện.
Tải các tệp .eml từ ’test_folder’, phân tích mỗi tệp bằng SpamAnalyzer.test để lấy xác suất spam, và in tiêu đề email cùng phân loại bằng ‘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)