Documentation – ทำงานกับรายการ Outlook

Python-Net: การสร้างและบันทึกไฟล์ MSG

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

Aspose.Email รองรับการสร้างไฟล์ Outlook message (MSG) บทความนี้อธิบายวิธีทำ:

สร้างข้อความ MSG.
สร้างข้อความ MSG พร้อมไฟล์แนบ.
สร้างข้อความ MSG พร้อมเนื้อหา RTF.
บันทึกข้อความเป็นแบบร่าง.
ทำงานกับการบีบอัดเนื้อหา.

การสร้างและบันทึก Outlook Messages

คลาส MailMessage มีเมธอด Save() ที่สามารถบันทึกไฟล์ Outlook MSG ไปยังดิสก์หรือสตรีมได้ โค้ดตัวอย่างด้านล่างสร้างอินสแตนซ์ของคลาส MailMessage ตั้งค่าคุณสมบัติ เช่น from, to, subject และ body เมธอด Save() รับชื่อไฟล์เป็นอาร์กิวเมนต์ นอกจากนี้ข้อความ Outlook สามารถสร้างด้วยเนื้อหา RTF ที่ถูกบีบอัดโดยใช้ MapiConversionOptions เพื่อเริ่มต้น สร้างแอปพลิเคชัน Windows ใหม่และเพิ่มการอ้างอิงไปยังไลบรารี Aspose.Email dll ในโปรเจค.

สร้างอินสแตนซ์ใหม่ของคลาส MailMessage แล้วตั้งค่าคุณสมบัติ From, To, Subject และ Body.
เรียกเมธอด FromMailMessage ของคลาส MailMessage ที่รับอ็อบเจกต์ประเภท MailMessage เมธอด FromMailMessage() จะทำการแปลง MailMessage ให้เป็น MailMessage (MSG).
เรียกเมธอด MapiMessage.Save() เพื่อบันทึกไฟล์ MSG.

เขียนโค้ดต่อไปนี้ในเหตุการณ์คลิกของปุ่มควบคุมในแอปพลิเคชัน Windows.

สร้างไฟล์ MSG พร้อมไฟล์แนบ

ในตัวอย่างข้างต้น เราได้สร้างไฟล์ MSG ง่าย ๆ Aspose.Email ยังสนับสนุนการบันทึกไฟล์ข้อความพร้อมไฟล์แนบทั้งหมดที่ต้องทำคือเพิ่มไฟล์แนบเข้าไปในอินสแตนซ์ MailMessage โดยเรียกเมธอด Add() ของคอลเลกชัน MailMessage.Attachments เพิ่ม ListBox ไปยังฟอร์มที่สร้างขึ้นและเพิ่มสองปุ่ม หนึ่งปุ่มสำหรับเพิ่มและอีกหนึ่งปุ่มสำหรับลบไฟล์แนบ แอปพลิเคชันที่เพิ่มไฟล์แนบทำงานดังนี้:

เมื่อคลิกปุ่ม Add Attachment จะปรากฏ Open File Dialog เพื่อช่วยให้ผู้ใช้เรียกดูและเลือกไฟล์แนบ.
เมื่อไฟล์ถูกเลือก เส้นทางเต็มจะถูกเพิ่มในรายการ.
เมื่อไฟล์ MSG ถูกสร้าง เส้นทางไฟล์แนบจะถูกดึงจากรายการและเพิ่มเข้าไปในคอลเลกชัน MailMessage.Attachments.

เขียนโค้ดต่อไปนี้ในเหตุการณ์คลิกของปุ่ม Add Attachment.

เพิ่มโค้ดสำหรับการเพิ่มไฟล์แนบเข้าไปในอินสแตนซ์ MailMessage โค้ดสุดท้ายของฟังก์ชัน Write Msg เขียนตามด้านล่างนี้.

สร้างไฟล์ MSG พร้อมเนื้อหา RTF

คุณสามารถสร้างไฟล์ Outlook Message (MSG) ที่มีเนื้อหา rich text (RTF) ด้วย Aspose.Email ได้ ส่วนหัว RTF รองรับการจัดรูปแบบข้อความ สร้างโดยตั้งค่าคุณสมบัติ MailMessage.HtmlBody เมื่อคุณแปลงอินสแตนซ์ MailMessage เป็นอินสแตนซ์ MailMessage อีกครั้ง เนื้อหา HTML จะถูกแปลงเป็น RTF ด้วยวิธีนี้การจัดรูปแบบของเนื้อหาอีเมลจะถูกเก็บไว้.

ตัวอย่างต่อไปนี้สร้างไฟล์ MSG พร้อมเนื้อหา RTF มีหัวข้อหนึ่งรายการพร้อมการจัดรูปแบบตัวหนาและขีดเส้นใต้ในส่วน HTML การจัดรูปแบบนี้จะคงไว้เมื่อ HTML ถูกแปลงเป็น RTF.

บันทึกข้อความในสถานะแบบร่าง

อีเมลจะถูกบันทึกเป็นฉบับร่างเมื่อมีการเริ่มแก้ไขแต่ต้องการกลับมาจบภายหลัง Aspose.Email รองรับการบันทึกข้อความอีเมลในสถานะร่างโดยตั้งค่าแฟล็กของข้อความ ด้านล่างเป็นตัวอย่างโค้ดเพื่อบันทึก Outlook email (MSG) เป็นฉบับร่าง.

ผลกระทบของการบีบอัดเนื้อหา

วิธีการบีบอัดเนื้อหา RTF สามารถใช้เพื่อสร้างไฟล์ MSG ขนาดเล็กลงได้ แต่จะทำให้ความเร็วช้าลง หากต้องการสร้างข้อความที่เร็วขึ้น ให้ตั้งค่าแฟล็กเป็น false แฟล็กนี้ส่งผลต่อ PST ที่สร้างขึ้น: ไฟล์ MSG ขนาดเล็กทำให้ PST เล็กลงและไฟล์ MSG ขนาดใหญ่ทำให้การสร้าง PST ช้าลง.

