Documentation – Làm việc với các mục Outlook

Python-Net: Tạo và Lưu tệp MSG

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

Aspose.Email hỗ trợ tạo các tệp Outlook message (MSG). Bài viết này giải thích cách:

Tạo tin nhắn MSG.
Tạo tin nhắn MSG có đính kèm.
Tạo một tin nhắn MSG với phần thân RTF.
Lưu tin nhắn dưới dạng bản nháp.
Làm việc với nén phần thân.

Tạo và Lưu Tin Nhắn Outlook

Lớp MailMessage có phương thức Save() cho phép lưu các tệp Outlook MSG vào đĩa hoặc stream. Các đoạn mã dưới đây tạo một thể hiện của lớp MailMessage, đặt các thuộc tính như from, to, subject và body. Phương thức Save() nhận tên tệp làm đối số. Ngoài ra, các tin nhắn Outlook có thể được tạo với phần thân RTF được nén bằng cách sử dụng MapiConversionOptions. Để thiết lập, tạo một ứng dụng Windows mới và thêm tham chiếu đến thư viện Aspose.Email dll vào dự án.

Tạo một thể hiện mới của lớp MailMessage và đặt các thuộc tính From, To, Subject và Body.
Gọi phương thức FromMailMessage của lớp MailMessage, phương thức này chấp nhận đối tượng kiểu MailMessage. Phương thức FromMailMessage() chuyển MailMessage thành một MailMessage (MSG).
Gọi phương thức MapiMessage.Save() để lưu tệp MSG.

Viết đoạn mã sau trong sự kiện click của nút điều khiển trong ứng dụng Windows.

Tạo Tệp MSG với Đính Kèm

Trong ví dụ trên, chúng tôi đã tạo một tệp MSG đơn giản. Aspose.Email cũng hỗ trợ lưu các tệp tin nhắn có đính kèm. Tất cả những gì bạn cần làm là thêm các tệp đính kèm vào thể hiện MailMessage. Thêm đính kèm bằng cách gọi phương thức Add() trên bộ sưu tập MailMessage.Attachments. Thêm một listbox vào biểu mẫu đã tạo ở trên và thêm hai nút, mỗi nút cho việc bổ sung và xóa bỏ đính kèm. Ứng dụng thêm đính kèm hoạt động như sau:

Khi nút Add Attachment được nhấn, một Open File Dialog sẽ được hiển thị để giúp người dùng duyệt và chọn tệp đính kèm.
Khi một tệp đã được chọn, đường dẫn đầy đủ sẽ được thêm vào danh sách.
Khi tệp MSG được tạo, các đường dẫn tệp đính kèm được lấy từ danh sách và thêm vào bộ sưu tập MailMessage.Attachments.

Viết đoạn mã sau trong sự kiện click của nút Add Attachment.

Thêm mã cho việc thêm các đính kèm vào thể hiện MailMessage. Mã cuối cùng cho hàm Write Msg được viết như dưới đây.

Tạo Tệp MSG với Phần Thân RTF

Bạn cũng có thể tạo các tệp Outlook Message (MSG) với phần thân văn bản phong phú (RTF) bằng Aspose.Email. Phần thân RTF hỗ trợ định dạng văn bản. Tạo một tệp bằng cách đặt thuộc tính MailMessage.HtmlBody. Khi bạn chuyển một thể hiện MailMessage sang một thể hiện MailMessage, phần thân HTML sẽ được chuyển đổi thành RTF. Nhờ vậy, định dạng của phần thân email được giữ nguyên.

Ví dụ sau tạo một tệp MSG với phần thân RTF. Có một tiêu đề, định dạng in đậm và gạch dưới được áp dụng trong phần thân HTML. Định dạng này được giữ lại khi HTML được chuyển sang RTF.

Lưu Tin Nhắn ở Trạng Thái Bản Nháp

Email được lưu dưới dạng bản nháp khi người dùng đã bắt đầu chỉnh sửa nhưng muốn quay lại hoàn thiện sau. Aspose.Email hỗ trợ lưu tin nhắn email ở trạng thái bản nháp bằng cách đặt cờ cho tin nhắn. Dưới đây là mã mẫu để lưu một tin nhắn Outlook (MSG) dưới dạng bản nháp.

Hệ quả của Nén Phần Thân

Phương pháp nén phần thân RTF có thể được sử dụng để tạo tệp MSG có kích thước nhỏ hơn. Tuy nhiên, điều này làm tốc độ chậm hơn. Để tạo tin nhắn với tốc độ cải thiện, đặt cờ này thành false. Cờ này, về mặt ngược lại, ảnh hưởng đến các PST được tạo: các tệp MSG nhỏ hơn dẫn đến PST nhỏ hơn, và các tệp MSG lớn gây ra việc tạo PST chậm hơn.

Python-Net: Tải, Xem và Phân tích tệp MSG

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

Chủ đề này giải thích cách tải tệp tin Microsoft Outlook (*.msg). The MapiMessage lớp được sử dụng để tải các tệp MSG, và cung cấp một số hàm tải tĩnh cho các kịch bản khác nhau. Đoạn mã sau cho bạn thấy cách tải các tệp MSG từ tệp hoặc từ luồng.

Try it out!

Phân tích tệp email trực tuyến miễn phí Ứng dụng Phân tích Aspose.Email.

Tải các Tệp MSG

Đoạn mã sau đây cho bạn thấy cách tải các tệp MSG.

from aspose.email.mapi import MapiMessage

# Create an instance of MapiMessage from file
msg = MapiMessage.from_file("message.msg")

# Get subject
print("Subject: " + msg.subject)

# Get from address
print("From: " + msg.sender_email_address)

# Get body
print("Body: " + msg.body)

# Get recipients information
recipients = ", ".join([r.email_address for r in msg.recipients])
print("Recipients: " + recipients)

# Get attachments
for att in msg.attachments:
    print(att.file_name)
    print(att.display_name)

Tải từ Luồng

Đoạn mã sau cho bạn thấy cách tải tệp từ luồng.

from aspose.email.mapi import MapiMessage
import io

# Read the file into a byte array
file_path = dir_path + "message.msg"
with open(file_path, "rb") as file:
    bytes_data = file.read()

# Create a memory stream from the byte array
stream = io.BytesIO(bytes_data)
stream.seek(0)

# Create an instance of MapiMessage from the stream
msg = MapiMessage.from_stream(stream)

# Get subject
print("Subject: " + msg.subject)

# Get from address
print("From: " + msg.sender_email_address)

# Get body
print("Body: " + msg.body)

Chuyển đổi EML sang MSG giữ định dạng EML nhúng

Các tệp EML có thể được tải vào MapiMessage lớp bằng cách khởi tạo một MailMessage đối tượng và truyền nó vào phương pháp MapiMessage.from_mail_message. Nếu tệp EML chứa các tệp EML nhúng, sử dụng MapiConversionOptions.PreserveEmbeddedMessageFormat để giữ lại định dạng của các tệp EML nhúng. Đoạn mã dưới đây cho thấy cách tải các tệp EML vào MapiMessage trong khi bảo tồn định dạng của các tệp EML nhúng.

from aspose.email import MailMessage, EmlLoadOptions
from aspose.email.mapi import MapiMessage, MapiConversionOptions, OutlookMessageFormat

eml_file = dir_path + "message.eml"

# Load the EML file
eml_options = EmlLoadOptions()
eml = MailMessage.load(eml_file, eml_options)

# Create MapiConversionOptions
conversion_options = MapiConversionOptions()
conversion_options.format = OutlookMessageFormat.UNICODE

# Preserve Embedded Message Format
conversion_options.preserve_embedded_message_format = True

# Convert EML to MSG with options
msg = MapiMessage.from_mail_message(eml, conversion_options)

Python-Net: Quản Lý Các Tệp Tin Nhắn với Aspose.Email.Outlook

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

Xác định loại mục MAPI trong thư mục PST