Python-Net: การโหลด ดู และแยกไฟล์ MSG

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

หัวข้อนี้อธิบายวิธีโหลดไฟล์ข้อความ Microsoft Outlook (*.msg). The MapiMessage คลาสใช้เพื่อโหลดไฟล์ MSG และให้ฟังก์ชันโหลดแบบสถิตหลายแบบสำหรับสถานการณ์ต่างๆ ตัวอย่างโค้ดต่อไปนี้แสดงวิธีโหลดไฟล์ MSG จากไฟล์หรือจากสตรีม.

ลองใช้ดู!

แยกไฟล์อีเมลออนไลน์ได้ฟรี Aspose.Email Parser App.

การโหลดไฟล์ MSG

โค้ดสแนปต่อไปนี้แสดงวิธีโหลดไฟล์ 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)

การโหลดจากสตรีม

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการโหลดไฟล์จากสตรีม.

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)

การแปลง EML เป็น MSG พร้อมรักษารูปแบบ EML ฝัง

ไฟล์ EML สามารถโหลดเข้าไปใน MapiMessage คลาสโดยการสร้าง MailMessage อ็อบเจกต์และส่งผ่านไปยังเมธอด MapiMessage.from_mail_message หากไฟล์ EML มีไฟล์ EML ฝังอยู่ ใช้ MapiConversionOptions.PreserveEmbeddedMessageFormat เพื่อรักษารูปแบบของไฟล์ EML ฝัง ตัวอย่างโค้ดด้านล่างแสดงวิธีโหลดไฟล์ EML เข้าไปใน MapiMessage พร้อมรักษารูปแบบของไฟล์ EML ฝัง.

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: การจัดการไฟล์ข้อความด้วย Aspose.Email.Outlook

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

กำหนดประเภทรายการ MAPI ในโฟลเดอร์ PST

ไฟล์ PST ปกติจะมีข้อมูลหลายประเภท เช่น ข้อความอีเมล, เหตุการณ์ปฏิทิน, รายชื่อติดต่อ, และอื่น ๆ. MapiItemType คลาสของ Aspose.Email ช่วยให้คุณเข้าถึงและจัดประเภทของรายการ MAPI ต่างๆ ภายในไฟล์ PST โค้ดด้านล่างแสดงวิธีกำหนดประเภทของรายการ MAPI ในโฟลเดอร์ 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

การแปลง MSG เป็นข้อความ MIME

API ของ Aspose.Email ให้ความสามารถในการแปลงไฟล์ MSG เป็นข้อความ MIME โดยใช้เมธอด ToMailMessage.

การกำหนดเวลา Timeout สำหรับการแปลงและการโหลดข้อความ

เพื่อจำกัดเวลาเป็นมิลลิวินาทีสำหรับการแปลงข้อความ (ค่าเริ่มต้น 3 วินาที) คุณสมบัติ timeout ของ MailConversionOptions ใช้คลาส.

ต่อไปนี้คือวิธีการตั้งค่า timeout สำหรับกระบวนการแปลงและโหลดข้อความ:

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)

โดยการตั้งค่า timeout สำหรับกระบวนการแปลงข้อความและการโหลด คุณสามารถควบคุมเวลาสูงสุดที่การดำเนินการเหล่านี้ได้รับอนุญาตให้ทำงาน หลังจากตั้งค่า timeout แล้ว คุณสามารถดำเนินการแปลงและโหลดข้อความต่อได้

การประมวลผลไฟล์ Outlook Template (OFT)

โหลด, แก้ไข, และบันทึกไฟล์ OFT

เทมเพลต Outlook (OFT) ให้วิธีที่สะดวกในการเร่งรัดกระบวนการส่งอีเมลซ้ำ ๆ แทนการสร้างอีเมลเดียวกันใหม่ทุกครั้ง คุณสามารถสร้างข้อความใน Outlook แล้วบันทึกเป็นเทมเพลต Outlook (OFT) ภายหลังเมื่อต้องการส่งข้อความคล้ายกัน คุณสามารถสร้างจากเทมเพลตได้อย่างรวดเร็ว วิธีนี้ช่วยประหยัดการเขียนเนื้อหาเดิมในส่วนข้อความ, ระบุหัวเรื่อง, การจัดรูปแบบ ฯลฯ

ของ Aspose.Email MailMessage คลาสนี้ให้เครื่องมือที่ทรงพลังสำหรับโหลดและจัดการไฟล์เทมเพลต Outlook (OFT) เมื่อเทมเพลต Outlook ถูกโหลดเข้าสู่อินสแตนซ์ของคลาส MailMessage คุณสามารถอัปเดตคุณสมบัติต่าง ๆ เช่น ผู้ส่ง, ผู้รับ, เนื้อหาข้อความ, หัวเรื่องและแอตทริบิวต์อื่น ๆ ได้อย่างง่ายดาย.

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

หลังจากทำการอัปเดตที่จำเป็นแล้ว คุณสามารถส่งอีเมลโดยใช้ SmtpClient คลาส:

# Send the email
smtpClient.send(message)

การบันทึกไฟล์ Outlook MSG เป็นแม่แบบ

สำหรับวัตถุประสงค์นี้ คุณสามารถใช้ MailMessage คลาสสำหรับสร้างอีเมล จากนั้นบันทึกเป็นไฟล์ OFT ตัวอย่างโค้ดต่อไปนี้จะแสดงวิธีบันทึกอีเมลเป็น 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 หรือ MSG: กำหนดประเภทของ MapiMessage

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการกำหนดว่าข้อความ MAPI ที่โหลดมานั้นเป็นอีเมลมาตรฐานหรือเป็น Outlook Template (OFT):

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

หลังจากโหลดไฟล์ MSG โค้ดจะตรวจสอบว่าคุณสมบัติ is_template ของ MapiMessaage คลาสนี้เป็น True หรือ False หากคืนค่า false ข้อความที่โหลดจะเป็นอีเมลมาตรฐาน ไม่ใช่เทมเพลต Outlook; ถ้าคืนค่า true ข้อความนั้นไม่ใช่อีเมลมาตรฐาน แต่เป็นเทมเพลต Outlook.

บันทึก MapiMessage หรือ MailMessage เป็น OFT

นี้ SaveOptions เป็นคลาสฐานแบบนามธรรมสำหรับคลาสที่ให้ผู้ใช้ระบุตัวเลือกเพิ่มเติมเมื่อบันทึก MailMessage ไปในรูปแบบเฉพาะ ตัวอย่างโค้ดต่อไปนี้แสดงวิธีบันทึกข้อความเป็นรูปแบบ 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)

การจัดการข้อความด้วยลายเซ็นดิจิทัล

ไลบรารีนี้ให้ LoadOptions คลาส, คลาสฐานแบบนามธรรมสำหรับคลาสที่ให้ผู้ใช้ระบุตัวเลือกเพิ่มเติมเมื่อลoad MailMessage จากรูปแบบเฉพาะ ตัวเลือกการคงลายเซ็นถูกตั้งค่าเป็นค่าเริ่มต้น.

แปลงจาก EML เป็น MSG โดยคงลายเซ็น

ตัวอย่างโค้ดด้านล่างแสดงวิธีโหลดข้อความ แปลงเป็นรูปแบบ MSG แล้วบันทึกเป็น MSG (ลายเซ็นจะถูกเก็บไว้เป็นค่าเริ่มต้น):


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)

แปลงข้อความ S/MIME จาก MSG เป็น EML

Aspose.Email อนุญาตให้คุณแปลงจาก MSG เป็น EML โดยคงลายเซ็นดิจิทัลไว้ตามที่แสดงในโค้ดตัวอย่างต่อไปนี้.

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

กำหนดหมวดสีสำหรับไฟล์ Outlook MSG

บางครั้งคุณอาจต้องการแยกแยะอีเมลที่สำคัญเป็นพิเศษและจัดระเบียบให้เป็นระเบียบด้วยภาพ หนังสือไลบรารีให้วิธีการทำเช่นนี้โดยการกำหนดสีเฉพาะให้กับรายการข้อความ เมื่อคุณกำหนดหมวดสีให้กับรายการ จะช่วยให้คุณระบุและค้นหารายการที่เกี่ยวข้องได้อย่างรวดเร็ว ใช้ FollowUpManager คลาสเพื่อกำหนดสีประเภทสำหรับข้อความตามตัวอย่างโค้ดต่อไปนี้:


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)

การเข้าถึงข้อมูล Follow Up จากไฟล์ MSG

สกัดข้อมูลการรับและการจัดส่งใบรับรอง

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการสกัดข้อมูลผู้รับและสถานะการติดตามของพวกเขาจากไฟล์ข้อความ 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]}")

การสร้างข้อความต่อและตอบกลับ

Aspose.Email มีวิธีง่าย ๆ ในการสร้างข้อความต่อและตอบกลับจากข้อความที่มีอยู่

การสร้างข้อความต่อ

คุณสามารถใช้ ForwardMessageBuilder คลาสนี้เพื่อสร้างข้อความส่งต่อโดยตั้งค่าข้อความต้นฉบับ, ผู้ส่ง, ผู้รับ, หัวเรื่อง, และเนื้อหา ข้อความส่งต่อสามารถรวมข้อความต้นฉบับเป็นไฟล์แนบหรือเป็นเนื้อหาของข้อความส่งต่อได้ คุณมีความยืดหยุ่นในการปรับแต่งคุณสมบัติเพิ่มเติม เช่น ไฟล์แนบ, ฮีดเดอร์, และตัวเลือกการฟอร์แมต ตัวอย่างโค้ดด้านล่างแสดงวิธีสร้างข้อความส่งต่อ:


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

การสร้างข้อความตอบกลับ

นี้ ReplyMessageBuilder คลาสนี้ใช้เพื่อกำหนดการตั้งค่าการตอบกลับ รวมถึงข้อความต้นฉบับ, ผู้ส่ง, ผู้รับ, โหมดการตอบ, คำนำหน้าหัวเรื่อง, และเนื้อหาของข้อความตอบกลับ ข้อความตอบกลับสามารถสร้างในโหมดต่าง ๆ เช่น "Reply to Sender" หรือ "Reply to All" ตามความต้องการของคุณ คุณสามารถปรับแต่งคุณสมบัติต่าง ๆ เช่น ไฟล์แนบ, ฮีดเดอร์, และตัวเลือกการฟอร์แมตสำหรับข้อความตอบกลับ ตัวอย่างโค้ดด้านล่างแสดงวิธีสร้างข้อความส่งต่อ:

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: ทำงานกับรายการแจกจ่าย

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

สามารถสร้างรายการแจกจ่ายโดยใช้ Aspose.Email API ซึ่งเป็นชุดของผู้ติดต่อหลายคนได้ รายการแจกจ่ายสามารถบันทึกลงดิสก์ในรูปแบบ Outlook MSG และสามารถดู/จัดการโดยเปิดใน MS Outlook

สร้างและบันทึกรายการกระจาย

โค้ดตัวอย่างต่อไปนี้จะแสดงวิธีสร้างและบันทึกรายการแจกจ่าย.

อ่านรายการแจกจ่ายจาก PST

โค้ดตัวอย่างต่อไปนี้จะแสดงวิธีอ่านรายการแจกจ่ายจากไฟล์ 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: ทำงานกับ Follow Up และ Due Date สำหรับไฟล์ Outlook MSG

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