Một tệp PST thường chứa các loại dữ liệu khác nhau, như tin nhắn email, sự kiện lịch, danh bạ và hơn nữa. MapiItemType lớp của Aspose.Email cho phép bạn truy cập và phân loại các loại mục MAPI khác nhau trong tệp PST. Đoạn mã dưới đây minh họa cách xác định loại mục MAPI trong một thư mục PST:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("test.pst")
folder = pst.root_folder.get_sub_folder("Calendar")
for messageInfo in folder.enumerate_messages():
    msg = pst.extract_message(messageInfo)

    # Get the class type based on msg.SupportedType
    item_type = msg.supported_type

    # Non-supported type. It cannot be accessed as appropriate item type.
    if item_type == ae.mapi.MapiItemType.NONE:
        print("Item type not supported")
    # An email message.
    elif item_type == ae.mapi.MapiItemType.MESSAGE:
        # You can access to MapiMessage properties there.
        # A subject for example
        print(msg.subject)
    # A contact item. Can be accessed as MapiContact.
    elif item_type == ae.mapi.MapiItemType.CONTACT:
        contact = msg.to_mapi_message_item()
        # You can access to MapiContact properties there. 
        # A name_info.display_name for example. 
        print(contact.name_info.display_name)
    # A calendar item. Can be accessed as MapiCalendar.
    elif item_type == ae.mapi.MapiItemType.CALENDAR:
        calendar = msg.to_mapi_message_item()
        # You can access to MapiCalendar properties there. 
        # A location for example. 
        print(calendar.location)
    # A distribution list. Can be accessed as MapiDistributionList.
    elif item_type == ae.mapi.MapiItemType.DIST_LIST:
        dlist = msg.to_mapi_message_item()
        # You can access to MapiDistributionList properties there
    # A Journal entry. Can be accessed as MapiJournal.
    elif item_type == ae.mapi.MapiItemType.JOURNAL:
        journal = msg.to_mapi_message_item()
        # You can access to MapiJournal properties there
    # A StickyNote. Can be accessed as MapiNote.
    elif item_type == ae.mapi.MapiItemType.NOTE:
        note = msg.to_mapi_message_item()
        # You can access to MapiNote properties there
    # A Task item. Can be accessed as MapiTask.
    elif item_type == ae.mapi.MapiItemType.TASK:
        task = msg.to_mapi_message_item()
        # You can access to MapiTask properties there

Chuyển Đổi MSG sang Tin MIME

API Aspose.Email cung cấp khả năng chuyển đổi tệp MSG sang tin nhắn MIME bằng phương thức ToMailMessage.

Đặt thời gian chờ cho việc chuyển đổi và tải tin nhắn

Để giới hạn thời gian chuyển đổi tin nhắn tính bằng mili giây (giá trị mặc định 3 giây), thuộc tính timeout của MailConversionOptions lớp được sử dụng.

Dưới đây là cách bạn có thể đặt thời gian chờ cho các quá trình chuyển đổi và tải tin nhắn:

import aspose.email as ae

msg = ae.mapi.MapiMessage.load("my.msg")
options = ae.mapi.MailConversionOptions()
options.timeout = 5000
mailMessage = msg.to_mail_message(options)

Bằng cách đặt thời gian chờ cho các quá trình chuyển đổi và tải tin nhắn, bạn có thể kiểm soát thời gian tối đa mà các thao tác này được phép chạy. Sau khi đặt thời gian chờ, bạn có thể tiếp tục các quá trình chuyển đổi và tải tin nhắn của mình.

Xử lý tệp Outlook Template (OFT)

Tải, Sửa đổi và Lưu một Tệp OFT

Các mẫu Outlook (OFT) cung cấp một cách tiện lợi để tối ưu hóa quy trình gửi các email lặp lại. Thay vì soạn cùng một email từ đầu mỗi lần, bạn có thể tạo một tin nhắn trong Outlook và lưu nó dưới dạng Outlook Template (OFT). Sau này, khi cần gửi một tin nhắn tương tự, bạn có thể nhanh chóng tạo ra từ mẫu. Cách này giúp bạn tiết kiệm công sức việc viết lại cùng nội dung trong phần thân tin nhắn, xác định tiêu đề, định dạng và các yếu tố khác.

Aspose.Email MailMessage lớp cung cấp công cụ mạnh mẽ để tải và thao tác các tệp mẫu Outlook (OFT). Khi một mẫu Outlook được tải vào một thể hiện của lớp MailMessage, bạn có thể dễ dàng cập nhật các thuộc tính như người gửi, người nhận, nội dung tin nhắn, chủ đề và các thuộc tính khác.

import aspose.email as ae

# Load the OFT file
oft_file_path = "your_template.oft"
mail_message = ae.MailMessage.load(oft_file_path)

# Update properties as needed
mail_message.subject = "Updated Subject"
mail_message.body = "Updated body text."

# Save the updated message as an MSG file
msg_file_path = "updated_message.msg"
mail_message.save(msg_file_path, ae.MailMessageSaveType.outlook_message_format_unicode)

print(f"Updated message saved to {msg_file_path}")

Sau khi thực hiện các cập nhật cần thiết, bạn có thể gửi email bằng SmtpClient lớp:

# Send the email
smtpClient.send(message)

Lưu Tệp MSG Outlook dưới dạng Mẫu

Đối với mục đích này, bạn có thể sử dụng MailMessage lớp để tạo một email, sau đó lưu nó dưới dạng tệp OFT. Mẫu mã dưới đây sẽ cho bạn thấy cách lưu email dưới dạng Outlook Template:

import aspose.email as ae

# Create a new MailMessage
message = ae.MailMessage()
message.subject = "Sample Outlook Template"
message.html_body = "<html><body>This is the body of the email.</body></html>"
message.from_address = ae.MailAddress("your.email@example.com", "Your Name")

# Save the MailMessage as an Outlook Template (OFT) file
oft_file_path = "sample_template.oft"
message.save(oft_file_path, ae.SaveOptions.default_oft)

print(f"Outlook Template saved as {oft_file_path}")

OFT hay MSG: Xác định loại của một MapiMessage

Đoạn mã dưới đây minh họa cách xác định xem một tin nhắn MAPI đã tải có phải là tin nhắn email tiêu chuẩn hay là Outlook Template (OFT) không:

msg = ae.mapi.MapiMessage.Load("message.msg");
isOft = msg.is_template # returns false

msg = ae.mapi.MapiMessage.Load("message.oft");
isOft = msg.IsTemplate; # returns true

Sau khi tải tệp MSG, mã kiểm tra xem thuộc tính is_template của MapiMessaage lớp trả về True hoặc False. Nếu trả về false, tin nhắn được tải là một tin thư chuẩn, không phải Mẫu Outlook; ngược lại, nếu trả về true, tin nhắn không phải là tin thư chuẩn mà là một Mẫu Outlook.

Lưu MapiMessage hoặc MailMessage dưới dạng OFT

Cái SaveOptions là một lớp cơ sở trừu tượng cho các lớp cho phép người dùng chỉ định các tùy chọn bổ sung khi lưu MailMessage vào một định dạng cụ thể. Mẫu mã dưới đây minh họa cách lưu tin nhắn dưới định dạng OFT:

import aspose.email as ae

# Save the MailMessage to OFT format
eml = ae.MailMessage.load("message.eml")

eml.save("message.oft", ae.SaveOptions.default_oft)

# or alternative way 2
save_options = ae.MsgSaveOptions(ae.MailMessageSaveType.outlook_template_format)
eml.save("message.oft", save_options)

# or alternative way 3
save_options = ae.SaveOptions.create_save_options(ae.MailMessageSaveType.outlook_template_format)
eml.save("message.oft", save_options)

# Save the MapiMessage to OFT format
msg = ae.mapi.MapiMessage.load("message.msg")

msg.save("message.oft", ae.SaveOptions.default_oft)

# or alternative way 2
save_options = ae.MsgSaveOptions(ae.MailMessageSaveType.outlook_template_format)
msg.save("message.oft", save_options)

# or alternative way 3
save_options = ae.SaveOptions.create_save_options(ae.MailMessageSaveType.outlook_template_format)
msg.save("message.oft", save_options)

Quản lý tin nhắn với chữ ký số

Thư viện cung cấp LoadOptions lớp, một lớp cơ sở trừu tượng cho các lớp cho phép người dùng chỉ định các tùy chọn bổ sung khi tải MailMessage từ một định dạng cụ thể. Tùy chọn giữ chữ ký được đặt mặc định.