แฟล็ก follow up ทำเครื่องหมายข้อความอีเมลเพื่อทำการกระทำบางอย่าง Microsoft Outlook อนุญาตให้ผู้ใช้ทำแฟล็กข้อความและในการตั้งค่าแฟล็กให้กำหนดวันที่ครบกำหนดสำหรับการ follow up Microsoft Outlook ส่งการแจ้งเตือนไปยังผู้รับเพื่อกระตุ้นให้พวกเขาติดตามอีเมล การทำแฟล็กอีเมลและตั้งค่าวันครบกำหนดโดยโปรแกรมมิงช่วยให้นักพัฒนาซอฟต์แวร์อัตโนมัติข้อความบางประเภทและช่วยให้ผู้รับจำการกระทำได้ ตัวอย่างเช่น สามารถใช้ส่งข้อความรายเดือนให้ทีมขายเพื่อเตือนให้ทำรายงานเสร็จหรือส่งข้อความถึงพนักงานทั้งหมดเพื่อเตือนเกี่ยวกับการประชุมของบริษัท Aspose.Email สำหรับ .NET รองรับการตั้งค่าแฟล็ก follow up และวันที่ครบกำหนดสำหรับวัตถุ MapiMessage ด้วย FollowUpManager และ FollowUpOptions มีหลายรูปแบบที่สามารถตั้งค่าแฟล็ก follow up บนข้อความได้ ทั้งหมดนี้ใช้ในตัวอย่างโค้ดด้านล่าง:

ตั้งค่าแฟล็ก follow up สำหรับข้อความ
เพิ่มวันที่ครบกำหนดและวันที่เตือนสำหรับข้อความ
เพิ่มธงให้กับข้อความของผู้รับ.
ทำเครื่องหมายว่าเสร็จแล้ว.
ลบธง.
อ่านตัวเลือกของ follow up.

ตั้งค่าแฟล็ก FollowUp

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการตั้งค่าแฟล็ก 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")

ตั้งค่า Follow Up สำหรับผู้รับ

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการตั้งค่า follow Up ให้กับผู้รับ.

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

ทำเครื่องหมายแฟล็ก FollowUp ว่าเสร็จ

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการทำเครื่องหมายแฟล็ก followUp ว่าเสร็จสิ้น.

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

การลบแฟล็ก FollowUp

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการลบแฟล็ก 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")

อ่านตัวเลือกแฟล็ก follow-up สำหรับข้อความ

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการอ่านตัวเลือกของแฟล็ก followup สำหรับข้อความ.

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: ทำงานกับคุณสมบัติ MAPI

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

การเข้าถึงและตั้งค่าคุณสมบัติ Outlook MAPI

คลาส MapiProperty แสดงถึงคุณสมบัติ MAPI ซึ่งประกอบด้วย:

Name: สตริงที่เป็นชื่อของคุณสมบัติ.
Tag: จำนวนเต็มยาวที่แทนแท็กของคุณสมบัติ.
Data: อาเรย์ไบต์ที่เป็นตัวแทนของข้อมูลของคุณสมบัติ.

การดึงคุณสมบัติ MAPI โดยใช้แท็กคุณสมบัติ MAPI

เพื่อดึงคุณสมบัติ MAPI:

สร้างอินสแตนซ์ของ MapiMessage ด้วยการโหลดจากไฟล์หรือสตรีม.
ดึง MapiProperty จาก MapiMessage.Properties ด้วยคีย์ MapiPropertyTag.
รับข้อมูลของ MapiProperty ด้วยเมธอด GetX.

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการดึงคุณสมบัติ MAPI โดยใช้แท็กคุณสมบัติ MAPI.

การตั้งค่าคุณสมบัติ MAPI

โค้ดตัวอย่างต่อไปนี้แสดงวิธีตั้งค่าคุณสมบัติ MAPI.

โดยคำนิยามของเมธอด convertDateTime มีดังต่อไปนี้:

การอ่านคุณสมบัติ MAPI ที่ตั้งชื่อจากไฟล์ Outlook MSG

Aspose.Email มีชุด API เพื่อทำงานกับไฟล์ MSG รวมถึงการดึงคุณสมบัติ MAPI ที่ตั้งชื่อ

อ่านคุณสมบัติ MAPI ที่ตั้งชื่อจากไฟล์ MSG

เพื่ออ่านคุณสมบัติ MAPI ที่ตั้งชื่อ เราสามารถใช้คุณสมบัติ named_properties ของ MapiMessage คลาส ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการโหลดข้อความ ดึงคุณสมบัติ MAPI ที่ตั้งชื่อทั้งหมด และวนลูปผ่านแต่ละคุณสมบัติเพื่อตรวจสอบค่าของมัน:

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

การอ่านคุณสมบัติ MAPI ที่มีชื่อจากไฟล์แนบ

Aspose.Email ทำให้สามารถดึงคุณสมบัติ MAPI ที่ตั้งชื่อทั้งหมดของไฟล์แนบได้ ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการอ่านคุณสมบัติ MAPI ที่ตั้งชื่อจากไฟล์แนบ:

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

ลบคุณสมบัติจาก MSG และไฟล์แนบ

ตัวอย่างโค้ดนี้แสดงการสร้างข้อความ Outlook MSG พร้อมเนื้อหาในส่วน Body และไฟล์ข้อความที่แนบไว้ นอกจากนี้ยังแสดงวิธีการลบคุณสมบัติไฟล์แนบจากข้อความที่สร้างขึ้น.

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: ทำงานกับไฟล์แนบของข้อความ

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

การจัดการไฟล์แนบด้วย Aspose Outlook

การสร้างและบันทึกไฟล์ Outlook Message (MSG) อธิบายวิธีสร้างและบันทึกข้อความ รวมถึงการสร้างไฟล์ MSG พร้อมไฟล์แนบ บทความนี้อธิบายวิธีจัดการไฟล์แนบของ Microsoft Outlook ด้วย Aspose.Email ไฟล์แนบจากไฟล์ข้อความจะถูกเข้าถึงและบันทึกลงดิสก์โดยใช้คุณสมบัติ Attachments ของคลาส MapiMessage ซึ่งเป็นคอลเลกชันประเภทคลาส MapiAttachmentCollection.

ตรวจสอบว่าไฟล์แนบเป็น Inline หรือ Regular

"Inline" และ "Regular" ไฟล์แนบหมายถึงวิธีการรวมเข้ากับข้อความอีเมล Regular ไฟล์แนบเป็นไฟล์ที่แนบแบบดั้งเดิม ซึ่งมักจะแสดงในรายการภายในโปรแกรมอีเมลและผู้รับสามารถดาวน์โหลดและบันทึกลงที่เก็บข้อมูลภายใน Inline ไฟล์แนบ หรือที่เรียกว่าภาพฝังหรือตรงในเนื้อหา มักใช้เพื่อใส่รูปภาพหรือสื่ออื่นๆ ภายในส่วนเนื้อหาของอีเมล ไม่แสดงเป็นรายการแยก แต่จะแสดงโดยตรงในเนื้อหาอีเมล เช่น ในส่วนเนื้อหาของอีเมล ซึ่งช่วยให้คุณสามารถใส่รูปภาพหรือสื่ออื่นๆ ที่เป็นส่วนหนึ่งของเนื้อความได้ ตัวอย่างโค้ดด้านล่างแสดงวิธีการกำหนดว่าไฟล์แนบเป็นแบบ inline หรือ 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}")

บันทึกไฟล์แนบจากไฟล์ Outlook Message (MSG)

เพื่อบันทึกไฟล์แนบจากไฟล์ MSG:

วนลูปผ่านคอลเลกชัน MapiAttachmentCollection เพื่อดึงไฟล์แนบแต่ละไฟล์.
เพื่อบันทึกไฟล์แนบ ให้เรียกเมธอด Save() ของคลาส MapiAttachment.

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการบันทึกไฟล์แนบลงดิสก์ในเครื่อง.

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)

การดึงไฟล์แนบเมลแบบซ้อนกัน

ไฟล์แนบ OLE ที่ฝังอยู่ก็ปรากฏในคอลเลกชัน Attachment ของคลาส MapiMessage ตัวอย่างโค้ดต่อไปนี้ทำการพาร์สไฟล์ข้อความเพื่อหาไฟล์แนบที่ฝังอยู่และบันทึกลงดิสก์ เมธอดสถิติกลาส FromProperties() ของ MapiMessage สามารถสร้างข้อความใหม่จากไฟล์แนบที่ฝังอยู่ โค้ดตัวอย่างต่อไปนี้แสดงวิธีการดึงไฟล์แนบเมลแบบซ้อนกัน.

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)

การลบไฟล์แนบ

ไลบรารี Aspose Outlook ให้ฟังก์ชันการลบไฟล์แนบจากไฟล์ Microsoft Outlook Message (.msg):

เรียกเมธอด RemoveAttachments() ซึ่งรับพาธของไฟล์ข้อความเป็นพารามิเตอร์ ถูกกำหนดเป็นเมธอดสาธารณะแบบสถิติ จึงไม่จำเป็นต้องสร้างอ็อบเจกต์.

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการลบไฟล์แนบ.

import aspose.email as ae

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

คุณสามารถเรียกเมธอดสถาติก DestoryAttachment() ของคลาส MapiMessage ได้ มันทำงานเร็วกว่า RemoveAttachment() เพราะเมธอด RemoveAttachment() จะทำการพาร์สไฟล์ข้อความ.

import aspose.email as ae

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

การเพิ่มไฟล์แนบ MSG

ข้อความ Outlook สามารถมีข้อความ Microsoft Outlook อื่นเป็นไฟล์แนบได้ ทั้งในรูปแบบปกติหรือฝังตัว MapiAttachmentCollection มีเมธอด Add ที่มีการโอเวอร์โหลดเพื่อสร้างข้อความ Outlook พร้อมทั้งสองประเภทของไฟล์แนบ.

ลองใช้ดู!

เพิ่มหรือลบไฟล์แนบอีเมลออนไลน์ด้วยบริการฟรี แอป Aspose.Email Editor.

เพิ่มไฟล์แนบอ้างอิงให้กับ MapiMessage

"ไฟล์แนบอ้างอิง" โดยทั่วไปหมายถึงไฟล์แนบที่มีการอ้างอิงหรือเชื่อมโยงไปยังแหล่งทรัพยากรภายนอก แทนไฟล์จริง การอ้างอิงนี้มักใช้ในอีเมล HTML เพื่อเชื่อมโยงภาพหรือทรัพยากรภายนอกที่โฮสต์บนเซิร์ฟเวอร์ระยะไกล แทนการฝังไฟล์ทั้งหมด ไฟล์แนบอ้างอิงจะมี URL หรือการอ้างอิงไปยังเนื้อหาภายนอก

Aspose.Email มีชุดเครื่องมือสำหรับการแสดงไฟล์แนบอ้างอิงอย่างถูกต้อง ซึ่งแสดงในตัวอย่างโค้ดต่อไปนี้:

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

ฝังข้อความเป็นไฟล์แนบ

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการที่ไฟล์ Outlook MSG ฝังอยู่ในไฟล์ MSG ที่มี PR_ATTACH_METHOD มีค่าเท่ากับ 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")

อ่านข้อความที่ฝังอยู่จากไฟล์แนบ

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการอ่านข้อความที่ฝังอยู่จากไฟล์แนบ.

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

การแทรกและการแทนที่ไฟล์แนบ

API ของ Aspose.Email ให้ความสามารถในการแทรกไฟล์แนบในตำแหน่งเฉพาะของข้อความพาเรนต์ นอกจากนี้ยังให้ฟังก์ชันการแทนที่เนื้อหาไฟล์แนบด้วยไฟล์แนบจากข้อความอื่น โค้ดตัวอย่างต่อไปนี้แสดงการแทรกและการแทนที่ไฟล์แนบ.

แทรกในตำแหน่งที่กำหนด