Chuyển đổi từ EML sang MSG giữ chữ ký

Đoạn mã mẫu bên dưới minh họa cách tải một tin nhắn, chuyển đổi nó sang định dạng MSG và lưu dưới dạng MSG (chữ ký được giữ nguyên theo mặc định):


import aspose.email as ae

# Load mail message
loadOptions = ae.EmlLoadOptions()
message = ae.MailMessage.load("Message.eml", loadOptions)
# Save as MSG
message.save("ConvertEMLToMSG_out.msg", ae.SaveOptions.default_msg_unicode)

Chuyển đổi tin nhắn S/MIME từ MSG sang EML

Aspose.Email cho phép bạn chuyển đổi từ MSG sang EML giữ nguyên chữ ký số như được minh họa trong đoạn mã sau.

import aspose.email as ae

# Load mail message
loadOptions = ae.EmlLoadOptions()
smime_eml = ae.MailMessage.load("smime.eml", loadOptions)

conversion_options = ae.mapi.MapiConversionOptions(ae.mapi.OutlookMessageFormat.UNICODE)
msg = ae.mapi.MapiMessage.from_mail_message(smime_eml, conversion_options)
# Save File to disk
msg.save("ConvertMIMEMessagesFromMSGToEML_out.msg")

Đặt Danh mục Màu cho Tệp Outlook MSG

Đôi khi bạn có thể cần phân biệt các email quan trọng và sắp xếp chúng một cách trực quan. Thư viện cung cấp cách thực hiện điều này bằng cách gán một màu cụ thể cho một mục tin nhắn. Khi bạn đặt danh mục màu cho một mục, nó cho phép bạn dễ dàng nhận diện và tìm kiếm các mục liên quan ngay lập tức. Sử dụng FollowUpManager lớp để đặt danh mục màu cho một tin nhắn như trong ví dụ mã sau:


import aspose.email as ae

msg = ae.mapi.MapiMessage.load("my.msg")

# Add Two categories
ae.mapi.FollowUpManager.add_category(msg, "Purple Category")
ae.mapi.FollowUpManager.add_category(msg, "Red Category")

# Retrieve the list of available categories
categories = ae.mapi.FollowUpManager.get_categories(msg)

# Remove the specified category and then Clear all categories
ae.mapi.FollowUpManager.remove_category(msg, "Red Category")
ae.mapi.FollowUpManager.clear_categories(msg)

Truy cập thông tin Follow Up từ tệp MSG

Trích xuất Thông tin Đọc và Biên nhận Giao hàng

Mẫu mã dưới đây minh họa cách trích xuất thông tin người nhận và trạng thái theo dõi của họ từ tệp tin Outlook (MSG):

import aspose.email as ae

msg = ae.mapi.MapiMessage.load("received.msg")

for recipient in msg.recipients:
    print(f"Recipient: {recipient.display_name}")
    print(f"Delivery time:  {recipient.properties[ae.mapi.MapiPropertyTag.RECIPIENT_TRACKSTATUS_TIME_DELIVERY]}")
    print(f"Read time:  {recipient.properties[ae.mapi.MapiPropertyTag.RECIPIENT_TRACKSTATUS_TIME_READ]}")

Tạo Tin Nhắn Forward và Reply

Aspose.Email cung cấp các cách đơn giản để tạo tin nhắn chuyển tiếp và trả lời dựa trên các tin nhắn hiện có.

Tạo Tin Nhắn Chuyển Tiếp

Bạn có thể sử dụng ForwardMessageBuilder lớp để tạo tin chuyển tiếp bằng cách đặt tin gốc, người gửi, người nhận, tiêu đề và nội dung. Tin chuyển tiếp có thể bao gồm tin gốc dưới dạng tệp đính kèm hoặc là nội dung của tin chuyển tiếp. Bạn có thể linh hoạt tùy chỉnh các thuộc tính bổ sung như tệp đính kèm, tiêu đề và tùy chọn định dạng. Đoạn mã dưới đây cho thấy cách tạo một tin chuyển tiếp:


import aspose.email as ae

msg = ae.mapi.MapiMessage.load("original.msg")

builder = ae.tools.ForwardMessageBuilder()
builder.addition_mode = ae.tools.OriginalMessageAdditionMode.TEXTPART

forwardMsg = builder.build_response(msg)
forwardMsg.save("forward_out.msg")

Tạo tin nhắn trả lời

Cái ReplyMessageBuilder lớp được dùng để cấu hình cài đặt trả lời, bao gồm tin gốc, người gửi, người nhận, chế độ trả lời, tiền tố tiêu đề và nội dung tin trả lời. Tin trả lời có thể được tạo ở các chế độ khác nhau như "Trả lời người gửi" hoặc "Trả lời tất cả" tùy nhu cầu. Bạn có thể tùy chỉnh các thuộc tính như tệp đính kèm, tiêu đề và tùy chọn định dạng cho tin trả lời. Đoạn mã dưới đây cho thấy cách tạo một tin chuyển tiếp:

import aspose.email as ae

msg = ae.mapi.MapiMessage.load("original.msg")

builder = ae.tools.ReplyMessageBuilder()

# Set ReplyMessageBuilder Properties
builder.reply_all = True
builder.addition_mode = ae.tools.OriginalMessageAdditionMode.TEXTPART
builder.response_text = "<p><b>Dear Friend,</b></p> I want to do is introduce my co-author and co-teacher. <p><a href=\"www.google.com\">This is a first link</a></p><p><a href=\"www.google.com\">This is a second link</a></p>";

replyMsg = builder.build_response(msg)
replyMsg.save("reply_out.msg")

Python-Net: Làm việc với Danh sách Phân phối

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

Bạn có thể tạo một danh sách phân phối bằng API Aspose.Email, đây là tập hợp của nhiều liên hệ. Danh sách phân phối có thể được lưu vào đĩa ở định dạng Outlook MSG và có thể được xem/điều chỉnh bằng cách mở trong MS Outlook.

Tạo và Lưu Danh sách Phân phối

Đoạn mã sau đây cho bạn thấy cách tạo và lưu một danh sách phân phối.

Đọc Danh sách Phân phối từ PST

Đoạn mã sau đây cho bạn thấy cách đọc một danh sách phân phối từ tệp PST.

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file( "your_pst_file.pst")
folder = pst.root_folder.get_sub_folder("Contacts")
for messageInfo in folder.enumerate_messages():
    msg = pst.extract_message(messageInfo)

    dlist = msg.to_mapi_message_item()
    if isinstance(dlist, ae.mapi.MapiDistributionList):
        for member in dlist.members:
            print("Member Display Name:", member.display_name)
            print("Member Email Address:", member.email_address)

Python-Net: Làm việc với Follow Up và Ngày Hạn cho Tệp MSG của Outlook

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

Một cờ theo dõi đánh dấu một tin nhắn email cho một hành động nào đó. Microsoft Outlook cho phép người dùng gắn cờ vào tin nhắn và, trong cài đặt cờ, chỉ định ngày đến hạn cho việc theo dõi. Microsoft Outlook gửi lời nhắc tới người nhận để thúc đẩy họ theo dõi email. Việc gắn cờ email và đặt ngày đến hạn một cách lập trình cho phép các nhà phát triển phần mềm tự động hóa một số loại email và giúp người nhận nhớ thực hiện hành động. Ví dụ, nó có thể được sử dụng để gửi tin nhắn hàng tháng cho đội bán hàng để nhắc họ hoàn thành báo cáo; hoặc gửi tin nhắn tới toàn bộ nhân viên để nhắc họ về một cuộc họp công ty. Aspose.Email cho .NET hỗ trợ đặt cờ theo dõi và ngày đến hạn cho các đối tượng MapiMessage bằng FollowUpManager và FollowUpOptions. Có một số biến thể trong việc đặt cờ theo dõi trên một tin nhắn. Tất cả chúng được sử dụng trong mẫu mã dưới đây:

Đặt cờ theo dõi cho một tin nhắn
Thêm ngày đến hạn và ngày nhắc nhở vào tin nhắn
Thêm một cờ vào tin nhắn của người nhận.
Đánh dấu là hoàn thành.
Xóa cờ.
Đọc các tùy chọn follow up.