API ของ Aspose.Email ให้ความสามารถในการแทรกไฟล์แนบ MSG ไปยัง MSG พาเรนต์โดยใช้เมธอด Insert ของ MapiAttachmentCollection MapiAttachmentCollection Insert(int index, string name, MapiMessage msg) โค้ดตัวอย่างต่อไปนี้แสดงวิธีการแทรกในตำแหน่งที่กำหนด.

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)

แทนที่เนื้อหาไฟล์แนบ

นี่สามารถใช้แทนที่เนื้อหาไฟล์แนบที่ฝังอยู่ด้วยไฟล์ใหม่โดยใช้เมธอด Replace อย่างไรก็ตาม ไม่สามารถใช้แทรกไฟล์แนบที่มี PR_ATTACH_NUM = 4 (เช่น) ในคอลเลกชันที่มี collection.Count = 2 ได้ โค้ดตัวอย่างต่อไปนี้แสดงวิธีการแทนที่เนื้อหาไฟล์แนบ.

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)

เปลี่ยนชื่อไฟล์แนบใน MapiMessage

สามารถแก้ไขชื่อการแสดงผลของไฟล์แนบในข้อความอีเมลที่โหลดจากไฟล์ได้ ตัวอย่างโค้ดด้านล่างแสดงวิธีทำเช่นนี้:

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: ทำงานกับรายการปฏิทิน Outlook

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

ทำงานกับ MapiCalendar

คลาส MapiCalendar ของ Aspose.Email ให้เมธอดและแอตทริบิวต์เพื่อกำหนดคุณสมบัติต่างๆ ของรายการปฏิทิน.

การสร้างและบันทึกรายการปฏิทิน

โค้ดตัวอย่างต่อไปนี้แสดงวิธีสร้างและบันทึกรายการปฏิทินในรูปแบบ 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)

บันทึกรายการปฏิทินเป็น MSG

โค้ดตัวอย่างต่อไปนี้แสดงวิธีบันทึกรายการปฏิทินเป็นไฟล์ MSG.

การตั้งค่า Product ID เมื่อบันทึก MapiCalendar เป็นไฟล์ ICS

Aspose.Email library ให้คุณบันทึก MapiCalendar (รายการปฏิทิน) ไปยังไฟล์ ICS (iCalendar) ด้วยตัวเลือกเฉพาะ ด้วยคุณสมบัติ ics_save_options.keep_original_date_time_stamp และ ics_save_options.product_identifier คุณสามารถรักษาเวลาประทับต้นฉบับที่เชื่อมโยงกับรายการปฏิทินและตั้งค่าตัวระบุผลิตภัณฑ์ในไฟล์ ICS ตัวอย่างเช่นเป็น "Foo Ltd" ตามลำดับ ตัวระบุผลิตภัณฑ์เป็นฟิลด์ที่บ่งบอกซอฟต์แวร์หรือบริการที่สร้างไฟล์ ICS

นี่คือตัวอย่างโค้ดที่ให้คุณตั้งค่า Product ID เมื่อบันทึก MapiCalendar เป็นไฟล์ 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)

การดึงจำนวนเหตุการณ์ทั้งหมด

ฟังก์ชันของ CalendarReader คลาสอนุญาตให้คุณอ่านข้อมูลปฏิทินจากไฟล์ที่ระบุ โดยการสร้างอ็อบเจกต์ CalendarReader เราสามารถดึงข้อมูลสำคัญเช่นจำนวนเหตุการณ์ทั้งหมด, เวอร์ชันปฏิทิน, วิธีการที่ใช้, และว่าปฏิทินมีหลายเหตุการณ์หรือไม่ ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการทำงานกับข้อมูลปฏิทินและยังโหลดการนัดหมายจากปฏิทินเป็นรายการหลายเหตุการณ์.

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

เพิ่มการเตือนแบบแสดงผลในปฏิทิน

โค้ดตัวอย่างต่อไปนี้แสดงวิธีเพิ่มการเตือนแบบแสดงผลในปฏิทิน.

การเพิ่มการแจ้งเตือนด้วยเสียงในปฏิทิน

โค้ดตัวอย่างต่อไปนี้แสดงวิธีเพิ่มการแจ้งเตือนแบบเสียงให้กับปฏิทิน.

เพิ่ม/ดึงไฟล์แนบจากไฟล์ปฏิทิน

โมดูล Aspose.Email Calendar ("ae.calendar") ยังให้ฟังก์ชันการเพิ่มและดึงข้อมูลไฟล์แนบ.

เพื่อแนบไฟล์แนบกับการนัดหมาย จะสร้างอ็อบเจกต์ "Attachment" พร้อมระบุพาธไฟล์ ไฟล์แนบนี้จะถูกเพิ่มไปยังรายการไฟล์แนบของการนัดหมาย การนัดหมายจะถูกบันทึกลงพาธไฟล์ที่กำหนดในรูปแบบ iCalendar โดยใช้ บันทึก เมธอดและรูปแบบไฟล์ที่เหมาะสม.
เพื่อดึงไฟล์แนบจากการนัดหมาย จะโหลดจากไฟล์ที่บันทึกไว้โดยใช้ โหลด เมธอดนี้จะแสดงจำนวนไฟล์แนบที่อยู่ใน "appointment2" และด้วยการวนลูปไฟล์แนบจะแสดงชื่อของพวกมัน.

โค้ดตัวอย่างด้านล่างแสดงวิธีสร้างนัดหมายพร้อมไฟล์แนบ, บันทึกมัน, และดึงข้อมูลไฟล์แนบโดยใช้โมดูล "ae.calendar" ซึ่งเน้นฟังก์ชันและความสามารถของการทำงานกับนัดหมายและไฟล์แนบในแอปพลิเคชันปฏิทิน.

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)

สถานะของผู้รับจากคำขอการประชุม

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการตรวจสอบสถานะของผู้รับจากคำขอประชุม.

แปลงการนัดหมาย EML เป็น MSG คงเนื้อหาในรูปแบบ HTML

Aspose.Email ทำให้สามารถแปลงการนัดหมาย EML ไปเป็น MSG และคงเนื้อหา HTML ได้ คุณสมบัติ "forced_rtf_body_for_appointment" ของ MapiConversionOptions คลาสนี้ใช้เพื่อจัดการประเภทของเนื้อหานัดหมาย เมื่อตั้งค่าเป็น True เนื้อหาจะถูกแปลงเป็นรูปแบบ RTF โดยค่าเริ่มต้น เพื่อรักษาเนื้อหาเป็นรูปแบบ HTML ควรตั้งค่าเป็น False ตัวอย่างโค้ดต่อไปนี้แสดงวิธีรักษา HTML Body ของนัดหมายเมื่อแปลงจาก EML ไปเป็น 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: ทำงานกับรายชื่อ Outlook

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

การสร้าง, บันทึกและอ่านรายชื่อติดต่อ

เช่นเดียวกับ MapiMessage, Aspose.Email อนุญาตให้คุณสร้างรายชื่อ Outlook คลาส MapiContact ให้คุณสมบัติที่เกี่ยวข้องทั้งหมดที่จำเป็นสำหรับการสร้างรายชื่อ Outlook บทความนี้แสดงวิธีการสร้าง, บันทึกและอ่านรายชื่อ Outlook ด้วยคลาส MapiContact.

สร้างและบันทึกรายชื่อ Outlook

เพื่อสร้างรายชื่อและบันทึกลงดิสก์:

สร้างอ็อบเจกต์ใหม่ของคลาส MapiContact.
ป้อนข้อมูลคุณสมบัติของรายชื่อติดต่อ.
เพิ่มข้อมูลรูปภาพ (ถ้ามี).
บันทึกผู้ติดต่อเป็นรูปแบบ MSG หรือ VCard.

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการสร้างและบันทึกรายชื่อ 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)

บันทึกรายชื่อในรูปแบบ VCF เวอร์ชัน 3

เพื่อบันทึกรายชื่อติดต่อในรูปแบบ VCF เวอร์ชัน 3 ให้ใช้คุณสมบัติ version ของ VCardSaveOptions คลาส สร้างอินสแตนซ์ใหม่ของคลาส VCardSaveOptions ตั้งค่า property version ของอ็อบเจกต์ VCardSaveOptions เป็น VCardVersion.V30 ซึ่งจะกำหนดเวอร์ชัน vCard เป็น 3.0 แล้วเรียกเมธอด save ของอ็อบเจกต์ MapiContact โดยส่งชื่อไฟล์ "contact.vcf" และอ็อบเจกต์ VCardSaveOptions เป็นพารามิเตอร์ นี้จะบันทึกรายชื่อเป็นไฟล์ vCard ด้วยชื่อไฟล์และตัวเลือกที่ระบุ ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการบันทึกรายชื่อในรูปแบบ VCF เวอร์ชัน 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)

การอ่าน MapiContact

คลาส MapiContact สามารถใช้เพื่อโหลดรายชื่อในรูปแบบ Outlook MSG และ VCard ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการโหลดรายชื่อ Outlook ที่บันทึกเป็น MSG และ VCF ไปยัง MapiContact.

การโหลดรายชื่อจาก MSG

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการโหลดรายชื่อจาก MSG.

การโหลดรายชื่อจาก VCard

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการโหลดรายชื่อจาก vCard.

การโหลดรายชื่อจาก VCard ด้วยการเข้ารหัสที่ระบุ

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการโหลดรายชื่อจาก vcard ด้วยการเข้ารหัสที่ระบุ.

การบันทึกรายการติดต่อ VCard ด้วยการเข้ารหัสที่ระบุ

เมื่อบันทึกไฟล์ vCard สามารถระบุการเข้ารหัสอักขระที่ใช้เพื่อให้เข้ากันได้กับอักขระที่ไม่ใช่ ASCII ตั้งค่าคุณสมบัติ preferred_text_encoding ของอ็อบเจกต์ VCardSaveOptions เป็น "utf-8" ตัวอย่างโค้ดต่อไปนี้แสดงวิธีนำฟังก์ชันนี้ไปใช้ในโปรเจกต์ของคุณ:

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)

การบันทึกไฟล์ VCard พร้อมฟิลด์ขยาย

เมื่อบันทึกไฟล์ vCard คุณสามารถระบุตัวเลือกรวมถึงการใช้ฟิลด์ขยายซึ่งเป็นคุณสมบัติเพิ่มเติมหรือแอททริบิวต์ที่สามารถเพิ่มลงใน vCard นอกเหนือจากชุดฟิลด์มาตรฐานที่กำหนดโดยสเปค vCard คุณสมบัติ use_extensions ของ VCardSaveOptions คลาสทำให้คุณทำเช่นนั้นได้ ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการบันทึกไฟล์ 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)

การอ่านหลายรายการในรูปแบบ VCard

คุณจะต้องใช้เมธอดต่อไปนี้เพื่อดึงรายชื่อทั้งหมดจาก 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)

โค้ดตัวอย่างด้านล่างจะแสดงกระบวนการอ่านหลายรายการจากไฟล์ 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")

เรนเดอร์ข้อมูลผู้ติดต่อเป็น MHTML

รายชื่อ Outlook สามารถแปลงเป็น MHTML ได้โดยใช้ Aspose.Email API ตัวอย่างนี้แสดงวิธีการโหลด VCard เข้าไปใน MapiContact แล้วแปลงเป็น MHTML ด้วยความช่วยเหลือของ MailMessage API.

Python-Net: ทำงานกับโน้ต Outlook

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

การสร้าง, บันทึกและอ่านโน้ต

Aspose.Email มีฟังก์ชันในการสร้างโน้ต Outlook และบันทึกลงดิสก์ในรูปแบบ MSG คลาส MapiNote ให้คุณสมบัติและเมธอดสำหรับกำหนดข้อมูลงาน บทความนี้แสดงวิธีการสร้าง, บันทึกและอ่าน MapiNote จากดิสก์.

การสร้างและบันทึกโน้ต Outlook