Đặt cờ FollowUp

Đoạn mã sau cho bạn thấy cách đặt một cờ followUp.

import aspose.email as ae
from datetime import datetime, timedelta

# Create a new MailMessage
mail_msg = ae.MailMessage()
mail_msg.from_address = ae.MailAddress("from@domain.com")
mail_msg.to.append(ae.MailAddress("to@domain.com"))
mail_msg.body = "This message will test if follow-up options can be added to a new MAPI message."

# Convert MailMessage to MapiMessage
mapi = ae.mapi.MapiMessage.from_mail_message(mail_msg)

# Define follow-up options
dt_start_date = datetime(2013, 5, 23, 14, 40, 0)
dt_reminder_date = datetime(2013, 5, 23, 16, 40, 0)
dt_due_date = dt_reminder_date + timedelta(days=1)

options = ae.mapi.FollowUpOptions("Follow Up", dt_start_date, dt_due_date, dt_reminder_date)

# Set follow-up options for the MapiMessage
ae.mapi.FollowUpManager.set_options(mapi, options)

# Save the MapiMessage
mapi.save("SetFollowUpFlag_out.msg")

Đặt Follow Up cho Người Nhận

Đoạn mã sau cho bạn thấy cách đặt follow Up cho người nhận.

import aspose.email as ae
from datetime import datetime

# Create a new MailMessage
mail_msg = ae.MailMessage()
mail_msg.from_address = ae.MailAddress("from@domain.com")
mail_msg.to.append(ae.MailAddress("to@domain.com"))
mail_msg.body = "This message will test if follow-up options can be added to a new MAPI message."

# Convert MailMessage to MapiMessage
mapi = ae.mapi.MapiMessage.from_mail_message(mail_msg)

# Mark the message as draft
mapi.set_message_flags(ae.mapi.MapiMessageFlags.UNSENT)

dt_reminder_date = datetime(2013, 5, 23, 16, 40, 0)

# Add the follow-up flag for recipients
ae.mapi.FollowUpManager.set_flag_for_recipients(mapi, "Follow up", dt_reminder_date)

# Save the MapiMessage
mapi.save("SetFollowUpForRecipients_out.msg")

Đánh dấu cờ FollowUp là Đã Hoàn Thành

Đoạn mã sau cho bạn thấy cách đánh dấu cờ followUp là đã hoàn thành.

import aspose.email as ae

# Load the MapiMessage from file
mapi_message = ae.mapi.MapiMessage.load("Message.msg")

# Mark the message as completed
ae.mapi.FollowUpManager.mark_as_completed(mapi_message)

# Save the updated MapiMessage
mapi_message.save("MarkedCompleted_out.msg")

Xóa cờ FollowUp

Đoạn mã sau cho bạn thấy cách xóa cờ followUp.

import aspose.email as ae

# Load the MapiMessage from file
mapi_message = ae.mapi.MapiMessage.load("message.msg")

# Clear the follow-up flag
ae.mapi.FollowUpManager.clear_flag(mapi_message)

# Save the updated MapiMessage
mapi_message.save("RemoveFollowUpflag_out.msg")

Đọc các tùy chọn cờ follow-up cho tin nhắn

Đoạn mã sau cho bạn thấy cách đọc các tùy chọn cờ theo dõi cho một tin nhắn.

import aspose.email as ae

# Load the MapiMessage from file
mapi_message = ae.mapi.MapiMessage.load("message.msg")

# Get the follow-up options
options = ae.mapi.FollowUpManager.get_options(mapi_message)

Python-Net: Làm việc với các thuộc tính MAPI

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

Truy cập và Đặt Thuộc tính MAPI Outlook

Lớp MapiProperty đại diện cho một thuộc tính MAPI, bao gồm:

Name: một chuỗi đại diện cho tên của thuộc tính.
Tag: một số nguyên dài đại diện cho thẻ của thuộc tính.
Data: một mảng byte đại diện cho dữ liệu của thuộc tính.

Lấy Thuộc tính MAPI bằng Thẻ Thuộc tính MAPI

Để lấy các thuộc tính MAPI:

Tạo một thể hiện của MapiMessage bằng cách tải từ tệp hoặc luồng.
Lấy MapiProperty từ MapiMessage.Properties bằng các khóa MapiPropertyTag.
Lấy Dữ liệu của MapiProperty bằng phương pháp GetX.

Đoạn mã sau cho bạn thấy cách lấy thuộc tính MAPI bằng thẻ thuộc tính MAPI.

Đặt Các Thuộc tính MAPI

Đoạn mã dưới đây cho bạn thấy cách đặt các thuộc tính MAPI.

trong đó định nghĩa của phương thức convertDateTime như sau:

Đọc các thuộc tính MAPI có tên từ các tệp Outlook MSG

Aspose.Email cung cấp một bộ API để làm việc với tệp MSG, bao gồm việc trích xuất các thuộc tính MAPI có tên.

Đọc các thuộc tính MAPI có tên từ tệp MSG

Để đọc các thuộc tính MAPI có tên, chúng ta có thể sử dụng thuộc tính named_properties của MapiMessage lớp. Mẫu mã sau đây cho thấy cách tải một tin nhắn, truy xuất tất cả các thuộc tính MAPI có tên, lặp qua từng thuộc tính để kiểm tra giá trị của chúng:

import aspose.email as ae

msg = ae.mapi.MapiMessage.load("my.msg")

# Get all named MAPI properties
properties = msg.named_properties.values
# Read all properties in foreach loop
for prop in properties:
    #  Read any specific property
    if prop.descriptor.canonical_name == "PidLidSideEffects":
        print(f"{prop.descriptor.canonical_name} = {prop}")
    if prop.descriptor.canonical_name == "PidLidInternetAccountName":
        print(f"{prop.descriptor.canonical_name} = {prop}")

Đọc Thuộc tính MAPI Được Đặt Tên từ Đính kèm

Aspose.Email cho phép truy xuất tất cả các thuộc tính MAPI có tên của một tệp đính kèm. Mẫu mã sau đây cho thấy cách đọc các thuộc tính MAPI có tên từ các tệp đính kèm:

import aspose.email as ae

msg = ae.mapi.MapiMessage.load("my.msg")

# Get all named MAPI properties
attach_properties = msg.attachments[0].named_properties.values
# Read all properties in foreach loop
for prop in attach_properties:
    #  Read any specific property
    if prop.descriptor.name == "AttachmentOriginalUrl":
        print(f"{prop.descriptor.name} = {prop.get_string()}")
    if prop.descriptor.name == "AttachmentWasSavedToCloud":
        print(f"{prop.descriptor.name} = {prop.get_boolean()}")

Xóa Thuộc tính khỏi MSG và Đính kèm

Mẫu mã này minh họa việc tạo một tin nhắn Outlook MSG với nội dung thân và một tệp tin tin nhắn đính kèm. Nó cũng trình bày cách xóa thuộc tính đính kèm khỏi tin nhắn đã tạo.

import aspose.email as ae

# create an MSG
msg = ae.mapi.MapiMessage("from@doamin.com", "to@domain.com", "subject", "body");
msg.set_body_content("<html><body><h1>This is the body content</h1></body></html>", ae.mapi.BodyContentType.HTML)