ขั้นตอนต่อไปนี้สามารถใช้เพื่อสร้างและบันทึกโน้ตลงดิสก์:

สร้างอ็อบเจกต์ของคลาส MapiNote.
ตั้งค่าคุณสมบัติต่างๆ.
บันทึกโน้ตลงดิสก์เป็นไฟล์ MSG.

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการสร้างและบันทึกโน้ต Outlook.

การอ่าน MapiNote

อ็อบเจกต์คลาส MapiNote ใช้เพื่อแคสท์อ็อบเจกต์ MapiMessage ที่โหลดโน้ตจากดิสก์ในรูปแบบ MSG ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการอ่าน MapiNote.

Python-Net: ทำงานกับงาน Outlook

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

การสร้าง, บันทึกและอ่านงาน

Aspose.Email สำหรับ .NET ช่วยให้คุณสร้างงาน Outlook และบันทึกเป็นรูปแบบ MSG ได้ คลาส MapiTask มีคุณสมบัติมากมายเช่น Percentcomplete, Estimatedeffort, ActualEffort, History, LastUpdate และอื่น ๆ เพื่อกำหนดข้อมูลที่จำเป็นสำหรับงาน Outlook บทความนี้แสดงวิธีสร้าง, บันทึกและอ่าน MapiTask จากดิสก์ เพื่อสร้างและบันทึกงานลงดิสก์:

สร้างอ็อบเจกต์ใหม่ของคลาส MapiContact.
ป้อนข้อมูลคุณสมบัติงาน.
บันทึกงานลงดิสก์ในรูปแบบ MSG.

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการสร้าง, บันทึกและอ่านงาน.

การอ่าน MapiTask

อ็อบเจกต์คลาส MapiContact ถูกใช้เพื่อแปลงอ็อบเจกต์ MapiMessage ที่โหลดงานจากดิสก์ในรูปแบบ MSG โค้ดตัวอย่างต่อไปนี้แสดงวิธีการอ่าน MapiTask.

การอ่านงาน VToDo

Google Tasks ที่ส่งออกในรูปแบบ iCalendar เป็นเหตุการณ์ VToDo สามารถโหลดด้วยคลาส MapiTask ตามตัวอย่างโค้ดต่อไปนี้ โค้ดตัวอย่างต่อไปนี้แสดงวิธีการอ่านงาน 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)

การเพิ่มข้อมูลการเตือนให้กับ MapiTask

เช่นเดียวกับ Microsoft Outlook, Aspose.Email สามารถเพิ่มข้อมูลการเตือนให้กับ MapiTask ได้ โค้ดตัวอย่างต่อไปนี้แสดงวิธีการเพิ่มข้อมูลการเตือนให้กับ MapiTask.

การเพิ่มไฟล์แนบให้กับ MapiTask

ใช้ Add เมธอดของ MapiAttachmentCollection class เพื่อเพิ่มไฟล์แนบให้กับ MapiTask ตัวอย่างโค้ดต่อไปนี้จะช่วยคุณได้:

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)

การเพิ่มการเกิดซ้ำให้กับ MapiTask

Aspose.Email รองรับการสร้างงานที่เกิดซ้ำที่สามารถทำซ้ำเป็นรายวัน, รายสัปดาห์, รายเดือน หรือรายปี โค้ดตัวอย่างต่อไปนี้แสดงวิธีการสร้างงานด้วยประเภทการเกิดซ้ำที่ต่างกัน.

การแปลงงานเป็น MHT

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีแปลงงานเป็นรูปแบบ MHT พร้อมระบุตัวเลือกเพิ่มเติมสำหรับรูปแบบ MHT เมื่อควรเรนเดอร์ฟิลด์เฉพาะงาน (RENDER_TASK_FIELDS) และต้องรวมข้อมูลส่วนหัว (WRITE_HEADER) คุณสมบัติ mht_format_options ของ MhtSaveOptions class ใช้เพื่อกำหนดตัวเลือกเพิ่มเติมเมื่อบันทึกในรูปแบบ 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: การทำงานกับตัวเลือกโหวตโดยใช้ MapiMessage

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

สร้างตัวเลือกโหวตโดยใช้ MapiMessage

Microsoft Outlook ให้ผู้ใช้สร้างโพลขณะเขียนข้อความใหม่ สามารถใส่ตัวเลือกโหวตเช่น ใช่, ไม่ใช่, อาจจะ เป็นต้น Aspose.Email รองรับเช่นเดียวกันเมื่อตั้งค่าข้อความ Outlook ใหม่ โดย FollowUpOptions คลาสให้คุณสมบัติ VotingButtons ที่ใช้ตั้งหรือรับค่าตัวเลือกการโหวต บทความนี้ให้ตัวอย่างละเอียดของการสร้าง MapiMesasge พร้อมตัวเลือกการโหวตสำหรับสร้างการสำรวจ.

สร้างโพลโดยใช้ MapiMessage

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีใช้คุณสมบัติ voting_buttons ของ FollowUpOptions คลาสเพื่อสร้างการสำรวจ:

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

อ่านตัวเลือกโหวตจาก MapiMessage

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการอ่านตัวเลือกการโหวตจาก MapiMessage.

อ่านเฉพาะปุ่มโหวต

โค้ดสแนปต่อไปนี้แสดงวิธีอ่านเฉพาะปุ่มโหวต

การเพิ่มปุ่มโหวตไปยังข้อความที่มีอยู่

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการเพิ่มปุ่มโหวตไปยังข้อความที่มีอยู่.

การลบปุ่มโหวตจากข้อความ

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการลบปุ่มโหวตจากข้อความ.

อ่านข้อมูลผลลัพธ์การโหวต

โค้ดสแนปต่อไปนี้แสดงวิธีอ่านข้อมูลผลลัพธ์การโหวต

ตั้งค่าแฟล็กข้อความที่ยังไม่ได้ส่ง

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการตัวอย่างเมธอดที่ใช้ในตัวอย่าง.

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)