# load message and add it to created MSG as attachment
attachment = ae.mapi.MapiMessage.load(attach.msg")
msg.attachments.add("Outlook2 Test subject.msg", attachment)

# count of attachment properties before removal
print(f"Before removal = {msg.attachments[0].properties.count}")

# Delete anyone attachment property
msg.attachments[0].remove_property(923467779)

# count of attachment properties after removal
print(f"Before removal = {msg.attachments[0].properties.count}")

Python-Net: Làm việc với Đính Kèm Tin Nhắn

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

Quản lý tệp đính kèm với Aspose Outlook

Tạo và Lưu các tệp Outlook Message (MSG) giải thích cách tạo và lưu tin nhắn, và cách tạo tệp MSG có đính kèm. Bài viết này trình bày cách quản lý các tệp đính kèm Microsoft Outlook bằng Aspose.Email. Các tệp đính kèm từ một tệp tin nhắn được truy cập và lưu vào đĩa bằng thuộc tính Attachments của lớp MapiMessage. Thuộc tính Attachments là một bộ sưu tập thuộc loại lớp MapiAttachmentCollection.

Kiểm tra tệp đính kèm là Inline hay Regular

"Inline" và "Regular" đề cập tới cách chúng được bao gồm trong một tin nhắn email. Đính kèm Regular là các tệp được đính kèm theo cách truyền thống. Chúng thường hiển thị trong danh sách trong khách hàng email và có thể được người nhận tải xuống và lưu vào bộ nhớ cục bộ. Đính kèm Inline, còn gọi là nhúng hoặc ảnh inline, thường được dùng để chèn hình ảnh hoặc phương tiện khác vào phần thân của email. Chúng không hiển thị trong danh sách riêng mà được hiển thị trực tiếp trong nội dung email, chẳng hạn trong phần thân email. Điều này cho phép bạn bao gồm hình ảnh hoặc phương tiện khác là một phần của nội dung tin nhắn. Đoạn mã dưới đây minh họa cách xác định xem một đính kèm là inline hay regular:

import aspose.email as ae

msg = ae.mapi.MapiMessage.load("message.msg")

for attachment in msg.attachments:
    print(f"{attachment.display_name}:{attachment.is_inline}")

Lưu tệp đính kèm từ tệp Outlook Message (MSG)

Để lưu các đính kèm từ tệp MSG:

Lặp qua bộ sưu tập MapiAttachmentCollection và lấy các tệp đính kèm riêng lẻ.
Để lưu các tệp đính kèm, gọi phương thức Save() của lớp MapiAttachment.

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

import aspose.email as ae

data_dir = "C://dataDir/"
file_name = "message.msg"

# Create an instance of MapiMessage from file
message = ae.mapi.MapiMessage.from_file(data_dir + file_name)

# Iterate through the attachments collection
for attachment in message.attachments:
    # Save the individual attachment
    attachment.save(data_dir + attachment.file_name)

Lấy các tệp đính kèm tin nhắn lồng nhau

Các tệp đính kèm OLE nhúng cũng xuất hiện trong bộ sưu tập Attachment của lớp MapiMessage. Ví dụ mã dưới đây phân tích tệp tin tin nhắn để tìm các tệp đính kèm tin nhắn nhúng và lưu chúng vào đĩa. Phương thức tĩnh FromProperties() của lớp MapiMessage có thể tạo một tin nhắn mới từ tệp đính kèm nhúng. Đoạn mã dưới đây cho bạn thấy cách lấy các tệp đính kèm tin nhắn lồng nhau.

import aspose.email as ae

eml = ae.mapi.MapiMessage.load("my.msg")

# Create a MapiMessage object from the individual attachment
get_attachment = ae.mapi.MapiMessage.from_properties(eml.attachments[0].object_data.properties)

# Create an object of type MailMessageInterpreter from the above message and save the embedded message to a file on disk
mail_message = get_attachment.to_mail_message(ae.mapi.MailConversionOptions())
mail_message.save("NestedMailMessageAttachments_out.eml", ae.SaveOptions.default_eml)

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

Thư viện Aspose Outlook cung cấp chức năng xóa tệp đính kèm khỏi các tệp Microsoft Outlook Message (.msg):

Gọi phương thức RemoveAttachments(). Nó nhận đường dẫn của tệp tin tin nhắn làm tham số. Phương thức này được triển khai dưới dạng public static, vì vậy bạn không cần khởi tạo đối tượng.

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

import aspose.email as ae

ae.mapi.MapiMessage.remove_attachments("AttachmentsToRemove_out.msg")

Bạn cũng có thể gọi phương thức tĩnh DestoryAttachment() của lớp MapiMessage. Nó hoạt động nhanh hơn RemoveAttachment() vì phương thức RemoveAttachment() phải phân tích tệp tin tin nhắn.

import aspose.email as ae

# Destroy attachments in the MapiMessage
ae.mapi.MapiMessage.destroy_attachments(data_dir + "AttachmentsToDestroy_out.msg")

Thêm tệp đính kèm MSG

Một tin nhắn Outlook có thể chứa các tin nhắn Outlook khác dưới dạng tệp đính kèm, có thể là tin nhắn thường hoặc nhúng. MapiAttachmentCollection cung cấp các phương thức Add được nạp chồng để tạo tin nhắn Outlook với cả hai loại tệp đính kèm.

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 tham chiếu vào MapiMessage

"Tệp đính kèm tham chiếu" thường chỉ một tệp đính kèm chứa tham chiếu hoặc liên kết đến một tài nguyên bên ngoài thay vì tệp thực tế. Những tham chiếu này thường được sử dụng trong email HTML để liên kết đến hình ảnh hoặc tài nguyên lưu trên máy chủ từ xa. Thay vì nhúng toàn bộ tệp, tệp đính kèm tham chiếu chỉ bao gồm một URL hoặc tham chiếu đến nội dung bên ngoài.

Aspose.Email cung cấp một bộ công cụ để hiển thị đúng các tệp đính kèm tham chiếu, được trình bày trong mẫu mã dưới đây:

import aspose.email as ae

msg = ae.mapi.MapiMessage.load("message.msg")

# Add reference attachment
msg.attachments.add("Document.pdf",
    "https://drive.google.com/file/d/1HJ-M3F2qq1oRrTZ2GZhUdErJNy2CT3DF/",
    "https://drive.google.com/drive/my-drive",
    "GoogleDrive")

# Also, you can set additional attachment properties
msg.attachments[0].set_property(ae.mapi.KnownPropertyList.ATTACHMENT_PERMISSION_TYPE, int(ae.AttachmentPermissionType.ANYONE_CAN_EDIT))
msg.attachments[0].set_property(ae.mapi.KnownPropertyList.ATTACHMENT_ORIGINAL_PERMISSION_TYPE, 0)
msg.attachments[0].set_property(ae.mapi.KnownPropertyList.ATTACHMENT_IS_FOLDER, False)
msg.attachments[0].set_property(ae.mapi.KnownPropertyList.ATTACHMENT_PROVIDER_ENDPOINT_URL, "")
msg.attachments[0].set_property(ae.mapi.KnownPropertyList.ATTACHMENT_PREVIEW_URL, "")
msg.attachments[0].set_property(ae.mapi.KnownPropertyList.ATTACHMENT_THUMBNAIL_URL, "")
# Finally save the message
msg.save("msg_with_ref_attach.msg")

Nhúng một tin nhắn dưới dạng tệp đính kèm

Đoạn mã dưới đây cho bạn thấy cách các tệp MSG Outlook nhúng trong một tệp MSG chứa PR_ATTACH_METHOD có giá trị bằng 5.

import aspose.email as ae

# Create a new MapiMessage
message = ae.mapi.MapiMessage("from@test.com", "to@test.com", "Subj", "This is a message body")

# Load the attachment message
attach_msg = ae.mapi.MapiMessage.load("Message.msg")

# Add the attachment to the message
message.attachments.add("Weekly report.msg", attach_msg)

# Save the message with the embedded message attachment
message.save("WithEmbeddedMsg_out.msg")

Đọc Tin nhắn Nhúng từ Đính kèm

Đoạn mã dưới đây cho bạn thấy cách đọc tin nhắn nhúng từ tệp đính kèm.

import aspose.email as ae

file_name = "path/to/file.msg"

# Load the MapiMessage from file
message = ae.mapi.MapiMessage.from_file(file_name)

# Check if the first attachment is an Outlook message
if message.attachments[0].object_data.is_outlook_message:
    # Get the embedded message as MapiMessage
    embedded_message = message.attachments[0].object_data.to_mapi_message()
    # Perform further operations with the embedded message
    # ...

Chèn và Thay thế tệp đính kèm

API Aspose.Email cung cấp khả năng chèn tệp đính kèm vào vị trí chỉ định trong tin nhắn cha. Nó cũng cho phép thay thế nội dung của một tệp đính kèm bằng tệp đính kèm của tin nhắn khác. Đoạn mã dưới đây cho bạn thấy cách Chèn và Thay thế tệp đính kèm.

Chèn tại vị trí cụ thể

API Aspose.Email cung cấp khả năng chèn một tệp đính kèm MSG vào MSG cha bằng phương thức Insert của MapiAttachmentCollection: MapiAttachmentCollection Insert(int index, string name, MapiMessage msg). Đoạn mã dưới đây cho bạn thấy cách chèn tại vị trí cụ thể.

import aspose.email as ae
from io import BytesIO

file_name = "path/to/file.msg"

# Load the MapiMessage from file
message = ae.mapi.MapiMessage.load(file_name)

# Save the attachment to a memory stream
memory_stream = BytesIO()
message.attachments[2].save(memory_stream)

# Load the attachment from the memory stream
get_data = ae.mapi.MapiMessage.load(memory_stream)

# Insert the loaded attachment at index 1
message.attachments.insert(1, "new 11", get_data)

Thay thế Nội dung Đính kèm

Điều này có thể được sử dụng để thay thế nội dung tệp đính kèm nhúng bằng các nội dung mới bằng phương thức Replace. Tuy nhiên, không thể dùng để chèn tệp đính kèm với PR_ATTACH_NUM = 4 (ví dụ) vào bộ sưu tập khi collection.Count = 2. Đoạn mã dưới đây cho bạn thấy cách thay thế nội dung tệp đính kèm.

import aspose.email as ae
from io import BytesIO
file_name = "path/to/file.msg"

# Load the MapiMessage from file
message = ae.mapi.MapiMessage.load(file_name)

# Save the attachment to a memory stream
memory_stream = BytesIO()
message.attachments[2].save(memory_stream)

# Load the attachment from the memory stream
get_data = ae.mapi.MapiMessage.load(memory_stream)

# Replace the attachment at index 1 with the loaded attachment
message.attachments.replace(1, "new 1", get_data)

Đổi Tên Đính Kèm trong MapiMessage

Có thể sửa đổi tên hiển thị của các tệp đính kèm trong tin nhắn email được tải từ tệp. Mẫu mã dưới đây cho thấy cách thực hiện việc này:

import aspose.email as ae

msg = ae.mapi.MapiMessage.load("message.msg")

msg.attachments[0].display_name = "New display name 1"
msg.attachments[1].display_name = "New display name 2"

Python-Net: Làm việc với các mục Lịch Outlook

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

Làm việc với MapiCalendar

Lớp MapiCalendar của Aspose.Email cung cấp các phương thức và thuộc tính để đặt các thuộc tính khác nhau của một mục lịch.

Tạo và Lưu các mục Lịch

Đoạn mã mẫu dưới đây cho bạn thấy cách tạo và lưu một mục lịch ở định dạng ICS.

import aspose.email as ae
from datetime import datetime

data_dir = "path/to/data/directory"

# Create the appointment
calendar = ae.mapi.MapiCalendar(
    "LAKE ARGYLE WA 6743",
    "Appointment",
    "This is a very important meeting :)",
    datetime(2012, 4, 1),
    datetime(2012, 5, 1))

calendar.save(data_dir + "CalendarItem_out.ics", ae.calendar.AppointmentSaveFormat.ICS)

Lưu mục Lịch biểu dưới dạng MSG

Đoạn mã mẫu dưới đây cho bạn thấy cách lưu mục lịch dưới dạng MSG.

Đặt ID Sản phẩm khi Lưu MapiCalendar sang ICS

Thư viện Aspose.Email cho phép bạn lưu một MapiCalendar (một mục lịch) vào tệp ICS (iCalendar) với các tùy chọn cụ thể. Với các thuộc tính ics_save_options.keep_original_date_time_stamp và ics_save_options.product_identifier bạn có thể giữ nguyên các dấu thời gian ngày giờ gốc liên quan đến mục lịch và đặt định danh sản phẩm trong tệp ICS, ví dụ thành "Foo Ltd". Định danh sản phẩm là trường xác định phần mềm hoặc dịch vụ đã tạo ra tệp ICS.

Dưới đây là mẫu mã cho phép bạn đặt ID sản phẩm khi lưu MapiCalendar thành ICS:

import aspose.email as ae

ics_save_options = ae.mapi.MapiCalendarIcsSaveOptions()
ics_save_options.keep_original_date_time_stamp = True
ics_save_options.product_identifier = "Foo Ltd"

mapiCalendar.save("my.ics", ics_save_options)

Lấy tổng số sự kiện

Chức năng của CalendarReader lớp cho phép bạn đọc dữ liệu lịch từ một tệp được chỉ định. Bằng cách tạo một đối tượng CalendarReader, chúng ta có thể trích xuất các thông tin quan trọng như tổng số sự kiện, phiên bản lịch, phương pháp được sử dụng, và liệu lịch có chứa nhiều sự kiện hay không. Đoạn mã sau minh họa cách làm việc với dữ liệu lịch và, bổ sung thêm, tải các cuộc hẹn từ lịch dưới dạng danh sách nhiều sự kiện.

import aspose.email as ae

reader = ae.calendar.CalendarReader(fileName)
print(f"Calendar contains {reader.count} events")
print(f"The Version of the calendar is {reader.version}")
print(f"The Method of the calendar is {reader.method}")
print(f"Is calendar contains contains multiple events? - {reader.is_multi_events}")
appointments = reader.load_as_multiple()

Thêm lời nhắc hiển thị vào Lịch

Đoạn mã mẫu dưới đây cho bạn thấy cách thêm lời nhắc hiển thị vào lịch.

Thêm lời nhắc âm thanh vào Lịch

Đoạn mã dưới đây cho bạn thấy cách thêm lời nhắc âm thanh vào lịch.

Thêm/Lấy tệp đính kèm từ các tệp Lịch

Mô-đun Aspose.Email Calendar ("ae.calendar") cũng cung cấp chức năng thêm và lấy thông tin tệp đính kèm.

Để bao gồm một tệp đính kèm vào cuộc hẹn, một đối tượng "Attachment" được tạo, cung cấp đường dẫn tệp. Tệp đính kèm này sau đó được thêm vào danh sách đính kèm của cuộc hẹn. Cuộc hẹn được lưu vào một đường dẫn tệp cụ thể ở định dạng iCalendar bằng cách sử dụng lưu phương thức và định dạng tệp phù hợp.
Để lấy các tệp đính kèm từ một cuộc hẹn, đầu tiên nó được tải từ tệp đã lưu bằng cách sử dụng load phương thức, số lượng tệp đính kèm có trong "appointment2" được hiển thị, và bằng cách lặp qua các tệp đính kèm, tên của chúng được in ra.

Đoạn mã dưới đây minh họa cách tạo cuộc hẹn có tệp đính kèm, lưu chúng và lấy thông tin tệp đính kèm bằng mô-đun "ae.calendar". Nó nêu bật chức năng và khả năng làm việc với cuộc hẹn và tệp đính kèm trong ứng dụng lịch.

import aspose.email as ae
import datetime as dt

# Add an attachment to an appointment
attendees = ae.MailAddressCollection()
attendees.append(ae.MailAddress("attendee@domain.com", "Recipient 1"))

appointment = ae.calendar.Appointment("Room 112", dt.datetime(2023, 5, 27), dt.date(2023, 5, 28),  ae.MailAddress("organizer@domain.com"), attendees)

attachment = ae.Attachment("D:\\Aspose\\Files\\Attachment.txt")
appointment.attachments.append(attachment)

appointment.save("D:\\Aspose\\Files\\appWithAttachments_out.ics", ae.calendar.AppointmentSaveFormat.ICS)

# Retrieve attachments from an appointment 
appointment2 = ae.calendar.Appointment.load("D:\\Aspose\\Files\\appWithAttachments_out.ics")
print(appointment2.attachments.length)
for att in appointment2.attachments:
    print(att.name)

Trạng thái người nhận từ yêu cầu họp

Đoạn mã sau cho bạn thấy cách lấy trạng thái của người nhận từ yêu cầu họp.

Chuyển đổi Cuộc hẹn EML sang MSG giữ nguyên Phần thân ở định dạng HTML

Aspose.Email cho phép chuyển đổi cuộc hẹn EML sang MSG và giữ lại phần thân HTML. Thuộc tính "forced_rtf_body_for_appointment" của MapiConversionOptions lớp được sử dụng để thao tác loại nội dung của cuộc hẹn. Khi đặt là True, nội dung sẽ được chuyển sang định dạng RTF theo mặc định. Để giữ nội dung ở định dạng HTML, nên đặt là False. Đoạn mã dưới đây cho thấy cách bảo tồn nội dung HTML của cuộc hẹn khi chuyển đổi từ EML sang MSG:

import aspose.email as ae

eml = ae.MailMessage.load("appointment.eml")

conversionOptions = ae.mapi.MapiConversionOptions()
conversionOptions.format = ae.mapi.OutlookMessageFormat.UNICODE
# default value for ForcedRtfBodyForAppointment is true
conversionOptions.forced_rtf_body_for_appointment = False

msg = ae.mapi.MapiMessage.from_mail_message(eml, conversionOptions)

print(f"Body Type: {msg.body_type}")

msg.save("appointment.msg")

Python-Net: Làm việc với Danh bạ Outlook

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

Tạo, Lưu và Đọc danh bạ

Giống như MapiMessage, Aspose.Email cho phép bạn tạo liên hệ Outlook. Lớp MapiContact cung cấp tất cả các thuộc tính liên quan đến liên hệ cần thiết để tạo một liên hệ Outlook. Bài viết này cho thấy cách tạo, lưu và đọc một liên hệ Outlook bằng cách sử dụng lớp MapiContact.

Tạo và Lưu Liên hệ Outlook

Để tạo một liên hệ và lưu nó vào đĩa:

Khởi tạo một đối tượng mới của lớp MapiContact.
Nhập thông tin thuộc tính liên hệ.
Thêm dữ liệu ảnh (nếu có).
Lưu danh bạ dưới dạng MSG hoặc VCard.

Đoạn mã sau cho bạn thấy cách tạo và lưu liên hệ Outlook.

import aspose.email as ae

data_dir = "path/to/data/directory"

contact = ae.mapi.MapiContact()
contact.name_info = ae.mapi.MapiContactNamePropertySet("Bertha", "A.", "Buell")
contact.professional_info = ae.mapi.MapiContactProfessionalPropertySet("Awthentikz", "Social work assistant")
contact.personal_info.personal_home_page = "B2BTies.com"
contact.physical_addresses.work_address.address = "Im Astenfeld 59 8580 EDELSCHROTT"
contact.electronic_addresses.email1 = ae.mapi.MapiContactElectronicAddress("Experwas", "SMTP", "BerthaABuell@armyspy.com")
contact.telephones = ae.mapi.MapiContactTelephonePropertySet("06605045265")
contact.personal_info.children = ["child1", "child2", "child3"]
contact.categories = ["category1", "category2", "category3"]
contact.mileage = "Some test mileage"
contact.billing = "Test billing information"
contact.other_fields.journal = True
contact.other_fields.private = True
contact.other_fields.reminder_topic = "Test topic"
contact.other_fields.user_field1 = "ContactUserField1"
contact.other_fields.user_field2 = "ContactUserField2"
contact.other_fields.user_field3 = "ContactUserField3"
contact.other_fields.user_field4 = "ContactUserField4"

# Add a photo
with open(data_dir + "Desert.jpg", "rb") as file:
    buffer = file.read()
    contact.photo = ae.mapi.MapiContactPhoto(buffer, ae.mapi.MapiContactPhotoImageFormat.Jpeg)

# Save the Contact in MSG format
contact.save(data_dir + "MapiContact_out.msg", ae.mapi.ContactSaveFormat.MSG)

# Save the Contact in VCF format
contact.save(data_dir + "MapiContact_out.vcf", ae.mapi.ContactSaveFormat.V_CARD)

Lưu Liên hệ ở Định dạng VCF Phiên bản 3

Để lưu một liên hệ ở định dạng VCF Phiên bản 3, sử dụng thuộc tính version của VCardSaveOptions lớp. Tạo một thể hiện mới của lớp VCardSaveOptions, đặt thuộc tính version của đối tượng VCardSaveOptions thành VCardVersion.V30. Điều này đặt phiên bản vCard thành 3.0., gọi phương thức save của đối tượng MapiContact, truyền tên tệp "contact.vcf" và đối tượng VCardSaveOptions làm tham số. Điều này lưu liên hệ dưới dạng tệp vCard với tên tệp và tùy chọn đã chỉ định. Đoạn mã sau cho bạn thấy cách lưu một liên hệ ở định dạng VCF Phiên bản 3:

import aspose.email as ae

contact = ae.mapi.MapiContact()
contact.name_info = ae.mapi.MapiContactNamePropertySet("Bertha", "A.", "Buell")
options = ae.personalinfo.vcard.VCardSaveOptions()
options.version = ae.personalinfo.vcard.VCardVersion.V30
contact.save("contact.vcf", options)

Đọc một MapiContact

Lớp MapiContact có thể được sử dụng để tải các liên hệ ở định dạng Outlook MSG và VCard. Đoạn mã sau cho bạn thấy cách tải các liên hệ Outlook lưu dưới dạng MSG và VCF vào một MapiContact.

Tải một Liên hệ từ MSG

Đoạn mã sau cho bạn thấy cách tải một liên hệ từ MSG.

Tải một Liên hệ từ VCard

Đoạn mã sau cho bạn thấy cách tải một liên hệ từ vCard.

Tải một Liên hệ từ VCard với Mã hóa Được Chỉ định

Đoạn mã sau cho bạn thấy cách tải một liên hệ từ vcard với mã hóa được chỉ định.

Lưu các mục Liên hệ VCard với Mã hóa Được chỉ định

Khi lưu tệp vCard, có thể chỉ định bộ mã ký tự sẽ được sử dụng để đảm bảo khả năng tương thích với các ký tự không phải ASCII. Đặt thuộc tính preferred_text_encoding của đối tượng VCardSaveOptions thành "utf-8". Đoạn mã sau cho thấy cách thực hiện chức năng này vào dự án của bạn:

import aspose.email as ae

contact = ae.mapi.MapiContact()
contact.name_info = ae.mapi.MapiContactNamePropertySet("Bertha", "A.", "Buell")
options = ae.personalinfo.vcard.VCardSaveOptions()
options.preferred_text_encoding = "utf-8"
contact.save("contact.vcf", options)

Lưu các Tệp VCard với các Trường Mở rộng

Khi lưu tệp vCard, bạn cũng có thể chỉ định các tùy chọn bao gồm việc sử dụng các trường mở rộng, tức là các thuộc tính hoặc đặc tính bổ sung có thể được thêm vào vCard ngoài tập hợp trường tiêu chuẩn được định nghĩa bởi đặc tả vCard. Thuộc tính use_extensions của VCardSaveOptions lớp cho phép bạn thực hiện điều đó. Đoạn mã sau cho thấy cách lưu một tệp VCard với các trường mở rộng:

import aspose.email as ae

contact = ae.mapi.MapiContact()
contact.name_info = ae.mapi.MapiContactNamePropertySet("Bertha", "A.", "Buell")
options = ae.personalinfo.vcard.VCardSaveOptions()
options.use_extensions = True
contact.save("contact.vcf", options)

Đọc Nhiều Liên hệ ở định dạng VCard

Bạn sẽ cần các phương thức sau để lấy danh sách tất cả các liên hệ từ một VCard:

# Checks whether VCard source stream contains multiple contacts.
aspose.email.personalinfo.vcard.VCardContact.is_multi_contacts(stream)

# Loads list of all contacts from VCard file.
aspose.email.personalinfo.vcard.VCardContact.load_as_multiple(file_path, encoding)

# Loads list of all contacts from VCard stream.
aspose.email.personalinfo.vcard.VCardContact.load_as_multiple(stream, encoding)

Đoạn mã dưới đây sẽ minh họa quy trình đọc nhiều liên hệ từ một tệp VCard:

import aspose.email as ae

contact = ae.mapi.MapiContact()
contact.name_info = ae.mapi.MapiContactNamePropertySet("Bertha", "A.", "Buell")
options = ae.personalinfo.vcard.VCardSaveOptions()
options.use_extensions = True
contact.save("contact.vcf", options)

if ae.personalinfo.vcard.VCardContact.is_multi_contacts("contact.vcf"):
    ae.personalinfo.vcard.VCardContact.load_as_multiple("contact.vcf")

Kết xuất thông tin danh bạ sang MHTML

Liên hệ Outlook có thể được chuyển đổi sang MHTML bằng API Aspose.Email. Ví dụ này cho thấy cách một VCard được tải vào MapiContact và sau đó chuyển sang MHTML bằng sự trợ giúp của API MailMessage.

Python-Net: Làm việc với Ghi chú Outlook

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

Tạo, Lưu và Đọc Ghi chú

Aspose.Email cung cấp khả năng tạo ghi chú Outlook và lưu chúng vào đĩa ở định dạng MSG. Lớp MapiNote cung cấp các thuộc tính và phương thức để thiết lập thông tin công việc. Bài viết này cho thấy cách tạo, lưu và đọc một MapiNote từ đĩa.

Tạo và Lưu Ghi chú Outlook

Các bước sau có thể được sử dụng để tạo và lưu một ghi chú vào đĩa:

Khởi tạo một đối tượng của lớp MapiNote.
Đặt các thuộc tính khác nhau.
Lưu ghi chú vào đĩa dưới dạng tệp MSG.

Đoạn mã sau cho bạn thấy cách tạo và lưu một Ghi chú Outlook.

Đọc một MapiNote

Đối tượng lớp MapiNote được dùng để ép kiểu đối tượng MapiMessage tải một ghi chú từ đĩa ở định dạng MSG. Đoạn mã sau cho bạn thấy cách đọc một MapiNote.

Python-Net: Làm việc với Nhiệm vụ Outlook

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

Tạo, Lưu và Đọc tác vụ

Aspose.Email cho .NET cho phép bạn tạo các tác vụ Outlook và lưu chúng dưới dạng MSG. Lớp MapiTask cung cấp một số thuộc tính như Percentcomplete, Estimatedeffort, ActualEffort, History, LastUpdate và các thuộc tính khác, để đáp ứng và thiết lập thông tin cần thiết cho một tác vụ Outlook. Bài viết này chỉ ra cách tạo, lưu và đọc một MapiTask từ đĩa. Để tạo và lưu một tác vụ lên đĩa:

Khởi tạo một đối tượng mới của lớp MapiContact.
Nhập thông tin thuộc tính của tác vụ.
Lưu tác vụ vào đĩa ở định dạng MSG.

Đoạn mã dưới đây cho bạn thấy cách tạo, lưu và đọc các tác vụ.

Đọc một MapiTask

Đối tượng lớp MapiContact được sử dụng để ép kiểu đối tượng MapiMessage tải một tác vụ từ đĩa dưới dạng MSG. Đoạn mã dưới đây cho bạn thấy cách đọc một MapiTask.

Đọc một tác vụ VToDo

Các tác vụ Google được xuất dưới dạng iCalendar dưới dạng các sự kiện VToDo có thể được tải bằng lớp MapiTask như trong mẫu mã dưới đây. Đoạn mã dưới đây cho bạn thấy cách đọc một tác vụ VToDo.

import aspose.email as ae

data_dir = "path/to/data/directory"

task = ae.mapi.MapiTask.from_v_todo(data_dir + "VToDoTask.ics")
task.save(data_dir + "VToDo_out.msg", ae.TaskSaveFormat.Msg)

Thêm thông tin nhắc nhở vào một MapiTask

Tương tự như Microsoft Outlook, Aspose.Email có thể thêm thông tin nhắc nhở vào một MapiTask. Đoạn mã dưới đây cho bạn thấy cách thêm thông tin nhắc nhở vào một MapiTask.

Thêm tệp đính kèm vào một MapiTask

Sử dụng Thêm phương thức của MapiAttachmentCollection lớp để thêm tệp đính kèm vào MapiTask. Đoạn mã mẫu sau sẽ giúp bạn thực hiện điều đó:

import aspose.email as ae
import datetime as dt

task = ae.mapi.MapiTask("Task with attacment", "Test body of task with attacment", dt.datetime.now(), dt.datetime.now());
task.attachments.add("Attachment.txt", str.encode("attachment data"))
task.save("AddAttachmentsToMapiTask_out", ae.mapi.TaskSaveFormat.MSG)

Thêm lặp lại vào MapiTask

Aspose.Email cho phép tạo nhiệm vụ lặp lại, trong đó tần suất lặp lại có thể là hàng ngày, hàng tuần, hàng tháng hoặc hàng năm. Đoạn mã dưới đây cho bạn thấy cách tạo một nhiệm vụ với các loại lặp lại khác nhau.

Chuyển một nhiệm vụ sang MHT

Mẫu mã dưới đây minh họa cách chuyển một nhiệm vụ sang định dạng MHT bằng cách chỉ định các tùy chọn bổ sung cho định dạng MHT khi các trường đặc thù của nhiệm vụ cần được hiển thị (RENDER_TASK_FIELDS) và thông tin tiêu đề cần được bao gồm (WRITE_HEADER). Thuộc tính mht_format_options của MhtSaveOptions lớp được sử dụng để định nghĩa các tùy chọn bổ sung khi lưu ở định dạng MHTML.

import aspose.email as ae

msg = ae.mapi.MapiMessage.load("MapiTask.msg")

opt = ae.SaveOptions.default_mhtml
opt.mht_format_options = ae.MhtFormatOptions.RENDER_TASK_FIELDS | ae.MhtFormatOptions.WRITE_HEADER

msg.save("MapiTask_out.mht", opt)

Python-Net: Làm việc với Tùy chọn Bỏ phiếu sử dụng MapiMessage

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

Tạo tùy chọn Bỏ phiếu bằng MapiMessage

Microsoft Outlook cho phép người dùng tạo một cuộc thăm dò khi soạn tin nhắn mới. Nó cho phép họ bao gồm các tùy chọn bỏ phiếu như Có, Không, Có thể, v.v. Aspose.Email cho phép điều tương tự khi tạo một tin Outlook mới. FollowUpOptions lớp cung cấp thuộc tính VotingButtons có thể được dùng để đặt hoặc lấy giá trị của các tùy chọn bầu chọn. Bài viết này cung cấp một ví dụ chi tiết về việc tạo một MapiMesasge với các tùy chọn bầu chọn để tạo một cuộc thăm dò.

Tạo một cuộc thăm dò bằng MapiMessage

Mẫu mã sau cho thấy cách sử dụng thuộc tính voting_buttons của FollowUpOptions lớp để tạo một cuộc thăm dò:

import aspose.email as ae

msg = ae.mapi.MapiMessage.load("my.msg")

# Set FollowUpOptions Buttons
options = ae.mapi.FollowUpOptions()
options.voting_buttons = "Yes;No;Maybe;Exactly!"

msg.save("voting_btns.msg")

Đọc Các Tùy chọn Bỏ phiếu từ MapiMessage

Đoạn mã sau cho bạn thấy cách Đọc các Tùy chọn Bầu chọn từ một MapiMessage.

Đọc Chỉ Các Nút Bỏ phiếu

Đoạn mã sau đây cho bạn thấy cách chỉ đọc các nút bỏ phiếu.

Thêm nút bầu chọn vào Tin nhắn Hiện có

Đoạn mã sau cho bạn thấy cách thêm nút bầu chọn vào một tin nhắn hiện có.

Xóa nút Bầu chọn khỏi Tin nhắn

Đoạn mã sau cho bạn thấy cách xóa nút bầu chọn khỏi một Tin nhắn.

Đọc Thông tin Kết quả Bỏ phiếu

Đoạn mã sau đây cho bạn thấy cách đọc thông tin kết quả bỏ phiếu.

Đặt cờ tin nhắn chưa gửi

Đoạn mã sau cho bạn thấy cách các phương pháp mẫu được sử dụng trong các ví dụ.

import aspose.email as ae

msg = ae.mapi.MapiMessage("from@test.com", "to@test.com", "Flagged message", "Make it nice and short, but descriptive. The description may appear in search engines' search results pages...")
msg.set_message_flags(msg.flags ^ ae.mapi.MapiMessageFlags.UNSENT)