Documentation – ทำงานกับไฟล์จัดเก็บข้อมูล Outlook (OST หรือ PST)

Python-Net: สร้างและจัดระเบียบไฟล์ PST ด้วย Python

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

สร้างไฟล์ PST ใหม่และเพิ่มโฟลเดอร์ย่อย

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

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีสร้างไฟล์จัดเก็บใหม่และเพิ่มโฟลเดอร์ "Inbox" เข้าไปในไฟล์

ใช้ PersonalStorage.create เมธอดเพื่อสร้างไฟล์ PST ใหม่ในไดเรกทอรีที่ระบุ ไฟล์จะถูกสร้างโดยใช้ UNICODE รูปแบบเพื่อความเข้ากันได้กับแอปพลิเคชันสมัยใหม่.
เข้าถึงโฟลเดอร์รากของไฟล์ PST และเพิ่มโฟลเดอร์ย่อยใหม่ชื่อ "Inbox" เพื่อจัดระเบียบข้อความอีเมล

การตรวจสอบการแมตช์คลาสคอนเทนเนอร์

Aspose.Email สำหรับ Python มีวิธีแก้ที่เพิ่มประสิทธิภาพกระบวนการตรวจสอบระหว่างการสร้างโฟลเดอร์ในไฟล์ PST ด้วยคุณสมบัติ enforce_container_class_matching ของ FolderCreationOptions คลาสนี้ช่วยให้คุณบังคับให้คลาสคอนเทนเนอร์ต้องตรงกันอย่างเคร่งครัดเมื่อเพิ่มโฟลเดอร์ใหม่ไปยังที่จัดเก็บ PST ฟีเจอร์นี้ช่วยรักษาโครงสร้างองค์กรภายในไฟล์ PST โดยป้องกันการไม่ตรงกันของคลาสคอนเทนเนอร์ หากตั้งค่า ‘EnforceContainerClassMatching’ เป็น ’true’ จะขว้างข้อยกเว้นเมื่อคลาสคอนเทนเนอร์ของโฟลเดอร์พ่อและลูกไม่ตรงกัน เพื่อป้องกันโครงสร้างโฟลเดอร์ที่ไม่ถูกต้อง พฤติกรรมเริ่มต้นของคุณสมบัตินี้คือ ‘false’ ทำให้การสร้างโฟลเดอร์มีความยืดหยุ่นในขณะเดียวกันก็สามารถบังคับให้ตรงกันอย่างเคร่งครัดเมื่อจำเป็น

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

with PersonalStorage.create("storage.pst", FileFormatVersion.Unicode) as pst:
    contacts = pst.createpredefinedfolder("Contacts", StandardIpmFolder.Contacts)
    
    # An exception will not arise. EnforceContainerClassMatching is False by default.
    contacts.addsubfolder("Subfolder1", "IPF.Note")
    
    # An exception will occur as the container class of the subfolder being added (IPF.Note)
    # does not match the container class of the parent folder (IPF.Contact).
    contacts.addsubfolder("Subfolder3", FolderCreationOptions(enforcecontainerclassmatching=True, containerclass="IPF.Note"))

เปลี่ยนคลาสคอนเทนเนอร์ของโฟลเดอร์

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

เพิ่มข้อความเป็นกลุ่มด้วยประสิทธิภาพที่ดีกว่า

การเพิ่มข้อความเป็นกลุ่มลงในไฟล์ PST แทนการเพิ่มแบบแยกเดี่ยว สามารถให้ประโยชน์หลายประการ โดยเฉพาะในเรื่องของประสิทธิภาพและประสิทธิผล: ปฏิบัติการ I/O น้อยลง เวลาในการทำงานสั้นลง การใช้ทรัพยากรระบบมีประสิทธิภาพมากขึ้น เป็นต้น เมธอด add_messages ของ FolderInfo คลาสนี้ใช้ในการโอนย้ายคอลเลกชันของข้อความ MAPI ที่ได้จากโฟลเดอร์ต้นทางไปยังโฟลเดอร์ปลายทาง

เพิ่มข้อความจาก PST อื่น

เพื่อทำการ enumerate และดึงข้อความ MAPI ทั้งหมดจากโฟลเดอร์ต้นทางของไฟล์ PST ให้ใช้เมธอด enumerate_mapi_messages() ของ FolderInfo คลาส จากนั้นเพิ่มข้อความเหล่านี้ไปยังโฟลเดอร์ปลายทางของไฟล์ PST อื่น

import aspose.email as ae

src_pst = ae.storage.pst.PersonalStorage.from_file("source.pst", False)
dest_pst = ae.storage.pst.PersonalStorage.from_file("destination.pst")

# Get the folder by name
src_folder = src_pst.root_folder.get_sub_folder("SomeFolder")
dest_folder = dest_pst.root_folder.get_sub_folder("SomeFolder")

dest_folder.add_messages(src_folder.enumerate_mapi_messages())

เพิ่มข้อความจากไดเรกทอรี

เพื่อเพิ่มข้อความจากไดเรกทอรี หลังจากเปิดไฟล์และได้อ้างอิงไปยังโฟลเดอร์เฉพาะในไฟล์ PST แล้ว ให้ดึงรายการชื่อไฟล์จากไดเรกทอรีที่ระบุด้วยตัวแปร "path" และสร้างรายการ MSG ว่างเพื่อโหลดแต่ละไฟล์เป็น MapiMessage จากนั้นเพิ่มข้อความที่โหลดแล้วเข้าไปใน msg_list ตัวอย่างโค้ดด้านล่างแสดงกระบวนการเพิ่มข้อความจากไดเรกทอรี:

import aspose.email as ae
import os

pst = ae.storage.pst.PersonalStorage.from_file("my.pst", False)

# Get the folder by name
folder = pst.root_folder.get_sub_folder("SomeFolder")

dirs = os.listdir("path")
msg_list = []

for file in dirs:
    msg = ae.mapi.MapiMessage.load(file)
    msg_list.append(msg)

folder.add_messages(iter(msg_list))

Python-Net: อ่านและแปลงไฟล์ Outlook OST

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

Aspose.Email สำหรับ .NET ให้ API สำหรับอ่านไฟล์ Microsoft Outlook OST คุณสามารถโหลดไฟล์ OST จากดิสก์หรือสตรีมเข้าอินสแตนซ์ของ Aspose.Email.Outlook.Pst.PersonalStorage คลาสและรับข้อมูลเกี่ยวกับเนื้อหา เช่น โฟลเดอร์ โฟลเดอร์ย่อยและข้อความ Microsoft Outlook สร้างไฟล์ PST เพื่อเก็บอีเมลเมื่อใช้เซิร์ฟเวอร์ POP3 หรือ IMAP ในการดาวน์โหลดข้อความ ในขณะที่ไฟล์ OST จะถูกสร้างเมื่อ Microsoft Exchange เป็นเซิร์ฟเวอร์เมล ไฟล์ OST ออกแบบให้รองรับขนาดไฟล์ใหญ่กว่าไฟล์ PST.

การอ่านไฟล์ OST

กระบวนการอ่านไฟล์ OST ด้วย Aspose.Email นั้นเหมือนกับการอ่านไฟล์ PST อย่างเดียวกัน โค้ดเดียวกันสามารถอ่านไฟล์ PST และ OST ได้: เพียงระบุชื่อไฟล์ที่ถูกต้องให้กับ PersonalStorage.from_file() เมธอด ส่วนโค้ดต่อไปนี้แสดงวิธีอ่านไฟล์ OST:

แปลง OST เป็น PST

ลองใช้ดู!

แปลงอีเมลและคลังข้อความออนไลน์ด้วยเวอร์ชันฟรี แอปแปลง Aspose.Email.

Aspose.Email ทำให้สามารถแปลงไฟล์ OST ไปเป็น PST ด้วยบรรทัดโค้ดเดียวเช่นเดียวกัน ไฟล์ OST สามารถสร้างจากไฟล์ PST โดยใช้บรรทัดโค้ดเดียวกันพร้อมกับ รูปแบบไฟล์ enumerator ปัจจุบัน API รองรับการแปลงรูปแบบ OST ไปเป็น PST ยกเว้น OST 2013/2016 ส่วนโค้ดต่อไปนี้แสดงวิธีแปลง OST เป็น PST:

แปลง PST เป็น OST

การแปลงจาก PST เป็น OST ไม่ได้รับการสนับสนุนโดย Aspose.Email เนื่องจาก OST จะถูกสร้างโดย Outlook เสมอเมือเพิ่มบัญชีและซิงค์กับเซิร์ฟเวอร์เมล ความแตกต่างระหว่างไฟล์ PST และ OST คือ PST มีอยู่เฉพาะในเครื่องเท่านั้น ส่วนเนื้อหา OST มีอยู่บนเซิร์ฟเวอร์อีเมล ดังนั้นจึงไม่จำเป็นต้องแปลง PST เป็น OST เพื่อใช้งานในเครื่อง แต่คุณสามารถนำเข้า PST ไปยังบัญชีที่มีอยู่ได้โดยใช้วิซอร์ด Import/Export ใน Outlook

สำหรับการทำงานอื่นกับไฟล์ OST โปรดดูหน้านี้ต่อไปนี้:

อ่านไฟล์ Outlook PST และรับข้อมูลโฟลเดอร์และโฟลเดอร์ย่อย
รับข้อมูลข้อความจากไฟล์ Outlook PST
สกัดข้อความจากไฟล์ Outlook PST และบันทึกลงดิสก์หรือสตรีมในรูปแบบ MSG
เข้าถึงข้อมูลผู้ติดต่อจากไฟล์ Outlook PST และบันทึกลงดิสก์ในรูปแบบ MSG

Python-Net: อ่านไฟล์ Outlook PST ด้วย Aspose.Email สำหรับ Python .NET

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

Aspose.Email สำหรับ .NET มี API สำหรับอ่านไฟล์ Microsoft Outlook PST. คุณสามารถโหลดไฟล์ PST จากดิสก์หรือสตรีมเข้าไปยังอินสแตนซ์ของ PersonalStorage คลาสเพื่อเข้าถึงข้อมูลรายละเอียดของเนื้อหา เช่น โฟลเดอร์, โฟลเดอร์ย่อย, และข้อความ. นอกจากนี้ API ยังให้ความสามารถในการรวม โฟลเดอร์ค้นหา เมื่อดึงข้อความจากโฟลเดอร์ PST.

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

ไฟล์ Outlook PST สามารถโหลดในอินสแตนซ์ของ PersonalStorage คลาส. โค้ดตัวอย่างต่อไปนี้จะแสดงวิธีโหลดไฟล์ PST.

การแสดงข้อมูล PST

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

ดึงโฟลเดอร์ที่ผู้ใช้สร้างเท่านั้น

ไฟล์ PST/OST อาจมีโฟลเดอร์ที่ผู้ใช้สร้าง, กล่าวคือยกเว้นโฟลเดอร์ IPM มาตรฐานทั้งหมด. Aspose.Email มีฟังก์ชันเพื่อเข้าถึงเฉพาะโฟลเดอร์ที่ผู้ใช้สร้างโดยใช้คุณสมบัติ only_folders_created_by_user ของ PersonalStorageQueryBuilder คลาส. คุณสามารถตั้งค่าคุณสมบัตินี้เป็น True เพื่อดึงเฉพาะโฟลเดอร์ที่ผู้ใช้สร้าง. โค้ดตัวอย่างต่อไปนี้แสดงวิธีใช้คุณสมบัติ only_folders_created_by_user ในโครงการของคุณ:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

query_builder = ae.storage.pst.PersonalStorageQueryBuilder()
query_builder.only_folders_created_by_user.equals(True)

folders = pst.root_folder.get_sub_folders(query_builder.get_query())

for folder in folders:
    print(f"Folder: {folder.display_name}")

การระบุโฟลเดอร์ที่กำหนดล่วงหน้า

เพื่อตรวจสอบว่าโฟลเดอร์ในไฟล์ PST เป็นโฟลเดอร์มาตรฐานหรือไม่, ใช้เมธอด get_predefined_type ของ FolderInfo คลาส. โฟลเดอร์มาตรฐาน (หรือโฟลเดอร์ที่กำหนดล่วงหน้า), ตรงกันข้ามกับโฟลเดอร์ที่ผู้ใช้สร้าง, คือโฟลเดอร์ที่ Outlook สร้างขึ้นเมื่อคุณเพิ่มบัญชีอีเมล เช่น Inbox, Sent Items, Drafts, Deleted Items, Calendar, Tasks, Notes เป็นต้น.

ตัวอย่างโค้ดด้านล่างแสดงวิธีใช้เมธอดนี้ในโครงการ. หากตั้งค่าเป็น True, จะคืนค่าประเภทที่กำหนดล่วงหน้าสำหรับโฟลเดอร์พาเรนท์ระดับบนสุด. สิ่งนี้กำหนดว่าโฟลเดอร์ปัจจุบันเป็นโฟลเดอร์ย่อยของโฟลเดอร์ที่กำหนดล่วงหน้าหรือไม่. หากตั้งค่าเป็น False, จะคืนค่าประเภทที่กำหนดล่วงหน้าสำหรับโฟลเดอร์ปัจจุบัน.

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

folders = pst.root_folder.get_sub_folders()

for folder in folders:
    print(f"Folder: {folder.display_name}")
    print(f"Is predefined: {folder.get_predefined_type(False) != ae.storage.pst.StandardIpmFolder.UNSPECIFIED}")
    print("-----------------------------------")

การจัดการ RSS Feeds ใน PersonalStorage

Aspose.Email มีฟังก์ชันเพื่อดึงอ้างอิงถึงโฟลเดอร์ RSS Feeds ที่กำหนดล่วงหน้า, ให้ผู้พัฒนาสามารถเข้าถึงและจัดการ RSS feeds ที่เก็บอยู่ในไฟล์ Outlook PST ผ่านโปรแกรมได้. โดยการได้รับอ้างอิงถึง "โฟลเดอร์ RSS Feeds" นี้, ผู้พัฒนาสามารถทำงานกับข้อมูล RSS feed ซึ่งอาจรวมถึงการสมัครรับฟีดใหม่, การอัปเดตฟีดที่มีอยู่, หรือการดึงข้อมูลจากฟีด.

ค่าของ RssFeeds ใน StandardIpmFolder enum มักจะเป็นตัวแทนประเภทโฟลเดอร์ที่กำหนดล่วงหน้าซึ่งออกแบบมาสำหรับจัดเก็บ RSS feeds ภายในไฟล์ Outlook PST. โดยใช้ค่า enum นี้ นักพัฒนาสามารถระบุและโต้ตอบกับ "โฟลเดอร์ RSS Feeds" ผ่านโปรแกรมได้. ตัวอย่างโค้ดต่อไปนี้จะแสดงวิธีการนำคุณลักษณะนี้ไปใช้ในโครงการของคุณ:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

rss_folder = pst.get_predefined_folder(ae.storage.pst.StandardIpmFolder.RSS_FEEDS)

เพื่อ เพิ่มโฟลเดอร์ RSS Feeds, ใช้โค้ดตัวอย่างต่อไปนี้:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

rss_folder = pst.create_predefined_folder("RSS Feeds", ae.storage.pst.StandardIpmFolder.RSS_FEEDS)

การแยกวิเคราะห์โฟลเดอร์ที่ค้นหาได้

Aspose.Email มี FolderKind enumeration เพื่อทำงานกับประเภทต่างๆ ของโฟลเดอร์ PST. นอกจากโฟลเดอร์ NORMAL แล้ว ยังทำงานกับโฟลเดอร์ SEARCH. โฟลเดอร์ SEARCH คือโฟลเดอร์เสมือนที่แสดงรายการอีเมลทั้งหมดที่ตรงตามเงื่อนไขการค้นหาเฉพาะ. เพื่อแยกวิเคราะห์โฟลเดอร์ SEARCH, ใช้โค้ดตัวอย่างต่อไปนี้:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

folders = pst.root_folder.get_sub_folders(ae.storage.pst.FolderKind.SEARCH | ae.storage.pst.FolderKind.NORMAL)

# Browse through each folder to display folder name and number of messages
for folder in folders:
    print(f"Folder: {folder.display_name}")
    sub_folders = folder.get_sub_folders(ae.storage.pst.FolderKind.SEARCH | ae.storage.pst.FolderKind.NORMAL)
    for sub_folder in sub_folders:
        print(f"Sub-folder: {folder.display_name}")

การดึงข้อมูลโฟลเดอร์พาเรนท์

โค้ดสแนปชอตต่อไปนี้แสดงวิธีดึงข้อมูลโฟลเดอร์แม่จาก MessageInfo.

การดึงโฟลเดอร์ย่อยของ PST ตามเส้นทาง

เพื่ดึงโฟลเดอร์ย่อยของ PST ตามเส้นทาง, ใช้เมธอด get_sub_folder ของ FolderInfo คลาส. มันดึงโฟลเดอร์ย่อยเฉพาะจากไดเรกทอรีหรือระบบไฟล์.

เมธอดรับพารามิเตอร์ต่อไปนี้:

name - แสดงถึงชื่อของโฟลเดอร์ย่อยที่ต้องการดึง. ใช้ระบุชื่อหรือรหัสของโฟลเดอร์ย่อยที่เมธอดจะค้นหา.
ignore_case - เป็นค่า boolean ที่กำหนดว่ามethod ควรละเว้นความแตกต่างของตัวพิมพ์ใหญ่/เล็กเมื่อเปรียบเทียบชื่อโฟลเดอร์ย่อยหรือไม่. หากตั้งค่าเป็น True, เมธอดจะถือว่าชื่อที่ตรงกันโดยไม่สนใจตัวพิมพ์ (เช่น "folder" และ "Folder" จะถือว่าเท่ากัน). หากตั้งค่าเป็น False, เมธอดจะทำการเปรียบเทียบแบบคำนึงถึงตัวพิมพ์.
handle_path_separator - เป็นค่า boolean ที่ระบุว่ามethod ควรจัดการตัวคั่นเส้นทางเมื่อค้นหาโฟลเดอร์ย่อยหรือไม่. ตัวคั่นเส้นทางเป็นอักขระที่ใช้แยกโฟลเดอร์ในพาธไดเรกทอรี (เช่น "\" ใน Windows หรือ "/" ใน Unix). หากตั้งค่าเป็น True, เมธอดจะจัดการตัวคั่นเส้นทางโดยอัตโนมัติ, ทำให้การจับคู่โฟลเดอร์ถูกต้อง. หากตั้งค่าเป็น False, จะพิจารณาตัวคั่นเส้นทางเป็นส่วนหนึ่งของชื่อโฟลเดอร์ย่อย, ทำให้การค้นหาต่างกัน.

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีดึงโฟลเดอร์ย่อยของ PST ตามเส้นทาง:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

# In this sample, the method will return a ‘Jan’ named folder
# that is located at the Inbox\Reports\ path 
# relative to the root folder.
folder = pst.root_folder.get_sub_folder("Inbox\Reports\Jan", True, True)

Python-Net: การแยกและรวมไฟล์ PST

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

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

ลองใช้ดู!

ผสานและรวมไฟล์อีเมลหลายไฟล์ออนไลน์เป็นไฟล์เดียวด้วยบริการฟรี แอปพลิเคชัน Aspose.Email Merger.

การแยกไฟล์ PST

การแยกเป็นหลายไฟล์ PST

โค้ดตัวอย่างต่อไปนี้จะแสดงวิธีแยกไฟล์ storage เป็นหลายไฟล์:

import os
from aspose.email.storage.pst import PersonalStorage

data_dir = "DataDir_Outlook"
dst_split = os.path.join(data_dir, "Chunks")

# Delete the files if already present
for file in os.listdir(dst_split):
    file_path = os.path.join(dst_split, file)
    if os.path.isfile(file_path):
        os.remove(file_path)

pst_file = os.path.join(data_dir, "pst.pst")

try:
    with PersonalStorage.from_file(pst_file) as personal_storage:
        # Splits into PST chunks with a size of 5MB
        personal_storage.split_into(5000000, dst_split)

except Exception as ex:
    print(str(ex))
    print("This example will only work if you apply a valid Aspose.Email License. "
          "You can purchase a full license or get a 30-day"
          " temporary license from http://www.aspose.com/purchase/default.aspx.")

การแยกตามเกณฑ์เฉพาะ

โค้ดตัวอย่างต่อไปนี้จะแสดงวิธีแยกไฟล์ storage ตามเกณฑ์ที่กำหนด:

import os
from datetime import datetime
from aspose.email.tools.search import MailQueryBuilder
from aspose.email.storage.pst import PersonalStorage

data_dir = "DataDir_Outlook"
path_to_pst = os.path.join(data_dir, "pathToPst")
pst_file = os.path.join(data_dir, "PersonalStorage_New.pst")

# Define search criteria
builder = MailQueryBuilder()
builder.sent_date.since(datetime(2005, 4, 1))
builder.sent_date.before(datetime(2005, 4, 7))
query = builder.get_query()

# Delete existing PST files if any
if os.path.exists(path_to_pst):
    for file in os.listdir(path_to_pst):
        file_path = os.path.join(path_to_pst, file)
        if os.path.isfile(file_path) and file.endswith(".pst"):
            os.remove(file_path)

# Split Personal Storage into multiple PST files based on criteria
with PersonalStorage.from_file(pst_file) as personal_storage:
    personal_storage.split_into(query, path_to_pst)

การรวมไฟล์ PST

การรวมเป็นไฟล์ PST เดียว

โค้ดตัวอย่างต่อไปนี้จะแสดงวิธีรวมไฟล์ storage หลายไฟล์เป็นไฟล์เดียว:

import os
from aspose.email.storage.pst import PersonalStorage

data_dir = "DataDir_Outlook"
sub_pst = os.path.join(data_dir, "Sub.pst")
merge_folder = os.path.join(data_dir, "MergePST")
total_added = 0

try:
    with PersonalStorage.from_file(sub_pst) as personal_storage:
        # Merge with the PST files located in the separate folder.
        personal_storage.merge_with(os.path.join(merge_folder, "*"))
        print("Total messages added:", total_added)

    print("\nPST merged successfully at", sub_pst)
except Exception as ex:
    print(ex)
    print("This example will only work if you apply a valid Aspose Email License. "
          "You can purchase a full license or get a 30-day temporary license "
          "from http://www.aspose.com/purchase/default.aspx.")

การรวมโฟลเดอร์จาก PST อื่น

โค้ดตัวอย่างต่อไปนี้จะแสดงวิธีรวมโฟลเดอร์จาก PST อื่น:

from aspose.email.storage.pst import PersonalStorage, StandardIpmFolder

data_dir = "DataDir_Outlook\\"
destination_pst = PersonalStorage.from_file(data_dir + "destination.pst")
source_pst = PersonalStorage.from_file(data_dir + "source.pst")
total_added = 0

try:
    with destination_pst, source_pst:
        destination_folder = destination_pst.root_folder.add_sub_folder("FolderFromAnotherPst")
        source_folder = source_pst.get_predefined_folder(StandardIpmFolder.DELETED_ITEMS)

        # Merge with the folder from another PST.
        destination_folder.merge_with(source_folder)
        print("Total messages added:", total_added)

except Exception as ex:
    print(ex)
    print("This example will only work if you apply a valid Aspose Email License. "
          "You can purchase a full license or get a 30-day temporary license "
          "from http://www.aspose.com/purchase/default.aspx.")

Python-Net: การจัดการรายการปฏิทินในไฟล์ PST

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

เพิ่มเหตุการณ์ปฏิทินไปยังไฟล์ PST

สร้างไฟล์ PST ใหม่และเพิ่มโฟลเดอร์ย่อย แสดงวิธีสร้างไฟล์ PST และรวมโฟลเดอร์ย่อยภายใน ด้วย Aspose.Email คุณยังสามารถเพิ่ม MapiCalendar ลงในโฟลเดอร์ย่อย Calendar ของไฟล์ PST ที่มีอยู่หรือสร้างใหม่ ด้านล่างเป็นขั้นตอนการเพิ่ม MapiCalendar ลงในไฟล์ PST:

สร้าง MapiCalendar อ็อบเจ็กต์.
ตั้งค่าคุณสมบัติของ MapiCalendar โดยใช้คอนสตรัคเตอร์และเมธอดต่างๆ.
สร้าง PST ด้วย PersonalStorage.create() เมธอด.
สร้างโฟลเดอร์ที่กำหนดไว้ล่วงหน้า (Calendar) ที่รากของไฟล์ PST โดยเข้าถึงโฟลเดอร์รากแล้วเรียกเมธอด add_mapi_message_item()

โค้ดตัวอย่างต่อไปนี้แสดงวิธีสร้าง MapiCalendar แล้วเพิ่มลงในโฟลเดอร์ปฏิทินของไฟล์ PST ที่สร้างใหม่:

บันทึกรายการปฏิทิน Outlook เป็นไฟล์ ICS

บทความนี้อธิบายวิธีเข้าถึงรายการปฏิทินจากไฟล์ Outlook PST และบันทึกลงดิสก์ในรูปแบบ ICS คุณจะต้องใช้ PersonalStorage และ MapiCalendar คลาสเพื่อดึงข้อมูลปฏิทิน ทำตามขั้นตอนต่อไปนี้เพื่อบันทึกรายการปฏิทิน:

โหลดไฟล์ PST โดยใช้ PersonalStorage คลาส.
นำทางไปยังโฟลเดอร์ Calendar.
ดึงคอลเลกชันข้อความจากโฟลเดอร์ Calendar.
วนลูปผ่านชุดข้อความ.
ใช้ PersonalStorage.extract_message() เมธอดเพื่อรับข้อมูลรายชื่อใน MapiCalendar คลาส.
ใช้ MapiCalendar.save() เมธอดเพื่อบันทึกแต่ละรายการปฏิทินลงดิสก์ในรูปแบบ ICS.

โปรแกรมด้านล่างโหลดไฟล์ PST จากดิสก์และบันทึกรายการปฏิทินทั้งหมดเป็นรูปแบบ ICS ไฟล์ ICS สามารถใช้ในโปรแกรมอื่นที่สนับสนุนไฟล์ปฏิทินมาตรฐาน ICS เมื่อเปิดใน Microsoft Outlook ไฟล์ ICS จะแสดงตามภาพหน้าจอด้านล่าง.

โค้ดตัวอย่างต่อไปนี้สาธิตวิธีส่งออกรายการปฏิทินจาก Outlook PST ไปเป็นรูปแบบ ICS:

บันทึกไฟล์ ICS พร้อมแสดงเวลาเดิม

เมธอด keep_original_date_time_stamp ของ MapiCalendarIcsSaveOptions คลาสอนุญาตให้รักษาเวลาประทับวันที่และเวลาต้นฉบับของรายการปฏิทินเมื่อบันทึกเป็นไฟล์ ICS (iCalendar). ตัวอย่างโค้ดต่อไปนี้แสดงการนำเมธอดนี้ไปใช้:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

calendar_folder = pst.get_predefined_folder(ae.storage.pst.StandardIpmFolder.APPOINTMENTS)

for msg_info in calendar_folder.enumerate_messages():
    cal = pst.extract_message(msg_info).to_mapi_message_item()

    save_options = ae.mapi.MapiCalendarIcsSaveOptions()
    save_options.keep_original_date_time_stamp = True

    if not (cal is None):
      cal.save("cal.ics", save_options)

แก้ไขหรือ ลบ การเกิดซ้ำในไฟล์ PST

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

from datetime import datetime, timedelta
from aspose.email.storage.pst import PersonalStorage, StandardIpmFolder, FileFormatVersion
from aspose.email.mapi import MapiCalendar, MapiCalendarEventRecurrence, \
    MapiCalendarDailyRecurrencePattern, MapiCalendarRecurrenceEndType, \
    MapiCalendarExceptionInfo, MapiCalendarRecurrencePatternType, \
    MapiRecipientCollection, MapiRecipientType

start_date = datetime.now().date()

recurrence = MapiCalendarEventRecurrence()
pattern = MapiCalendarDailyRecurrencePattern()
pattern.pattern_type = MapiCalendarRecurrencePatternType.DAY
pattern.period = 1
pattern.end_type = MapiCalendarRecurrenceEndType.NEVER_END
recurrence.recurrence_pattern = pattern

exception_date = start_date + timedelta(days=1)

# adding one exception
exception_info = MapiCalendarExceptionInfo()
exception_info.location = "London"
exception_info.subject = "Subj"
exception_info.original_start_date = exception_date
exception_info.start_date_time = exception_date
exception_info.end_date_time = exception_date + timedelta(hours=5)
pattern.exceptions.append(exception_info)
pattern.modified_instance_dates.append(exception_date)
# every modified instance also has to have an entry in the DeletedInstanceDates field with the original instance date.
pattern.deleted_instance_dates.append(exception_date)

# adding one deleted instance
pattern.deleted_instance_dates.append(exception_date + timedelta(days=2))

rec_coll = MapiRecipientCollection()
rec_coll.add("receiver@domain.com", "receiver", MapiRecipientType.TO)
new_cal = MapiCalendar(
    "This is Location",
    "This is Summary",
    "This is recurrence test",
    start_date,
    start_date + timedelta(hours=3),
    "organizer@domain.com",
    rec_coll
)
new_cal.recurrence = recurrence

with PersonalStorage.create("output.pst", FileFormatVersion.UNICODE) as pst:
    calendar_folder = pst.create_predefined_folder("Calendar", StandardIpmFolder.APPOINTMENTS)
    calendar_folder.add_message(new_cal)

Python-Net: การทำงานกับรายการปฏิทินในไฟล์ PST

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

การเพิ่ม MapiCalendar ไปยัง PST

สร้างไฟล์ PST ใหม่และเพิ่มโฟลเดอร์ย่อยแสดงวิธีสร้างไฟล์ PST และเพิ่มโฟลเดอร์ย่อยลงในนั้น. ด้วย Aspose.Email คุณสามารถเพิ่ม MapiCalendar ไปยังโฟลเดอร์ย่อย Calendar ของไฟล์ PST ที่คุณสร้างหรือโหลดได้. ด้านล่างเป็นขั้นตอนการเพิ่ม MapiCalendar ไปยัง PST:

สร้างอ็อบเจ็กต์ MapiCalendar.
ตั้งค่าคุณสมบัติของ MapiCalendar โดยใช้คอนสตรัคเตอร์และเมธอดต่างๆ.
สร้าง PST โดยใช้เมธอด PersonalStorage.create().
สร้างโฟลเดอร์ที่กำหนดล่วงหน้า (Calendar) ที่รากของไฟล์ PST โดยเข้าถึงโฟลเดอร์รากและเรียกเมธอด add_mapi_message_item().

โค้ดตัวอย่างต่อไปนี้จะแสดงวิธีสร้าง MapiCalendar แล้วเพิ่มลงในโฟลเดอร์ calendar ของไฟล์ PST ที่สร้างใหม่.

บันทึกรายการปฏิทินจาก PST ลงดิสก์ในรูปแบบ ICS

บทความนี้แสดงวิธีเข้าถึงรายการปฏิทินจากไฟล์ Outlook PST และบันทึกปฏิทินลงดิสก์ในรูปแบบ ICS. ใช้คลาส PersonalStorage และ MapiCalendar เพื่อดึงข้อมูลปฏิทิน. ด้านล่างเป็นขั้นตอนการบันทึกรายการปฏิทิน:

โหลดไฟล์ PST ในคลาส PersonalStorage.
เรียกดูโฟลเดอร์ Calendar.
รับเนื้อหาของโฟลเดอร์ Calendar เพื่อรับชุดข้อความ
วนลูปผ่านชุดข้อความ.
เรียกเมธอด PersonalStorage.extract_message() เพื่อรับข้อมูลผู้ติดต่อในคลาส MapiCalendar.
เรียกเมธอด MapiCalendar.save() เพื่อบันทึกรายการปฏิทินลงดิสก์ในรูปแบบ ICS.

โปรแกรมข้างล่างโหลดไฟล์ PST จากดิสก์และบันทึกรายการปฏิทินทั้งหมดเป็นรูปแบบ ICS. ไฟล์ ICS นี้สามารถใช้ในโปรแกรมอื่นใดที่สามารถเปิดไฟล์ปฏิทินมาตรฐาน ICS ได้. เมื่อเปิดใน Microsoft Outlook ไฟล์ ICS จะมีลักษณะเช่นภาพหน้าจอด้านล่าง.

|| | :- | โค้ดตัวอย่างต่อไปนี้จะแสดงวิธีส่งออกรายการปฏิทินจาก Outlook PST ไปยังรูปแบบ ICS.

บันทึกเป็น ICS พร้อมเวลาตราบต้นฉบับ

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

calendar_folder = pst.get_predefined_folder(ae.storage.pst.StandardIpmFolder.APPOINTMENTS)

for msg_info in calendar_folder.enumerate_messages():
    cal = pst.extract_message(msg_info).to_mapi_message_item()

    save_options = ae.mapi.MapiCalendarIcsSaveOptions()
    save_options.keep_original_date_time_stamp = True

    if not (cal is None):
      cal.save("cal.ics", save_options)

แก้ไข/ลบเหตุการณ์จากการทำซ้ำ

สามารถเพิ่มข้อยกเว้นให้กับการเกิดซ้ำที่มีอยู่ได้โดยใช้ Aspose.Email for .NET API. ตัวอย่างโค้ดต่อไปนี้แสดงการใช้งานคุณลักษณะนี้.

from datetime import datetime, timedelta
from aspose.email.storage.pst import PersonalStorage, StandardIpmFolder, FileFormatVersion
from aspose.email.mapi import MapiCalendar, MapiCalendarEventRecurrence, \
    MapiCalendarDailyRecurrencePattern, MapiCalendarRecurrenceEndType, \
    MapiCalendarExceptionInfo, MapiCalendarRecurrencePatternType, \
    MapiRecipientCollection, MapiRecipientType

start_date = datetime.now().date()

recurrence = MapiCalendarEventRecurrence()
pattern = MapiCalendarDailyRecurrencePattern()
pattern.pattern_type = MapiCalendarRecurrencePatternType.DAY
pattern.period = 1
pattern.end_type = MapiCalendarRecurrenceEndType.NEVER_END
recurrence.recurrence_pattern = pattern

exception_date = start_date + timedelta(days=1)

# adding one exception
exception_info = MapiCalendarExceptionInfo()
exception_info.location = "London"
exception_info.subject = "Subj"
exception_info.original_start_date = exception_date
exception_info.start_date_time = exception_date
exception_info.end_date_time = exception_date + timedelta(hours=5)
pattern.exceptions.append(exception_info)
pattern.modified_instance_dates.append(exception_date)
# every modified instance also has to have an entry in the DeletedInstanceDates field with the original instance date.
pattern.deleted_instance_dates.append(exception_date)

# adding one deleted instance
pattern.deleted_instance_dates.append(exception_date + timedelta(days=2))

rec_coll = MapiRecipientCollection()
rec_coll.add("receiver@domain.com", "receiver", MapiRecipientType.TO)
new_cal = MapiCalendar(
    "This is Location",
    "This is Summary",
    "This is recurrence test",
    start_date,
    start_date + timedelta(hours=3),
    "organizer@domain.com",
    rec_coll
)
new_cal.recurrence = recurrence

with PersonalStorage.create("output.pst", FileFormatVersion.UNICODE) as pst:
    calendar_folder = pst.create_predefined_folder("Calendar", StandardIpmFolder.APPOINTMENTS)
    calendar_folder.add_message(new_cal)

Python-Net: การจัดการรายชื่อผู้ติดต่อ Outlook ในไฟล์ PST

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

เพิ่มรายชื่อ Outlook ไปยังไฟล์ PST

สร้างไฟล์ PST ใหม่และเพิ่มโฟลเดอร์ย่อย สาธิตวิธีสร้างไฟล์ PST และรวมโฟลเดอร์ย่อยภายใน ด้วย Aspose.Email คุณสามารถเพิ่ม MapiContact ลงในโฟลเดอร์ย่อย Contacts ของไฟล์ PST ที่คุณสร้างหรือโหลดไว้ ด้านล่างเป็นขั้นตอนการเพิ่ม MapiContact ลงในไฟล์ PST:

สร้าง MapiContact อ็อบเจ็กต์.
ตั้งค่าคุณสมบัติของ MapiContact เช่น ชื่อ, เพศ, ที่อยู่อีเมล, หมายเลขโทรศัพท์, ที่อยู่ทางกายภาพ, และข้อมูลอาชีพโดยใช้คอนสตรัคเตอร์และเมธอดต่าง ๆ
สร้าง PST ด้วย PersonalStorage.create() เมธอด.
สร้างโฟลเดอร์ที่กำหนดล่วงหน้า (Contacts) ที่รากของไฟล์ PST โดยเข้าถึงโฟลเดอร์รากและจากนั้นเรียก add_mapi_message_item() เมธอด.

โค้ดตัวอย่างต่อไปนี้แสดงวิธีสร้างติดต่อ MAPI แล้วเพิ่มลงในโฟลเดอร์ Contacts ของไฟล์ PST ที่สร้างใหม่:

บันทึกรายชื่อ Outlook เป็นไฟล์ MSG

เพื่อเข้าถึงข้อมูลรายชื่อจากไฟล์ Outlook PST และบันทึกรายชื่อลงดิสก์ในรูปแบบ MSG, Aspose.Email ให้ PersonalStorage และ MapiContact คลาส ตัวอย่างโค้ดด้านล่างแสดงวิธีดึงข้อมูลรายชื่อทั้งหมดจากไฟล์ PST และบันทึกลงดิสก์ในรูปแบบ MSG:

โหลดไฟล์ PST ใน PersonalStorage คลาส.
เรียกดูโฟลเดอร์ Contacts.
รับเนื้อหาของโฟลเดอร์ Contacts เพื่อรับชุดข้อความ.
วนลูปผ่านชุดข้อความ.
เรียกใช้ PersonalStorage.extract_message() เมธอดเพื่อรับข้อมูลผู้ติดต่อใน MapiMessage คลาส.
เรียกใช้ MapiMessage.save() เมธอดเพื่อบันทึกผู้ติดต่อลงดิสก์ในรูปแบบ MSG.

ส่งออกรายชื่อ Outlook เป็นไฟล์ VCF

เพื่อเข้าถึงข้อมูลรายชื่อจากไฟล์ Microsoft Outlook PST และบันทึกรายชื่อลงดิสก์ในรูปแบบ vCard (VCF), ใช้ PersonalStorage และ MapiContact คลาส โค้ดด้านล่างโหลดไฟล์ PST จากดิสก์และบันทึกรายชื่อทั้งหมดเป็น vCard (VCF) ไฟล์ VCF สามารถใช้ในโปรแกรมอื่นที่รองรับไฟล์ vCard ได้ หากคุณเปิดไฟล์ VCF ใด ๆ ใน Microsoft Outlook จะมีลักษณะเช่นภาพหน้าจอด้านล่าง.

โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งออกรายชื่อจาก Outlook PST ไปเป็นรูปแบบ vCard (VCF):

ใช้ PersonalStorage.from_file เพื่อเปิดไฟล์ PST.
เข้าถึงโฟลเดอร์ Contacts โดยใช้ get_sub_folder.
วนลูปผ่านรายชื่อ:
- ใช้ get_contents() เพื่อรับข้อมูลข้อความทั้งหมดในโฟลเดอร์.
- วนผ่าน message_info_collection ด้วยลูป.
ดึงข้อมูลแต่ละรายชื่อโดยใช้ pst.extract_message(message_info) และเก็บเป็นรายการข้อความ MAPI.
พิมพ์ชื่อและ entry ID ของทุกรายชื่อ.
บันทึกรายชื่อเป็นไฟล์ VCF โดยใช้ contact.save.

from aspose.email.storage.pst import PersonalStorage
from aspose.email.mapi import ContactSaveFormat

# Load the Outlook PST file
pst = PersonalStorage.from_file("my.pst")

# Get the Contacts folder
folder_info = pst.root_folder.get_sub_folder("Contacts")

# Loop through all the contacts in this folder
message_info_collection = folder_info.get_contents()
for message_info in message_info_collection:
    # Get the contact information
    contact = pst.extract_message(message_info).to_mapi_message_item()

    # Display some contents on screen
    print("Name: " + contact.name_info.display_name + " - " + message_info.entry_id_string)

    # Save to disk in vCard VCF format
    contact.save("D:\\" + contact.name_info.display_name + ".vcf", ContactSaveFormat.V_CARD)

การจัดการรายการจัดส่ง Outlook ในไฟล์ PST

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

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

ตัวอย่างโค้ดด้านล่างสาธิตวิธีสร้างไฟล์ PST และเพิ่มรายการจัดส่ง รวมถึงการสร้างและเพิ่มรายชื่อเข้าไปในรายการจัดส่งภายในไฟล์ PST.

กำหนดรายละเอียดรายชื่อ - ตั้งค่า displayName และอีเมลสำหรับแต่ละรายชื่อ.
สร้างไฟล์ PST ใหม่โดยใช้ PersonalStorage.create() ด้วยรูปแบบ UNICODE.
สร้างโฟลเดอร์ Contacts โดยใช้ create_predefined_folder().
สร้างอินสแตนซ์ MapiContact อ็อบเจ็กต์ที่มีชื่อแสดงและอีเมล, จากนั้นเพิ่มรายชื่อลงในโฟลเดอร์โดยใช้ add_mapi_message_item().
สร้างสมาชิกของรายการจัดส่งโดยการสร้างอินสแตนซ์ของ MapiDistributionListMember สำหรับแต่ละรายชื่อและตั้งค่า entry_id ด้วยการถอดรหัส base64.
เพิ่มสมาชิกเข้าไปใน MapiDistributionListMemberCollection.
สร้างรายการจัดส่งโดยการสร้างอินสแตนซ์ของ MapiDistributionList, ตั้งค่าร่างและหัวเรื่อง.
ใช้ add_mapi_message_item() เพื่อเพิ่มรายการจัดส่งลงในโฟลเดอร์รายชื่อ

displayName1 = "Sebastian Wright"
email1 = "SebastianWright@dayrep.com"

displayName2 = "Wichert Kroos"
email2 = "WichertKroos@teleworm.us"

personalStorage = PersonalStorage.create(dataDir + "CreateDistributionListInPST_out.pst", FileFormatVersion.UNICODE)

contactFolder = personalStorage.create_predefined_folder("Contacts", StandardIpmFolder.CONTACTS)

   # Create contacts
   strEntryId1 = contactFolder.add_mapi_message_item(MapiContact(displayName1, email1))
   strEntryId2 = contactFolder.add_mapi_message_item( MapiContact(displayName2, email2))

   member1 = MapiDistributionListMember(displayName1, email1)
   member1.entry_id_type = MapiDistributionListEntryIdType.CONTACT
   member1.entry_id = base64.b64decode( bytes(strEntryId1, "utf-8") )

   member2 = MapiDistributionListMember(displayName2, email2)
   member2.entry_id_type = MapiDistributionListEntryIdType.CONTACT
   member2.entry_id = base64.b64decode( bytes(strEntryId1, "utf-8") )

   members = MapiDistributionListMemberCollection()
   members.append(member1)
   members.append(member2)

   distribution_list = MapiDistributionList("Contact list", members)
   distribution_list.body = "Distribution List Body"
   distribution_list.subject = "Sample Distribution List using Aspose.Email"     
                    
   # Add distribution list to PST 
   contactFolder.add_mapi_message_item(distribution_list);

อ่านรายการแจกจ่ายจากไฟล์ PST

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

from aspose.email.mapi import MapiMessage

# Load the MAPI message from file
message = MapiMessage.load("dl.msg")

# Convert the message to MAPI distribution list
dlist = message.to_mapi_message_item()

อัปเดตรายการจัดส่งในไฟล์ Outlook PST

เพื่ออัปเดตรายการแจกจ่ายในไฟล์ PST เช่น การเพิ่มสมาชิกใหม่ ให้ใช้โค้ดตัวอย่างต่อนี้:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

folder = pst.get_predefined_folder(ae.storage.pst.StandardIpmFolder.CONTACTS)

# Add a new member to each distribution list in pst
for msg in folder.enumerate_messages():
    # Check if the message has the "IPM.DistList" message class
    if msg.message_class == "IPM.DistList":
        dist_list = pst.extract_message(msg).to_mapi_message_item()
        # Create a new member to add
        member = ae.mapi.MapiDistributionListMember("Edward R. Manuel", "EdwardRManuel@example.com")
        dist_list.members.append(member)
        # Update DL in PST
        folder.update_message(msg.entry_id_string, dist_list)

Python-Net: ทำงานกับผู้ติดต่อในไฟล์ PST

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

เพิ่มผู้ติดต่อไปยัง PST

สร้างไฟล์ PST ใหม่และเพิ่มโฟลเดอร์ย่อย แสดงวิธีสร้างไฟล์ PST และเพิ่มโฟลเดอร์ย่อยลงในนั้น ด้วย Aspose.Email คุณสามารถเพิ่ม MapiContact ไปยังโฟลเดอร์ย่อย Contacts ของไฟล์ PST ที่คุณสร้างหรือโหลดได้ ด้านล่างเป็นขั้นตอนการเพิ่ม MapiContact ไปยัง PST:

สร้างออบเจ็กต์ MapiContact.
ตั้งค่าพรอพเพอร์ตี้ของ MapiContact ด้วยคอนสตรัคเตอร์และเมธอดต่างๆ.
สร้าง PST โดยใช้เมธอด PersonalStorage.create().
สร้างโฟลเดอร์ที่กำหนดไว้ล่วงหน้า (Contacts) ที่รากของไฟล์ PST โดยเข้าถึงโฟลเดอร์รากแล้วเรียกเมธอด add_mapi_message_item().

ส่วนโค้ดต่อไปนี้แสดงวิธีสร้าง MapiContact แล้วเพิ่มเข้าไปในโฟลเดอร์ผู้ติดต่อของไฟล์ PST ที่สร้างใหม่.

บันทึกข้อมูลผู้ติดต่อจากไฟล์ PST ในรูปแบบ MSG

บทความนี้อธิบายวิธีเข้าถึงข้อมูลผู้ติดต่อจากไฟล์ Outlook PST และบันทึกผู้ติดต่อลงดิสก์ในรูปแบบ MSG. ใช้คลาส PersonalStorage และ MapiContact เพื่อดึงและแสดงข้อมูลผู้ติดต่อ. ขั้นตอนในการดึงข้อมูลผู้ติดต่อคือ:

โหลดไฟล์ PST ในคลาส PersonalStorage.
เรียกดูโฟลเดอร์ Contacts.
รับเนื้อหาของโฟลเดอร์ Contacts เพื่อรับชุดข้อความ.
วนลูปผ่านชุดข้อความ.
เรียกเมธอด PersonalStorage.extract_message() เพื่อรับข้อมูลผู้ติดต่อในคลาส MapiMessage.
เรียกเมธอด MapiMessage.save() เพื่อบันทึกผู้ติดต่อลงดิสก์ในรูปแบบ MSG.

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

บันทึกข้อมูลผู้ติดต่อจากไฟล์ PST ในรูปแบบ VCF

บทความนี้แสดงวิธีเข้าถึงข้อมูลผู้ติดต่อจากไฟล์ Microsoft Outlook PST และบันทึกผู้ติดต่อลงดิสก์ในรูปแบบ vCard (VCF). ใช้คลาส PersonalStorage และ MapiContact เพื่อดึงข้อมูลผู้ติดต่อจากไฟล์ PST. วิธีดึงข้อมูลผู้ติดต่อ:

โหลดไฟล์ PST ในคลาส PersonalStorage.
เรียกดูโฟลเดอร์ Contacts.
รับเนื้อหาของโฟลเดอร์ Contacts เพื่อรับชุดข้อความ.
วนลูปผ่านชุดข้อความ.
เรียกเมธอด PersonalStorage.extract_message() เพื่อรับข้อมูลผู้ติดต่อในคลาส MapiContact.
ใช้คุณสมบัติต่างๆ ของคลาส MapiContact เพื่อเข้าถึงข้อมูลผู้ติดต่อ.

โปรแกรมข้างล่างโหลดไฟล์ PST จากดิสก์และบันทึกผู้ติดต่อทั้งหมดเป็นรูปแบบ vCard (VCF). ไฟล์ VCF นี้สามารถใช้ในโปรแกรมอื่นใดที่สามารถเปิดไฟล์ vCard มาตรฐานได้. หากคุณเปิดไฟล์ VCF ใดๆ ใน Microsoft Outlook, มันจะมีลักษณะเช่นภาพหน้าจอด้านล่าง.

|| | :- | โค้ดตัวอย่างต่อไปนี้จะแสดงวิธีส่งออกผู้ติดต่อจาก Outlook PST ไปยังรูปแบบ vCard (VCF).

from aspose.email.storage.pst import PersonalStorage
from aspose.email.mapi import ContactSaveFormat

# Load the Outlook PST file
pst = PersonalStorage.from_file("my.pst")

# Get the Contacts folder
folder_info = pst.root_folder.get_sub_folder("Contacts")

# Loop through all the contacts in this folder
message_info_collection = folder_info.get_contents()
for message_info in message_info_collection:
    # Get the contact information
    contact = pst.extract_message(message_info).to_mapi_message_item()

    # Display some contents on screen
    print("Name: " + contact.name_info.display_name + " - " + message_info.entry_id_string)

    # Save to disk in vCard VCF format
    contact.save("D:\\" + contact.name_info.display_name + ".vcf", ContactSaveFormat.V_CARD)

การทำงานกับรายการกระจาย

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

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

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

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

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

from aspose.email.mapi import MapiMessage

# Load the MAPI message from file
message = MapiMessage.load("dl.msg")

# Convert the message to MAPI distribution list
dlist = message.to_mapi_message_item()

Python-Net: การจัดการรายการบันทึกประจำวัน MAPI ของ Outlook ในไฟล์ PST

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

เพิ่มรายการ Journal ของ MAPI ไปยังไฟล์ PST

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

สร้างรายการ Journal ของ MAPI: สร้างอินสแตนซ์ของ MapiJournal อ็อบเจ็กต์ที่มีหัวเรื่อง, เนื้อหา และประเภท
กำหนดเวลา Journal: กำหนดเวลาเริ่มต้นของรายการบันทึกเป็นวันและเวลาปัจจุบันโดยใช้ dt.datetime.now() และตั้งเวลาสิ้นสุดให้ช้ากว่าอีกหนึ่งชั่วโมงโดยใช้ dt.datetime.today() + timedelta(hours=1).
สร้างไฟล์ PST: ใช้ PersonalStorage.create เพื่อสร้างไฟล์ PST ใหม่ด้วยรูปแบบ UNICODE.
สร้างโฟลเดอร์ Journal: ภายในไฟล์ PST ใหม่, สร้างโฟลเดอร์ที่กำหนดไว้ล่วงหน้าชื่อ "Journal" โดยใช้ create_predefined_folder ด้วย StandardIpmFolder.JOURNAL พารามิเตอร์
Add Journal Entry to Folder: เพิ่มรายการบันทึกประจำวัน MAPI ที่สร้างไว้ก่อนหน้านี้ไปยังโฟลเดอร์ "Journal" โดยใช้ add_mapi_message_item.

เพิ่มไฟล์แนบไปยังรายการ Journal ของ MAPI ในไฟล์ PST

ตัวอย่างโค้ดด้านล่างสาธิตวิธีสร้างและบันทึกรายการบันทึก MAPI โดยใช้ไลบรารี Aspose.Email รายการบันทึกนี้เกี่ยวข้องกับการโทรศัพท์และมีไฟล์แนบ

กำหนดไดเรกทอรีและไฟล์แนบ:
- data_dir: ตัวแปรที่เก็บพาธไปยังไดเรกทอรีข้อมูลที่ไฟล์และผลลัพธ์จะถูกจัดเก็บ
- attach_file_names: รายการที่ประกอบด้วยชื่อไฟล์พาธเต็มของไฟล์แนบที่จะเพิ่มเข้าไปใน journal.
สร้างอ็อบเจ็กต์ MapiJournal:
- A MapiJournal อ็อบเจ็กต์ถูกสร้างด้วยหัวเรื่อง "testJournal". รายการบันทึกนี้ถูกระบุเป็น "การโทรศัพท์" ทั้งในฟิลด์หัวเรื่องและประเภท
- journal.start_time ตั้งค่าเป็นเวลาเท่าเดี๋ยวนี้โดยใช้ datetime.now().
- journal.end_time คำนวณโดยเพิ่มหนึ่งชั่วโมงไปยังเวลาเริ่มต้นโดยใช้ timedelta(hours=1).
ตั้งค่าบริษัทที่เกี่ยวข้อง:
- นี้ journal.companies แอตทริบิวต์จะถูกอัปเดตด้วยรายการบริษัทที่เกี่ยวข้องในรายการบันทึกนี้
แนบไฟล์ไปยัง Journal:
- ลูปทำซ้ำสำหรับแต่ละไฟล์ใน attach_file_names. สำหรับแต่ละไฟล์, มันเพิ่มไฟล์ลงใน journal.attachments โดยอ่านเนื้อหาไฟล์ในโหมดไบนารี
บันทึก MapiJournal:
- สุดท้าย, รายการบันทึกถูกบันทึกเป็นไฟล์ ".msg" ในไดเรกทอรีข้อมูลที่ระบุ

import os
from datetime import datetime, timedelta
from aspose.email.mapi import MapiJournal

data_dir = "path_to_data_directory"
attach_file_names = [os.path.join(data_dir, "Desert.jpg"), os.path.join(data_dir, "download.png")]

journal = MapiJournal("testJournal", "This is a test journal", "Phone call", "Phone call")
journal.start_time = datetime.now()
journal.end_time = journal.start_time + timedelta(hours=1)
journal.companies = ["company 1", "company 2", "company 3"]

for attach in attach_file_names:
    journal.attachments.append(attach, open(attach, 'rb').read())

journal.save(os.path.join(data_dir, "AddAttachmentsToMapiJournal_out.msg"))

Python-Net: ทำงานกับ MapiJournal ใน PST

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

เพิ่ม MapiJournal ไปยัง PST

สร้างไฟล์ PST ใหม่และเพิ่มโฟลเดอร์ย่อยแสดงวิธีสร้างไฟล์ PST และเพิ่มโฟลเดอร์ย่อยลงในนั้น. ด้วย Aspose.Email คุณสามารถเพิ่ม MapiJournal ลงในโฟลเดอร์ย่อย Journal ของไฟล์ PST ที่คุณสร้างหรือโหลดได้. ด้านล่างเป็นขั้นตอนการเพิ่ม MapiJournal ไปยัง PST:

สร้างอ็อบเจ็กต์ MapiJournal
ตั้งค่าคุณสมบัติของ MapiJournal โดยใช้คอนสตรัคเตอร์และเมธอดต่างๆ.
สร้าง PST โดยใช้เมธอด PersonalStorage.create().
สร้างโฟลเดอร์ที่กำหนดล่วงหน้า (Journals) ที่รากของไฟล์ PST โดยเข้าถึงโฟลเดอร์รากและเรียกเมธอด add_mapi_message_item().

โค้ดตัวอย่างต่อไปนี้จะแสดงวิธีสร้าง MapiJournal และเพิ่มลงในโฟลเดอร์ journal ของไฟล์ PST ใหม่ที่สร้างขึ้น.

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

โค้ดตัวอย่างต่อไปนี้จะแสดงวิธีเพิ่มไฟล์แนบลงใน MapiJournal.

import os
from datetime import datetime, timedelta
from aspose.email.mapi import MapiJournal

data_dir = "path_to_data_directory"
attach_file_names = [os.path.join(data_dir, "Desert.jpg"), os.path.join(data_dir, "download.png")]

journal = MapiJournal("testJournal", "This is a test journal", "Phone call", "Phone call")
journal.start_time = datetime.now()
journal.end_time = journal.start_time + timedelta(hours=1)
journal.companies = ["company 1", "company 2", "company 3"]

for attach in attach_file_names:
    journal.attachments.append(attach, open(attach, 'rb').read())

journal.save(os.path.join(data_dir, "AddAttachmentsToMapiJournal_out.msg"))

Python-Net: การจัดการบันทึก MAPI ของ Outlook ในไฟล์ PST

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

เพิ่มบันทึก MAPI ของ Outlook ไปยังไฟล์ PST

สร้างไฟล์ PST ใหม่และเพิ่มโฟลเดอร์ย่อย แสดงวิธีสร้างไฟล์ PST ใหม่และเพิ่มโฟลเดอร์ย่อยลงไป ด้วย Aspose.Email คุณยังสามารถสร้างบันทึก MAPI และเก็บไว้ในไฟล์ PST ตัวอย่างโค้ดด้านล่างสร้างบันทึก MAPI สามรายการที่มีลักษณะต่างกัน, เพิ่มเข้าในไฟล์ PST ภายในโฟลเดอร์ที่กำหนด, และปิดไฟล์อย่างปลอดภัย

MapiNote อ็อบเจ็กต์ถูกสร้างโดยตั้งค่าหัวเรื่อง, เนื้อหา, สี, ความสูงและความกว้าง หากจำเป็น
ไฟล์ PST ใหม่ถูกสร้างโดยใช้ PersonalStorage.create ระบุรูปแบบ UNICODE.
ภายในไฟล์ PST, มีการสร้างโฟลเดอร์ที่กำหนดไว้ล่วงหน้าชื่อ "Tasks" เพื่อจัดเก็บบันทึก
แต่ละบันทึก MAPI (note1, note2, และ note3) ถูกเพิ่มลงใน notesFolder โดยใช้ add_mapi_message_item เมธอด กระบวนการนี้รวมบันทึกเข้าไปในโครงสร้าง PST เพื่อจัดเก็บ

Python-Net: การทำงานกับ MapiNote ใน PST

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

การเพิ่ม MapiNote ไปยัง PST

สร้างไฟล์ PST ใหม่และเพิ่มโฟลเดอร์ย่อยแสดงวิธีสร้างไฟล์ PST และเพิ่มโฟลเดอร์ย่อยลงในนั้น. ด้วย Aspose.Email คุณสามารถเพิ่ม MapiNote ไปยังโฟลเดอร์ย่อย Notes ของไฟล์ PST ที่คุณสร้างหรือโหลดได้. วิธีเพิ่ม MapiNote ไปยัง PST:

สร้างเทมเพลต MapiNote ด้วย Microsoft Outlook แล้วบันทึกเป็นไฟล์ MSG.
โหลดโน้ต MSG ที่บันทึกไว้เข้าไปในอ็อบเจ็กต์ MapiMessage.
สร้างอ็อบเจ็กต์ MapiNote และโหลดเทมเพลตโน้ต MSG.
ตั้งค่าคุณสมบัติของ MapiNote.
สร้าง PST โดยใช้เมธอด PersonalStorage.Create().
สร้างโฟลเดอร์ที่กำหนดล่วงหน้า (Notes) ที่รากของไฟล์ PST โดยเข้าถึงโฟลเดอร์รากและเรียกเมธอด AddMapiMessageItem().

โค้ดตัวอย่างต่อไปนี้จะแสดงวิธีสร้าง MapiNote แล้วเพิ่มลงในโฟลเดอร์ notes ของไฟล์ PST ที่สร้างใหม่.

Python-Net: การจัดการงาน Outlook MAPI ในไฟล์ PST

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

เพิ่มงาน Outlook MAPI ไปยังไฟล์ PST

สร้างไฟล์ PST ใหม่และเพิ่มโฟลเดอร์ย่อย แสดงวิธีสร้างไฟล์ PST และรวมโฟลเดอร์ย่อยภายใน ด้วย Aspose.Email คุณสามารถเพิ่มงาน MAPI ไปยังโฟลเดอร์ย่อย Tasks ของไฟล์ PST ที่คุณสร้างหรือโหลด ตัวอย่างโค้ดด้านล่างแสดงวิธีสร้างและจัดการงานโดยใช้ MapiTask คลาสในสภาพแวดล้อมที่รองรับการจัดการไฟล์ตารางเก็บข้อมูลส่วนบุคคล (PST) โดยกำหนดงานพร้อมพารามิเตอร์เฉพาะและบันทึกงานนี้ลงในไฟล์ PST ใต้โฟลเดอร์ "Tasks" ที่กำหนดล่วงหน้า.

สร้าง MapiTask อ็อบเจกต์ที่กำหนดวันที่เริ่มเป็นวันที่ปัจจุบันและวันครบกำหนดเป็นสามวันจากขณะนี้.
ตั้งค่าคุณสมบัติงาน.
สร้าง PST ด้วย PersonalStorage.Create() เมธอด.
สร้างโฟลเดอร์ที่กำหนดล่วงหน้า (Tasks) ที่รากของไฟล์ PST โดยเข้าถึงโฟลเดอร์ Root แล้วเรียก add_mapi_message_item() เมธอด.

Python-Net: การจัดการรายการจ่ายอีเมล Outlook ในไฟล์ PST

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

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

Aspose.Email for Python API อนุญาตให้ผู้ใช้สร้าง, จัดการ และทำงานกับรายการจ่ายอีเมล ซึ่งรวมถึงการสร้างและบันทึกสมาชิกจากรายการ, อ่านรายการจ่ายอีเมล, ปรับปรุงคุณสมบัติของรายการ, และการดำเนินการอื่น ๆ ที่เกี่ยวข้อง.

สร้างและบันทึกรายการจ่ายอีเมลในไฟล์ PST

เพิ่มรายการจ่ายอีเมลที่มีผู้ติดต่อใน PST ที่มีอยู่

โค้ดสแนปด้านล่างแสดงวิธีสร้างรายการจ่ายอีเมลที่ประกอบด้วยผู้ติดต่อที่已จัดเก็บในไฟล์ PST แล้ว.

สร้างไฟล์ PST ใหม่โดยใช้ PersonalStorage.create() ด้วยรูปแบบ UNICODE.
สร้างโฟลเดอร์ "Contacts" ที่กำหนดล่วงหน้า และเพิ่มรายการผู้ติดต่อสองรายการ (Sebastian Wright และ Wichert Kroos) ลงในโฟลเดอร์นี้.
เพิ่มผู้ติดต่อลงในรายการจ่ายอีเมล:
- แต่ละผู้ติดต่อจะถูกเพิ่มลงในรายการจ่ายอีเมลเป็น MapiDistributionListMember.
- entry_id ของแต่ละสมาชิกจะเชื่อมโยงกับผู้ติดต่อใน PST ที่สอดคล้องโดยใช้ strEntryId ที่เข้ารหัส.
สร้างรายการจ่ายอีเมลชื่อ "Contact list" ซึ่งรวมผู้ติดต่อที่เพิ่มเป็นสมาชิก และเพิ่มลงในไฟล์ PST.

import aspose.email as ae

displayName1 = "Sebastian Wright"
email1 = "SebastianWright@dayrep.com"

displayName2 = "Wichert Kroos"
email2 = "WichertKroos@teleworm.us"

pst = ae.storage.pst.PersonalStorage.create("target.pst", ae.storage.pst.FileFormatVersion.UNICODE)

contactFolder = pst.create_predefined_folder("Contacts", ae.storage.pst.StandardIpmFolder.CONTACTS)

strEntryId1 = contactFolder.add_mapi_message_item(ae.mapi.MapiContact(displayName1, email1))
strEntryId2 = contactFolder.add_mapi_message_item(ae.mapi.MapiContact(displayName2, email2))

member1 = ae.mapi.MapiDistributionListMember(displayName1, email1)
member1.entry_id_type = ae.mapi.MapiDistributionListEntryIdType.CONTACT
member1.entry_id = strEntryId1.encode()

member2 = ae.mapi.MapiDistributionListMember(displayName2, email2)
member2.entry_id_type = ae.mapi.MapiDistributionListEntryIdType.CONTACT
member2.entry_id = strEntryId2.encode()

members = ae.mapi.MapiDistributionListMemberCollection()
members.append(member1)
members.append(member2)

distributionList = ae.mapi.MapiDistributionList("Contact list", members)
distributionList.body = "Distribution List Body"
distributionList.subject = "Sample Distribution List using Aspose.Email"
# Add distribution list to PST
contactFolder.add_mapi_message_item(distributionList)

เพิ่มรายการจ่ายอีเมลที่มีสมาชิกแบบหนึ่งครั้ง

สมาชิกแบบหนึ่งครั้งเหมาะสมเมื่อผู้ติดต่อไม่อยู่ในสมุดที่อยู่ของ Outlook แต่ยังต้องการรวมไว้ในรายการจ่ายอีเมล ตัวอย่างโค้ดต่อไปนี้แสดงวิธีสร้างรายการจ่ายอีเมลที่มีสมาชิกแบบหนึ่งครั้ง — ผู้ติดต่อที่ไม่ได้จัดเก็บในไฟล์ PST.

สร้างไฟล์ PST ใหม่โดยใช้ PersonalStorage.create() ด้วยรูปแบบ UNICODE.
แทนที่จะเชื่อมต่อรายชื่อจาก PST ให้กำหนดรายการผู้ติดต่อใหม่ (John R. Patrick และ Tilly Bates) โดยตรงเป็นสมาชิกแบบหนึ่งครั้ง.
เพิ่มสมาชิกแบบหนึ่งครั้ง (one‑off) ไปยังรายการจ่ายอีเมล.
สร้างรายการจ่ายอีเมลชื่อ "Simple list" และเพิ่มลงในโฟลเดอร์ "Contacts" ในไฟล์ PST.

import aspose.email as ae

displayName1 = "Sebastian Wright"
email1 = "SebastianWright@dayrep.com"

displayName2 = "Wichert Kroos"
email2 = "WichertKroos@teleworm.us"

pst = ae.storage.pst.PersonalStorage.create("target.pst", ae.storage.pst.FileFormatVersion.UNICODE)

contact_folder = pst.create_predefined_folder("Contacts", ae.storage.pst.StandardIpmFolder.CONTACTS)

one_off_members = ae.mapi.MapiDistributionListMemberCollection()
one_off_members.append(ae.mapi.MapiDistributionListMember("John R. Patrick", "JohnRPatrick@armyspy.com"))
one_off_members.append(ae.mapi.MapiDistributionListMember("Tilly Bates", "TillyBates@armyspy.com"))

one_off_members_list = ae.mapi.MapiDistributionList("Simple list", one_off_members)
contact_folder.add_mapi_message_item(one_off_members_list)

อ่านรายการแจกจ่ายจากไฟล์ PST

เพื่ออ่านรายการจัดส่งจาก PST ให้ใช้ตัวอย่างโค้ดต่อไปนี้:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

folder = pst.get_predefined_folder(ae.storage.pst.StandardIpmFolder.CONTACTS)

for msg in folder.enumerate_messages():
    # Check if the message has the "IPM.DistList" message class
    if msg.message_class == "IPM.DistList":
        dist_list = pst.extract_message(msg).to_mapi_message_item()
        # Now, you can work with the distribution list
        # (e.g., access its members, display its properties, or make modifications)
        for member in dist_list.members:
            print(f"{member.display_name}")

อัปเดตรายการจัดส่งในไฟล์ Outlook PST

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

folder = pst.get_predefined_folder(ae.storage.pst.StandardIpmFolder.CONTACTS)

# add a new member to each distribution list in pst
for msg in folder.enumerate_messages():
    # Check if the message has the "IPM.DistList" message class
    if msg.message_class == "IPM.DistList":
        dist_list = pst.extract_message(msg).to_mapi_message_item()
        # Create new member to add
        member = ae.mapi.MapiDistributionListMember("Edward R. Manuel", "EdwardRManuel@example.com")
        dist_list.members.append(member)
        # update DL in PST
        folder.update_message(msg.entry_id_string, dist_list)

Python-Net: การทำงานกับ MapiTask ใน PST

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

การเพิ่ม MapiTask ไปยัง PST

สร้างไฟล์ PST ใหม่และเพิ่มโฟลเดอร์ย่อย แสดงวิธีสร้างไฟล์ PST และเพิ่มโฟลเดอร์ย่อยลงในนั้น ด้วย Aspose.Email คุณสามารถเพิ่ม MapiTask ไปยังโฟลเดอร์ Tasks ของไฟล์ PST ที่คุณสร้างหรือโหลด ด้านล่างเป็นขั้นตอนการเพิ่ม MapiTask ไปยัง PST:

สร้างอ็อบเจ็กต์ MapiTask.
ตั้งค่าคุณสมบัติของ MapiTask ด้วยคอนสตรักเตอร์และเมธอดต่าง ๆ.
สร้าง PST โดยใช้เมธอด PersonalStorage.Create().
สร้างโฟลเดอร์กำหนดล่วงหน้า (Tasks) ที่รากของไฟล์ PST โดยเข้าถึงโฟลเดอร์ Root แล้วเรียกเมธอด AddMapiMessageItem().

โค้ดตัวอย่างต่อไปนี้แสดงวิธีสร้าง MapiTask แล้วเพิ่มเข้าไปในโฟลเดอร์งานของไฟล์ PST ที่สร้างใหม่.

Python-Net: การอ่านไฟล์ PST/OST ที่เสียหาย

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

การอ่านไฟล์ PST/OST ที่เสียหาย

ในบางกรณีไฟล์ PST หรือ OST อาจไม่สามารถเข้าถึงได้เนื่องจากความเสียหายหรือบิดเบือน. เมื่อเกิดเช่นนั้น Outlook อาจไม่สามารถเปิดไฟล์ได้ ทำให้ยากต่อการดึงอีเมลสำคัญและข้อมูลอื่นๆ ของกล่องจดหมาย.

Aspose.Email มี API ที่ให้คุณสแกนและดึงข้อความที่ไม่มีความเสียหายจากไฟล์ PST ที่เสียหายโดยใช้ ID ของข้อความและโฟลเดอร์.

เมธอดต่อไปนี้ของ PersonalStorage คลาสมีความสำคัญต่อการกู้คืนข้อมูลจากไฟล์ PST ที่เสียหาย:

ดึง ID ของข้อความและโฟลเดอร์:

find_messages(parent_entry_id) - ดึงรายการ ID ของข้อความภายในโฟลเดอร์ที่ระบุ.

find_subfolders(parent_entry_id) - ได้รายการ ID ของโฟลเดอร์ย่อยภายในโฟลเดอร์ที่กำหนด.
เข้าถึงข้อความและโฟลเดอร์โดยใช้ ID ของพวกเขา:

extract_message(entry_id) - ดึงข้อความจากไฟล์ PST โดยใช้ entry ID.

get_folder_by_id(entry_id) - ดึงโฟลเดอร์จากไฟล์ PST โดยใช้ entry ID.

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีนำทางผ่านไฟล์ PST ที่อาจเสียหาย, ดึงข้อความที่ไม่ได้รับความเสียหาย, และสำรวจโฟลเดอร์ย่อย:

import aspose.email as ae

def explore_corrupted_pst(pst, root_folder_id):
    message_id_list = pst.find_messages(root_folder_id)

    for message_id in message_id_list:
        try:
            msg = pst.extract_message(message_id)
            print("- " + msg.subject)
        except Exception as e:
            print("Message reading error. Entry id: " + message_id)

    folder_id_list = pst.find_subfolders(root_folder_id)

    for sub_folder_id in folder_id_list:
        if sub_folder_id != root_folder_id:
            try:
                subfolder = pst.get_folder_by_id(sub_folder_id)
                print(subfolder.display_name)
            except Exception as e:
                print("Message reading error. Entry id: " + sub_folder_id)

            explore_corrupted_pst(pst, sub_folder_id)


pst = ae.storage.pst.PersonalStorage.from_file("target.pst")

explore_corrupted_pst(pst, pst.root_folder.entry_id_string)

Python-Net: ทำงานกับรายการจัดส่งในไฟล์ PST

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

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

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

สร้างและบันทึกรายการจัดส่งตามที่แสดงในตัวอย่างโค้ดด้านล่าง:

import aspose.email as ae

displayName1 = "Sebastian Wright"
email1 = "SebastianWright@dayrep.com"

displayName2 = "Wichert Kroos"
email2 = "WichertKroos@teleworm.us"

pst = ae.storage.pst.PersonalStorage.create("target.pst", ae.storage.pst.FileFormatVersion.UNICODE)

contactFolder = pst.create_predefined_folder("Contacts", ae.storage.pst.StandardIpmFolder.CONTACTS)

strEntryId1 = contactFolder.add_mapi_message_item(ae.mapi.MapiContact(displayName1, email1))
strEntryId2 = contactFolder.add_mapi_message_item(ae.mapi.MapiContact(displayName2, email2))

member1 = ae.mapi.MapiDistributionListMember(displayName1, email1)
member1.entry_id_type = ae.mapi.MapiDistributionListEntryIdType.CONTACT
member1.entry_id = strEntryId1.encode()

member2 = ae.mapi.MapiDistributionListMember(displayName2, email2)
member2.entry_id_type = ae.mapi.MapiDistributionListEntryIdType.CONTACT
member2.entry_id = strEntryId2.encode()

members = ae.mapi.MapiDistributionListMemberCollection()
members.append(member1)
members.append(member2)

distributionList = ae.mapi.MapiDistributionList("Contact list", members)
distributionList.body = "Distribution List Body"
distributionList.subject = "Sample Distribution List using Aspose.Email"
# Add distribution list to PST
contactFolder.add_mapi_message_item(distributionList)

import aspose.email as ae

displayName1 = "Sebastian Wright"
email1 = "SebastianWright@dayrep.com"

displayName2 = "Wichert Kroos"
email2 = "WichertKroos@teleworm.us"

pst = ae.storage.pst.PersonalStorage.create("target.pst", ae.storage.pst.FileFormatVersion.UNICODE)

contact_folder = pst.create_predefined_folder("Contacts", ae.storage.pst.StandardIpmFolder.CONTACTS)

one_off_members = ae.mapi.MapiDistributionListMemberCollection()
one_off_members.append(ae.mapi.MapiDistributionListMember("John R. Patrick", "JohnRPatrick@armyspy.com"))
one_off_members.append(ae.mapi.MapiDistributionListMember("Tilly Bates", "TillyBates@armyspy.com"))

one_off_members_list = ae.mapi.MapiDistributionList("Simple list", one_off_members)
contact_folder.add_mapi_message_item(one_off_members_list)

อ่านรายการจัดส่งจาก PST

เพื่ออ่านรายการจัดส่งจาก PST ให้ใช้ตัวอย่างโค้ดต่อไปนี้:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

folder = pst.get_predefined_folder(ae.storage.pst.StandardIpmFolder.CONTACTS)

for msg in folder.enumerate_messages():
    # Check if the message has the "IPM.DistList" message class
    if msg.message_class == "IPM.DistList":
        dist_list = pst.extract_message(msg).to_mapi_message_item()
        # Now, you can work with the distribution list
        # (e.g., access its members, display its properties, or make modifications)
        for member in dist_list.members:
            print(f"{member.display_name}")

อัปเดตรายการจัดส่งใน PST

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

folder = pst.get_predefined_folder(ae.storage.pst.StandardIpmFolder.CONTACTS)

# add a new member to each distribution list in pst
for msg in folder.enumerate_messages():
    # Check if the message has the "IPM.DistList" message class
    if msg.message_class == "IPM.DistList":
        dist_list = pst.extract_message(msg).to_mapi_message_item()
        # Create new member to add
        member = ae.mapi.MapiDistributionListMember("Edward R. Manuel", "EdwardRManuel@example.com")
        dist_list.members.append(member)
        # update DL in PST
        folder.update_message(msg.entry_id_string, dist_list)

Python-Net: แปลง OLM เป็น PST

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

แปลง OLM เป็น PST

OLM (Outlook for Mac) เป็นรูปแบบไฟล์ที่ Microsoft Outlook for Mac ใช้เพื่อจัดเก็บข้อความอีเมล, ผู้ติดต่อ, ปฏิทิน, งาน และข้อมูลอื่น ๆ มันเป็นรูปแบบไฟล์พื้นฐานของ Outlook for Mac ดังนั้นจึงไม่สามารถเปิดไฟล์ Outlook for Mac (OLM) ใน Outlook for Windows ได้ เพื่อทำงานกับไฟล์ OLM ใน Windows, Aspose Email มีเครื่องมือที่ออกแบบมาโดยเฉพาะสำหรับจัดการไฟล์ OLM วิธีการของมันคือการแปลงไฟล์ OLM เป็นรูปแบบ PST (Outlook Data File) ซึ่งได้รับการสนับสนุนอย่างกว้างขวางในสภาพแวดล้อม Windows เมื่อแปลงเป็นรูปแบบ PST แล้ว คุณสามารถนำเข้าข้อมูลเข้าสู่ Outlook for Windows หรือไคลเอนต์อีเมลที่เข้ากันได้อื่น ๆ.

วิธีการหลัก

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีแปลงไฟล์ OLM ของ Outlook เป็นไฟล์ PST โดยใช้ไลบรารี Aspose.Email โดยอ่านแต่ละโฟลเดอร์และข้อความที่สอดคล้องจากไฟล์ OLM แล้วเพิ่มลงในไฟล์ PST ใหม่ตามลำดับเดียวกัน.

สร้างอินสแตนซ์ของ OlmStorage คลาสสำหรับเปิดไฟล์ OLM แหล่งที่มา.
ใช้ PersonalStorage.create วิธีการสร้างไฟล์ PST ใหม่โดยระบุชื่อไฟล์และเวอร์ชันรูปแบบ.
อ่านแต่ละโฟลเดอร์และข้อความของมันจากไฟล์ OLM อย่างเรียกซ้ำ.
ใช้ฟังก์ชัน add_to_pst เพื่อเพิ่มแต่ละโฟลเดอร์และข้อความของมันลงในไฟล์ PST โดยคงโครงสร้างเดิมไว้.


import aspose.email as ae

olm = ae.storage.olm.OlmStorage("my.olm")

pst = ae.storage.pst.PersonalStorage.create("my.pst", ae.storage.pst.FileFormatVersion.UNICODE)

for folder in olm.folder_hierarchy:
    add_to_pst(pst.root_folder, folder)

โค้ดนี้เป็นสคริปต์หลักสำหรับเริ่มต้นกระบวนการแปลงไฟล์ OLM เป็นไฟล์ PST ด้วยไลบรารี aspose.email แสดงวิธีเปิดไฟล์ OLM, สร้างไฟล์ PST ใหม่, และเรียกฟังก์ชัน add_to_pst เพื่อดำเนินการโอนย้ายข้อมูล สคริปต์นี้ทำหน้าที่เป็นจุดเริ่มต้นของการย้ายข้อมูลโดยใช้ฟังก์ชันอย่างมีประสิทธิภาพเพื่อจัดการการโอนย้ายรายละเอียดของโฟลเดอร์และข้อความ.

การโอนย้ายโฟลเดอร์และข้อความแบบเรียกซ้ำ

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


def add_to_pst(pst_folder, olm_folder):
    pst_sub_folder = pst_folder.get_sub_folder(olm_folder.name)

    for msg in olm_folder.enumerate_mapi_messages():
        if pst_sub_folder is None:
            pst_sub_folder = pst_folder.add_sub_folder(olm_folder.name, get_container_class(msg.message_class))

        pst_sub_folder.add_message(msg)

    if pst_sub_folder is None:
        pst_sub_folder = pst_folder.add_sub_folder(olm_folder.name)

    for olm_sub_folder in olm_folder.sub_folders:
        add_to_pst(pst_sub_folder, olm_sub_folder)

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

เมื่อแปลงไฟล์ OLM เป็น PST เราต้องแน่ใจว่ารูปแบบโฟลเดอร์ถูกคงไว้และว่าแต่ละโฟลเดอร์ในไฟล์ PST มีประเภทที่ถูกต้อง แตกต่างจาก PST โฟลเดอร์ใน OLM ไม่มีประเภทที่กำหนดไว้ล่วงหน้า เพื่อจัดประเภทและโอนย้ายข้อมูลได้อย่างถูกต้อง ให้ทำตามขั้นตอนด้านล่าง:

อ่านข้อความแรกจากโฟลเดอร์ OLM และกำหนดประเภทของมัน.
ใช้ประเภทข้อความนี้เพื่อคำนวณประเภทโฟลเดอร์ที่เหมาะสมใน PST โดยใช้วิธีการจำแนกประเภท.
สร้างโฟลเดอร์ประเภทที่กำหนดไว้ในไฟล์ PST.
เพิ่มข้อความเข้าสู่โฟลเดอร์ PST ที่สร้างใหม่.

สำหรับข้อความที่เหลือในโฟลเดอร์ OLM เราจะถือว่ามันอยู่ในหมวดเดียวกัน เนื่องจากประเภทโฟลเดอร์ได้ถูกกำหนดไว้แล้ว.

ฟังก์ชัน get_container_class ช่วยจัดประเภทรายการ Outlook โดยแมปคลาสข้อความต่าง ๆ ไปยังประเภทโฟลเดอร์ PST ที่ถูกต้อง:

def get_container_class(message_class):
    if message_class.startswith("IPM.Contact") or message_class.startswith("IPM.DistList"):
        return "IPF.Contact"

    if message_class.startswith("IPM.StickyNote"):
        return "IPF.StickyNote"

    if message_class.startswith("IPM.Activity"):
        return "IPF.Journal"

    if message_class.startswith("IPM.Task"):
        return "IPF.Task"

    if message_class.startswith("IPM.Appointment") or message_class.startswith("IPM.Schedule.meeting"):
        return "IPF.Appointment"

    return "IPF.Note"

Python-Net: การทำงานกับข้อความในไฟล์ PST

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

เพิ่มข้อความไปยังไฟล์ PST ของ Outlook

เพิ่มข้อความเดียวลงในไฟล์ PST

สร้างไฟล์ PST ใหม่และเพิ่มโฟลเดอร์ย่อย แสดงวิธีสร้างไฟล์ PST และเพิ่มโฟลเดอร์ย่อยลงในนั้น ด้วย Aspose.Email คุณสามารถเพิ่มข้อความไปยังโฟลเดอร์ย่อยของไฟล์ PST ที่คุณสร้างหรือโหลดได้ ตัวอย่างโค้ดด้านล่างแสดงวิธีสร้างไฟล์ PST ใหม่, เพิ่มโฟลเดอร์ "Inbox", แล้วเพิ่มข้อความไปยังโฟลเดอร์นั้น. ส่วนที่ PersonalStorage และ FolderInfo คลาสที่ใช้ในการทำงานนี้.

ใช้ PersonalStorage.create เมธอดเพื่อเริ่มไฟล์ PST ใหม่โดยระบุเส้นทางไฟล์และเวอร์ชันรูปแบบไฟล์เป็น Unicode.
สร้างโฟลเดอร์ใหม่ชื่อ "Inbox" ในไดเรกทอรีรากของไฟล์ PST.
เพิ่มข้อความไปยังโฟลเดอร์ "Inbox" ที่สร้างใหม่โดยใช้ add_message เมธอด.
โหลดข้อความโดยใช้ MapiMessage.load.

pst = PersonalStorage.create(dataDir + "AddMessagesToPst_out.pst", FileFormatVersion.UNICODE)

# Add new folder "Inbox"
inboxFolder = pst.root_folder.add_sub_folder("Inbox");

# Add message to Inbox Folder
inboxFolder.add_message(MapiMessage.load(dataDir + "MapiMsgWithPoll.msg"))

pst.dispose()

เพิ่มหลายข้อความลงในไฟล์ PST เพื่อประสิทธิภาพที่ดีกว่า

การเพิ่มข้อความแต่ละรายการลงใน PST ทำให้มีการดำเนินการ I/O ไปยังดิสก์มากขึ้นจึงอาจทำให้ประสิทธิภาพช้าลง เพื่อเพิ่มประสิทธิภาพ สามารถเพิ่มข้อความลงใน PST เป็นโหมดกลุ่มและลดการดำเนินการ I/O.

โหลดและเพิ่มข้อความจากดิสก์

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

กำหนดฟังก์ชันโดยการสร้าง add_messages_in_bulk_mode พร้อมพารามิเตอร์สำหรับชื่อไฟล์ PST และโฟลเดอร์ที่มีข้อความ.
เปิดไฟล์ PST ที่ระบุโดยใช้ PersonalStorage.from_file().
เรียกโฟลเดอร์ย่อย "myInbox" จากโฟลเดอร์รากของ PST.
เพิ่มข้อความจากโฟลเดอร์ที่ระบุเป็นกลุ่มโดยใช้ folder.add_messages().
เรียก add_messages_in_bulk_mode() กับไฟล์ PST และชื่อโฟลเดอร์เป็นอาร์กิวเมนต์.

from aspose.email.storage.pst import PersonalStorage, StandardIpmFolder, FileFormatVersion

def add_messages_in_bulk_mode(file_name, msg_folder_name):
    with PersonalStorage.from_file(file_name) as personal_storage:
        folder = personal_storage.root_folder.get_sub_folder("myInbox")
        folder.add_messages(message_collection(msg_folder_name))

# Add multiple messages from the specified folder to the PST file for improved performance
add_messages_in_bulk_mode("file.pst", "folder_with_messages")

ใช้ `MapiMessageEnumerator` สำหรับการดำเนินการแบบกลุ่ม

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

MapiMessageEnumerator สำหรับการอ่านข้อความจากไดเรกทอรี,
และ MapiMessageCollection สำหรับการจัดการพวกมันในกระบวนการทำงานเป็นชุด.

วิธีการนี้อำนวยความสะดวกในการเดินทางและจัดการไฟล์ข้อความ MAPI.

import os
from aspose.email.mapi import MapiMessage

# Define a class to enumerate through MAPI message files in a directory
class MapiMessageEnumerator:
    def __init__(self, path):
        self.files = os.listdir(path)
        self.position = -1

    def __next__(self):
        self.position += 1
        if self.position < len(self.files):
            return MapiMessage.from_file(os.path.join(self.path, self.files[self.position]))
        else:
            raise StopIteration

    def __iter__(self):
        return self

# Define a collection class for managing MAPI messages
class MapiMessageCollection:
    def __init__(self, path):
        self.path = path

    def __iter__(self):
        return MapiMessageEnumerator(self.path)


# Iterate through MAPI messages in a specific directory
msg_folder_name = "\\Files\\msg"

# Initialize a collection with the directory containing message files
message_collection = MapiMessageCollection(msg_folder_name)
for message in message_collection:
    # Process each MAPI message object as needed
    pass

เพิ่มข้อความจาก PST อื่น

เพื่อนำเข้าข้อความจากไฟล์ PST หนึ่งไปยังอีกไฟล์หนึ่ง Aspose.Email มีให้ FolderInfo.enumerate_mapi_messages() เมธอด ตัวอย่างโค้ดต่อไปนี้แสดงวิธีคัดลอกข้อความจากโฟลเดอร์ "Inbox" ในไฟล์ PST หนึ่งไปยังไฟล์ PST อีกไฟล์หนึ่ง:

ดึงข้อความจากไฟล์ PST ของ Outlook

ใน อ่านไฟล์ Outlook PST, ดึงข้อมูลโฟลเดอร์และโฟลเดอร์ย่อย, เราได้อภิปรายเกี่ยวกับการโหลดไฟล์ PST ของ Outlook และเรียกดูโฟลเดอร์ต่าง ๆ เพื่อรับชื่อโฟลเดอร์และจำนวนข้อความในแต่ละโฟลเดอร์ บทความนี้อธิบายวิธีเข้าถึงและสกัดข้อความจากไฟล์ PST ของ Outlook: ดึงรายละเอียดพื้นฐานของข้อความ, นับจำนวนรายการในโฟลเดอร์, และสกัดข้อความจำนวนหนึ่งสำหรับการประมวลผลหรือวิเคราะห์.

ดึงข้อมูลพื้นฐานของข้อความ

ตัวอย่างโค้ดด้านล่างแสดงวิธีสกัดและแสดงข้อมูลสำคัญจากข้อความ MAPI ที่เก็บไว้ในไฟล์ PST โดยใช้ไลบรารี Aspose.Email มันเริ่มต้น PersonalStorage วัตถุจากไฟล์ "Outlook.pst" ดึงเนื้อหาของโฟลเดอร์รากและวนซ้ำผ่านแต่ละข้อความ สคริปต์พิมพ์รายละเอียดเช่น หัวเรื่อง, ข้อมูลผู้ส่ง, ที่อยู่อีเมลผู้รับ, เวลาส่ง, และเนื้อความของข้อความ ให้ภาพรวมที่ครอบคลุมของแต่ละอีเมลในไฟล์ PST ที่ระบุ.

from aspose.email.storage.pst import *
from aspose.email.mapi import MapiMessage

pst = PersonalStorage.from_file("Outlook.pst")

folderInfo = pst.root_folder

messageInfoCollection = folderInfo.get_contents()

for messageInfo in messageInfoCollection:
   mapi = pst.extract_message(messageInfo)

   print("Subject: " + mapi.subject)
   print("Sender name: " + mapi.sender_name)
   print("Sender email address: " + mapi.sender_email_address)
   print("To: ", mapi.display_to)
   print("Cc: ", mapi.display_cc)
   print("Bcc: ", mapi.display_bcc)
   print("Delivery time: ", str(mapi.delivery_time))
   print("Body: " + mapi.body)

การอ่านโฟลเดอร์ซ้อนแบบเรียกซ้ำ

ไฟล์ PST ของ Outlook อาจมีโฟลเดอร์ซ้อนกัน เพื่อดึงข้อมูลข้อความจากโฟลเดอร์เหล่านี้รวมถึงโฟลเดอร์ระดับบน ใช้วิธีการเรียกซ้ำเพื่ออ่านทุกโฟลเดอร์ ตัวอย่างโค้ดต่อไปนี้แสดงวิธีอ่านไฟล์ PST ของ Outlook และแสดงเนื้อหาโฟลเดอร์และข้อความอย่างเรียกซ้ำ:

เรียกคืนจำนวนรายการทั้งหมดในโฟลเดอร์ PST

เพื่อดึงจำนวนรายการทั้งหมด (เช่น อีเมล, นัดหมาย, งาน, ผู้ติดต่อ ฯลฯ) ที่อยู่ในที่เก็บข้อความ ใช้เมธอด get_total_items_count() ของ คลังข้อความ คลาส ให้วิธีที่สะดวกในการรวบรวมข้อมูลขนาดและปริมาณของข้อมูลภายในที่เก็บ ตัวอย่างโค้ดต่อไปนี้แสดงวิธีรับจำนวนรายการทั้งหมดจากไฟล์ PST:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

count = pst.store.get_total_items_count()

สกัดจำนวนข้อความที่ระบุ

เพื่อสกัดจำนวนข้อความที่ระบุจากไฟล์ PST ใช้เมธอด get_contents(start_index, count) ของ FolderInfo คลาส เหมาะกับพารามิเตอร์สองค่า:

start_index - หมายเลขของข้อความเริ่มต้น, ตัวอย่างเช่นข้อความที่ 10;
count - จำนวนข้อความทั้งหมดที่ต้องดึง.

การดึงส่วนย่อยของข้อความที่จำเป็นเท่านั้นในแต่ละครั้งอาจเป็นประโยชน์ในการจัดการข้อมูลอีเมลปริมาณมาก ตัวอย่างโค้ดต่อไปนี้แสดงการใช้งานคุณลักษณะนี้:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

folder = pst.root_folder.get_sub_folder("Inbox")

# Extracts messages starting from 10th index top and extract total 100 messages
messages = folder.get_contents(10, 100)

ทำงานกับไฟล์แนบในไฟล์ PST

สกัดไฟล์แนบโดยไม่ต้องสกัดข้อความทั้งหมด

Aspose.Email สำหรับ Python อนุญาตให้สกัดไฟล์แนบจากข้อความ PST โดยไม่ต้องสกัดข้อความทั้งหมดก่อน ซึ่งสามารถทำได้โดยใช้ extract_attachments เมธอดของ PersonalStorage คลาส ตัวอย่างโค้ดต่อไปนี้แสดงวิธีสกัดไฟล์แนบโดยข้ามไฟล์ .msg:

from aspose.email.storage.pst import PersonalStorage

# Open the PST file 
with PersonalStorage.from_file(data_dir + "my.pst") as personal_storage:
    # Get the "Inbox" subfolder from the root folder in the personal storage
    folder = personal_storage.root_folder.get_sub_folder("Inbox")

    # Iterate over each message entry ID in the Inbox folder
    for message_info in folder.enumerate_messages_entry_id():
        # Extract attachments for the current message
        attachments = personal_storage.extract_attachments(message_info)

        # Check if the message has any attachments
        if attachments.count > 0:
            # Iterate over each attachment in the list
            for attachment in attachments:
                # Ignore attachments that are message files (.msg)
                if attachment.long_file_name and attachment.long_file_name.endswith(".msg"):
                    continue
                # Save the attachment with its original file name
                attachment.save(data_dir + attachment.long_file_name)

เพิ่มไฟล์เป็นไฟล์แนบในข้อความ PST

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

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีเพิ่มเอกสารเข้าไปยังโฟลเดอร์ PST ด้วย Aspose.Email:

from aspose.email.storage.pst import PersonalStorage, FileFormatVersion

# Create a new PST file
personal_storage = PersonalStorage.create(data_dir + "AddFilesToPst_out.pst", FileFormatVersion.UNICODE)

# Add a new folder to store files
folder = personal_storage.root_folder.add_sub_folder("Files")

# Add a file to the PST folder
folder.add_file(data_dir + "FileToBeAddedToPST.txt", "")

ค้นหาและกรองข้อความในไฟล์ PST

ไฟล์ Personal Storage (PST) สามารถบรรจุข้อมูลจำนวนมากและจำเป็นต้องใช้การกรองหลายระดับเพื่อค้นหาข้อมูลที่ตรงกับเกณฑ์ที่กำหนด ด้วย PersonalStorageQueryBuilder คลาส, Aspose.Email ทำให้คุณสามารถค้นหารายการเฉพาะใน PST ตามเกณฑ์การค้นหาที่กำหนดได้ คุณสามารถค้นหาข้อความโดยใช้พารามิเตอร์เช่น ผู้ส่ง, ผู้รับ, หัวเรื่อง, ความสำคัญของข้อความ, การมีไฟล์แนบ, ขนาดข้อความ, และแม้แต่ ID ของข้อความ นอกจากนี้, PersonalStorageQueryBuilder สามารถใช้สำหรับการค้นหาภายในโฟลเดอร์ย่อย ส่วนต่อไปนี้ให้คำแนะนำที่ครอบคลุมเกี่ยวกับการค้นหาไฟล์ PST ของ Outlook.

ค้นหาข้อความและโฟลเดอร์ใน Outlook

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการใช้ PersonalStorageQueryBuilder คลาสสำหรับค้นหาสาระใน PST ตามเกณฑ์การค้นหาต่าง ๆ โดยเฉพาะแสดงการค้นหา PST ตาม:

ความสำคัญของข้อความ.
คลาสของข้อความ.
การมีไฟล์แนบ.
ขนาดของข้อความ.
ข้อความที่ยังไม่ได้อ่าน.
ข้อความที่ยังไม่ได้อ่านพร้อมไฟล์แนบ, และโฟลเดอร์ที่มีชื่อโฟลเดอร์ย่อยเฉพาะ.

from aspose.email.mapi import MapiMessageFlags
from aspose.email.storage.pst import PersonalStorage, PersonalStorageQueryBuilder, MapiImportance

with PersonalStorage.from_file(data_dir + "my.pst") as personal_storage:
    folder = personal_storage.root_folder.get_sub_folder("Inbox")
    builder = PersonalStorageQueryBuilder()

    # High importance messages
    builder.importance.equals(2)
    messages = folder.get_contents(builder.get_query())
    print("Messages with High Imp:", messages.count)

    builder = PersonalStorageQueryBuilder()
    builder.message_class.equals("IPM.Note")
    messages = folder.get_contents(builder.get_query())
    print("Messages with IPM.Note:", messages.count)

    builder = PersonalStorageQueryBuilder()
    # Messages with attachments AND high importance
    builder.importance.equals(2)
    builder.has_flags(MapiMessageFlags.HASATTACH)
    messages = folder.get_contents(builder.get_query())
    print("Messages with atts:", messages.count)

    builder = PersonalStorageQueryBuilder()
    # Messages with size > 15 KB
    builder.message_size.greater(15000)
    messages = folder.get_contents(builder.get_query())
    print("Messages size > 15 KB:", messages.count)

    builder = PersonalStorageQueryBuilder()
    # Unread messages
    builder.has_no_flags(MapiMessageFlags.READ)
    messages = folder.get_contents(builder.get_query())
    print("Unread:", messages.count)

    builder = PersonalStorageQueryBuilder()
    # Unread messages with attachments
    builder.has_no_flags(MapiMessageFlags.READ)
    builder.has_flags(MapiMessageFlags.HASATTACH)
    messages = folder.get_contents(builder.get_query())
    print("Unread msgs with atts:", messages.count)

    # Folder with name 'SubInbox'
    builder = PersonalStorageQueryBuilder()
    builder.folder_name.equals("SubInbox")
    folders = folder.get_sub_folders(builder.get_query())
    print("Folder having subfolder:", folders.count)

    builder = PersonalStorageQueryBuilder()
    # Folders with subfolders
    builder.has_subfolders()
    folders = folder.get_sub_folders(builder.get_query())
    print("Folders with subfolders:", folders.count)

ค้นหาด้วยการจับคู่แบบไม่สนใจตัวพิมพ์ใหญ่-เล็ก

โดยใช้ Aspose.Email PersonalStorageQueryBuilder, คุณสามารถระบุเงื่อนไขการค้นหาสำหรับข้อความอีเมลโดยไม่คำนึงถึงตัวพิมพ์ใหญ่-เล็ก ทำให้การค้นหามีความยืดหยุ่นและเป็นมิตรต่อผู้ใช้มากขึ้น ตัวอย่างโค้ดต่อไปนี้แสดงวิธีโหลดไฟล์ PST, เข้าถึงโฟลเดอร์ "Inbox", และใช้ฟิลเตอร์การค้นหาแบบไม่สนใจตัวพิมพ์ใหญ่-เล็กเพื่อค้นหาอีเมลตามข้อมูลผู้ส่ง ฟีเจอร์นี้ช่วยอย่างยิ่งเมื่อจัดการกับข้อมูลอีเมลที่มีการใช้ตัวอักษรหลากหลาย.

ค้นหาบรรทัดหัวเรื่องโดยใช้หลายคีย์เวิร์ด

ดึงข้อความหรือรายการเฉพาะจากไฟล์จัดเก็บส่วนบุคคล (PST) หรือแหล่งเก็บข้อความโดยใช้ either(query1, query2) เมธอดของ PersonalStorageQueryBuilder คลาส รับพารามิเตอร์สองตัวที่ให้คุณรวมสองคิวรีต่างกัน query1 และ query2 เพื่อค้นหาหัวเรื่องของข้อความที่ตรงกับคำใดคำหนึ่งจากสองคำที่ระบุ ดูตัวอย่างโค้ดด้านล่าง:

import aspose.email as ae

builder1 = ae.storage.pst.PersonalStorageQueryBuilder()
builder1.subject.contains("Review") # 'Review' is key word for the search

builder2 = ae.storage.pst.PersonalStorageQueryBuilder()
builder2.subject.contains("Error") # 'Error' is also key word for the search

builder = ae.storage.pst.PersonalStorageQueryBuilder()
# message subjects must contain 'Review' or 'Error' words
builder.either(builder1.get_query(), builder2.get_query())


pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

folder = pst.root_folder.get_sub_folder("Inbox")
messages = folder.get_contents(builder.get_query())

for message in messages:
    print(f"Message: {message.subject}")

กรองอีเมลใน PST ตามเกณฑ์เฉพาะ

ดึงเฉพาะข้อความที่ตรงกับตัวกรองเฉพาะ เช่น หัวเรื่อง, ผู้ส่ง หรือวันที่ โดยใช้ MailQuery คลาส ตัวอย่างโค้ดต่อไปนี้แสดงวิธีใช้ไลบรารี Aspose.Email เพื่อโหลดไฟล์ PST และกรองข้อความภายในโฟลเดอร์เฉพาะ ในกรณีนี้คือโฟลเดอร์ "Inbox":

import aspose.email as ae

# Load the PST file and access a folder
pst = ae.PersonalStorage.from_file("sample.pst")
inbox = pst.root_folder.get_sub_folder("Inbox")

# Create a MailQuery to filter messages by subject
query_builder = ae.MailQueryBuilder()
query_builder.subject.contains("Invoice")

query = query_builder.get_query()

# Enumerate filtered messages
for info in inbox.enumerate_mapi_messages(query):
    print("Subject:", info.subject)

ดึงข้อความตามประเภท

Aspose.Email MessageKind การโอเวอร์โหลดช่วยให้คุณดึงข้อความประเภทเฉพาะ เช่น อีเมลเท่านั้น, การนัดหมาย, หรือผู้ติดต่อ ตัวอย่างโค้ดต่อไปนี้แสดงวิธีเข้าถึงและกรองประเภทข้อความเฉพาะจากโฟลเดอร์ที่กำหนด:

import aspose.email as ae

# Load the PST and target folder
pst = ae.PersonalStorage.from_file("sample.pst")
inbox = pst.root_folder.get_sub_folder("Inbox")

# Retrieve only email messages (not calendar items, contacts, etc.)
for info in inbox.enumerate_mapi_messages(ae.MessageKind.MAPI_MESSAGE):
    print("Email Message:", info.subject)

แบ่งหน้าเพื่อนำข้อความจากไฟล์ PST ขนาดใหญ่

เมื่อต้องทำงานกับโฟลเดอร์ที่มีข้อความจำนวนมาก คุณสามารถใช้การแบ่งหน้าเพื่อโหลดข้อความเป็นส่วนๆ โดยใช้ start_index และ count พารามิเตอร์ ตัวอย่างโค้ดต่อไปนี้แสดงวิธีเข้าถึงและดึงช่วงเฉพาะของข้อความอีเมลจากไฟล์ PST แทนที่จะดึงทั้งหมดในครั้งเดียว:

import aspose.email as ae

# Load the PST and access the target folder
pst = ae.PersonalStorage.from_file("sample.pst")
inbox = pst.root_folder.get_sub_folder("Inbox")

# Retrieve messages from index 0 to 9
for info in inbox.enumerate_mapi_messages(0, 10):
    print("Paged Message:", info.subject)

อัปเดตและจัดระเบียบเนื้อหา Outlook PST

การย้ายข้อความระหว่างโฟลเดอร์

Aspose.Email ทำให้สามารถย้ายรายการจากโฟลเดอร์ต้นทางไปยังโฟลเดอร์อื่นในไฟล์ Personal Storage (PST) เดียวกันได้ สิ่งนี้รวมถึง:

การย้ายโฟลเดอร์ที่กำหนดไปยังโฟลเดอร์แม่ใหม่.
การย้ายข้อความที่ระบุไปยังโฟลเดอร์ใหม่.
การย้ายเนื้อหาไปยังโฟลเดอร์ใหม่.
การย้ายโฟลเดอร์ย่อยไปยังโฟลเดอร์แม่ใหม่.

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการย้ายรายการเช่นข้อความและโฟลเดอร์จากโฟลเดอร์ต้นทางไปยังโฟลเดอร์อื่นในไฟล์ PST เดียวกัน.

อัปเดตคุณสมบัติของข้อความ

บางครั้งจำเป็นต้องแก้ไขคุณสมบัติบางอย่างของข้อความ เช่น การเปลี่ยนหัวเรื่อง การทำเครื่องหมายความสำคัญของข้อความ ฯลฯ การอัพเดตคุณสมบัติเหล่านี้ในไฟล์ PST สามารถทำได้โดยใช้ FolderInfo.change_messages เมธอดที่ Aspose.Email สำหรับ Python มอบให้ บทความนี้แสดงกระบวนการอัพเดตคุณสมบัติของข้อความเป็นกลุ่ม เพื่อการปรับเปลี่ยนอัตโนมัติในหลายข้อความภายในไฟล์ PST ด้านล่างมีตัวอย่างโค้ดที่แสดงวิธีทำการอัพเดตเป็นกลุ่มบนคุณสมบัติต่างๆ ของข้อความ

from aspose.email.storage.pst import PersonalStorage, PersonalStorageQueryBuilder
from aspose.email.mapi import MapiPropertyTag, MapiProperty, MapiPropertyCollection

pst_file_path = data_dir + "ya4demia04vb.pst"

# Load the Outlook PST file
with PersonalStorage.from_file(pst_file_path) as personal_storage:
    # Get the required subfolder
    inbox = personal_storage.root_folder.get_sub_folder("Inbox")

    # Find messages having From = "someuser@domain.com"
    query_builder = PersonalStorageQueryBuilder()
    query_builder.from_address.contains("someuser@domain.com")

    # Get contents from query
    messages = inbox.get_contents(query_builder.get_query())

    # Save (MessageInfo, EntryIdString) in a list
    change_list = [message_info.entry_id_string for message_info in messages]

    # Compose the new properties
    updated_properties = MapiPropertyCollection()
    updated_properties.add(
        MapiPropertyTag.SUBJECT_W,
        MapiProperty(MapiPropertyTag.SUBJECT_W, "New Subject".encode("utf-16le"))
    )
    updated_properties.add(
        MapiPropertyTag.IMPORTANCE,
        MapiProperty(MapiPropertyTag.IMPORTANCE, bytearray([0x02, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00]))
    )

    # Update messages having From = "someuser@domain.com" with new properties
    inbox.change_messages(change_list, updated_properties)

แก้ไขคุณสมบัติ MAPI แบบกำหนดเอง

บางครั้งคุณอาจต้องระบุและทำเครื่องหมายรายการที่ได้ประมวลผลในไฟล์ PST แล้ว API ของ Aspose.Email มีวิธีแก้สำหรับงานนี้โดยใช้ MapiProperty และ MapiNamedProperty คลาส เหล่านี้ช่วยให้คุณระบุรายการที่ประมวลผลแล้วโดยการกำหนดคุณสมบัติแบบกำหนดเองให้กับพวกมัน ด้านล่างคุณจะพบเมธอดที่มีประโยชน์ในการทำเครื่องหมายกระบวนการนี้:

MapiNamedProperty(long propertyTag, string nameIdentifier, UUID propertyGuid, bytearray[] propertyValue)
MapiNamedProperty(long propertyTag, long nameIdentifier, UUID propertyGuid, bytearray[] propertyValue)
FolderInfo.change_messages(MapiPropertyCollection updatedProperties) - เปลี่ยนแปลงข้อความทั้งหมดในโฟลเดอร์
PersonalStorage.change_message(string entryId, MapiPropertyCollection updatedProperties) - เปลี่ยนแปลงคุณสมบัติของข้อความ

from uuid import UUID
from aspose.email.storage.pst import PersonalStorage
from aspose.email.mapi import MapiNamedProperty, MapiPropertyCollection
from aspose.email.mapi import MapiPropertyType, MapiProperty, MapiPropertyTag

def generate_named_property_tag(index, data_type):
    return (((0x8000 | index) << 16) | data_type) & 0x00000000FFFFFFFF

def run():
    # Load the Outlook file
    pst_file_path = data_dir + "my.pst"

    with PersonalStorage.from_file(pst_file_path) as personal_storage:
        test_folder = personal_storage.root_folder.get_sub_folder("Inbox")

        # Create the collection of message properties for adding or updating
        new_properties = MapiPropertyCollection()

        # Normal, Custom, and PidLidLogFlags named properties
        mapi_property = MapiProperty(
            MapiPropertyTag.ORG_EMAIL_ADDR_W,
            "test_address@org.com".encode("utf-16le")
        )
        named_property1 = MapiNamedProperty(
            generate_named_property_tag(0, MapiPropertyType.LONG),
            "ITEM_ID",
            UUID("00000000-0000-0000-0000-000000000000"),
            bytearray([0x7B, 0x00, 0x00, 0x00])
        )
        named_property2 = MapiNamedProperty(
            generate_named_property_tag(1, MapiPropertyType.LONG),
            0x0000870C,
            UUID("0006200A-0000-0000-C000-000000000046"),
            bytearray([0x00, 0x00, 0x00, 0x00])
        )
        new_properties.add(named_property1.tag, named_property1)
        new_properties.add(named_property2.tag, named_property2)
        new_properties.add(mapi_property.tag, mapi_property)
        test_folder.change_messages(test_folder.enumerate_messages_entry_id(), new_properties)

# Usage
run()

ลบข้อความและโฟลเดอร์จากไฟล์ Outlook PST

การจัดการเนื้อหาของไฟล์ Outlook PST มักเกี่ยวข้องกับการลบข้อความ โฟลเดอร์ หรือหลายรายการพร้อมกัน Aspose.Email สำหรับ Python ผ่าน .NET มีเมธอดที่มีประสิทธิภาพเพื่อการลบข้อความและโฟลเดอร์จากไฟล์ PST ไม่ว่าจะเป็นการลบอีเมลเดี่ยว, FolderInfo.delete_child_item() เมธอด หรือทำการลบเป็นกลุ่ม, FolderInfo.delete_child_items() เมธอด เพื่อการจัดการไฟล์ที่ดียิ่งขึ้น.

ลบข้อความจากไฟล์ PST

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

อ็อบเจกต์ PST ถูกเริ่มต้นโดยการเปิดไฟล์ "Outlook.pst" ที่อยู่ในไดเรกทอรีที่ระบุโดยใช้ PersonalStorage.from_file().
เข้าถึงโฟลเดอร์ Sent Items โดยใช้ pst.get_predefined_folder(StandardIpmFolder.SENT_ITEMS).
จากนั้นโค้ดดึงเนื้อหาของโฟลเดอร์ "Sent Items" ด้วย folder.get_contents(), นับจำนวนและพิมพ์จำนวนข้อความทั้งหมดในโฟลเดอร์นี้.
โค้ดเข้าถึงข้อความแรกในโฟลเดอร์ "Sent Items" ด้วย msgsColl[0] และลบมันโดยใช้ folder.delete_child_item(msgInfo.entry_id). ฟังก์ชันนี้ใช้ Entry ID ของข้อความเพื่อเอาออกจากโฟลเดอร์.

หลังจากการลบ โค้ดจะนับจำนวนข้อความในโฟลเดอร์ "Sent Items" อีกครั้งและพิมพ์จำนวนที่อัปเดต

ลบรายการจากไฟล์ PST

ในระบบข้อความหรือไคลเอนต์อีเมลหลายระบบ แต่ละรายการ (เช่น อีเมล, การนัดหมาย หรือ งาน) จะได้รับตัวระบุที่ไม่ซ้ำกันเรียกว่า Entry ID. delete_item(entry_id) เมธอดของ FolderInfo คลาสรับ Entry ID นี้เป็นพารามิเตอร์และลบรายการที่สอดคล้องจากแหล่งเก็บข้อความ ใช้โค้ดต่อไปนี้เพื่อลบรายการจากแหล่งเก็บข้อความ:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

pst.delete_item(entry_id)

ลบรายการเป็นกลุ่ม

API ของ Aspose.Email สามารถใช้ลบรายการเป็นกลุ่มจากไฟล์ PST ได้ ซึ่งทำได้โดยใช้ delete_child_items() เมธอดที่รับรายการ Entry ID ของรายการที่ต้องการลบ ตัวอย่างโค้ดต่อไปนี้แสดงวิธีลบรายการเป็นกลุ่มจากไฟล์ PST

ลบโฟลเดอร์จากไฟล์ PST

ไฟล์ Outlook PST อาจมีโฟลเดอร์ที่ไม่จำเป็นอีกต่อไป Aspose.Email สำหรับ Python ผ่าน .NET ให้คุณลบโฟลเดอร์เหล่านี้ได้โดยการย้ายไปยังโฟลเดอร์ Deleted Items (ทำให้สามารถกู้คืนได้) หรือโดยการลบอย่างถาวร ตัวอย่างต่อไปนี้แสดงทั้งสองวิธี

ย้ายโฟลเดอร์ไปยัง Deleted Items (การลบแบบซอฟท์)

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

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

deleted_items_folder = pst.get_predefined_folder(ae.storage.pst.StandardIpmFolder.DELETED_ITEMS)
empty_folder = pst.root_folder.get_sub_folder("Empty folder")
some_folder = pst.root_folder.get_sub_folder("Some folder")
pst.move_item(empty_folder, deleted_items_folder)
pst.move_item(some_folder, deleted_items_folder)

ข้อได้เปรียบของเมธอดนี้คือโฟลเดอร์ที่ถูกลบสามารถกู้คืนได้ง่าย.

กู้คืนโฟลเดอร์จาก Deleted Items

นี้ move_item เมธอดนี้ช่วยให้คุณกู้คืนโฟลเดอร์ หากถูกลบโดยผิดพลาด โดยย้ายกลับจาก Deleted Items ไปยังตำแหน่งเดิม

some_folder = pst.root_folder.get_sub_folder("Some folder")
pst.move_item(some_folder, pst.root_folder)

ลบโฟลเดอร์อย่างถาวรจาก Deleted Items

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

deleted_items_folder.delete_child_item(empty_folder.entry_id)

ลบโฟลเดอร์อย่างถาวรโดยทันที

หากต้องการลบโฟลเดอร์โดยไม่ย้ายไปยัง Deleted Items, delete_child_item เมธอดทำให้การลบเป็นทันทีและถาวร

some_folder = pst.root_folder.get_sub_folder("Some folder")
pst.root_folder.delete_child_item(some_folder.entry_id)

Python-Net: การจัดการการปกป้องรหัสผ่านไฟล์ PST

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

Microsoft Outlook อนุญาตให้ผู้ใช้ปกป้องไฟล์ PST ด้วยรหัสผ่านเพื่อจำกัดการเข้าถึง Aspose.Email สามารถตรวจจับการปกป้องด้วยรหัสผ่านบนไฟล์ PST ได้.

บทความนี้ครอบคลุมประเด็นต่อไปนี้:

ตรวจสอบการปกป้องรหัสผ่านไฟล์ PST
อ่านไฟล์ PST ที่ปกป้องด้วยรหัสผ่าน
ตรวจสอบรหัสผ่านใน PST ที่ปกป้องด้วยรหัสผ่าน
เพิ่ม/เปลี่ยน/ลบรหัสผ่านในไฟล์ PST

ตรวจสอบการปกป้องรหัสผ่านไฟล์ PST

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

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

print(f"The storage is password protected - {pst.store.is_password_protected}")

อ่านไฟล์ PST ที่มีการปกป้องรหัสผ่าน

คุณสามารถอ่านไฟล์ที่มีการปกป้องรหัสผ่านได้เช่นเดียวกับไฟล์ PST ปกติส่วนโค้ดต่อไปนี้ให้คุณเข้าถึงแต่ละข้อความอย่างอิสระพร้อมความเป็นไปได้ในการประมวลผลต่อ:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

for folder in pst.root_folder.get_sub_folders():
    for msg in folder.enumerate_messages():
    # do something

ตรวจสอบความถูกต้องของรหัสผ่าน PST

เพื่อตรวจสอบว่ารหัสผ่านในไฟล์ PST ถูกต้องหรือไม่ Aspose.Email ให้เมธอด is_password_valid(password) ของ คลังข้อความ คลาส รับสตริงรหัสผ่านเป็นพารามิเตอร์และคืนค่า True หากรหัสถูกต้องและ False หากไม่ถูกต้อง.

ส่วนโค้ดต่อไปนี้แสดงการใช้เมธอด is_password_valid(password):

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

print(f"Password is valid - {pst.store.is_password_valid('Password1')}")

เพิ่ม, เปลี่ยน หรือเอารหัสผ่าน PST ออก

เมธอด change_password(password) ของ คลังข้อความ คลาสนี้ใช้จัดการรหัสผ่านในไฟล์ PST ตัวอย่างโค้ดต่อไปนี้แสดงวิธีเพิ่ม เปลี่ยน หรือเอารหัสผ่านออก:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.create("SetPasswordOnPST_out.pst", ae.storage.pst.FileFormatVersion.UNICODE)
# Add or change the password
password = "Password1"
pst.store.change_password(password)
# Remove the password
pst.store.change_password(None)

Python-Net: การจัดการไฟล์ Outlook OLM ในแอปพลิเคชัน Python

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

OLM (Outlook for Mac Archive) คือรูปแบบไฟล์ที่เกี่ยวข้องกับ Microsoft Outlook for Mac ใช้เพื่อเก็บสำรองและจัดเก็บข้อความอีเมล รายชื่อผู้ติดต่อ รายการปฏิทิน งาน และข้อมูล Outlook อื่น ๆ บนคอมพิวเตอร์ Mac ไฟล์ OLM ทำหน้าที่เป็นรูปแบบสำรองหรือเก็บถาวร ช่วยให้ผู้ใช้บันทึกข้อมูล Outlook for Mac ของตนเพื่ออ้างอิงหรือย้ายในอนาคต ต้องทราบว่าไฟล์ OLM มีเฉพาะสำหรับ Outlook for Mac และไม่เข้ากันกับรูปแบบไฟล์ PST (Personal Storage Table) ที่ใช้โดย Outlook บน Windows หากต้องการย้ายข้อมูล Outlook ระหว่างแพลตฟอร์มต่าง ๆ เครื่องมือแปลงไฟล์จะมีประโยชน์ Aspose.Email มีเครื่องมือเหล่านี้รวมถึงการเปิดอ่านและฟังก์ชันอื่น ๆ สำหรับทำงานกับไฟล์ OLM.

การเปิดไฟล์ Outlook OLM

ไฟล์รูปแบบ OLM สามารถเปิดได้สองวิธี:

โดยใช้คอนสตรัคเตอร์
โดยใช้เมธอดสเตติก ‘from_file’

เปิดไฟล์ Outlook OLM ด้วยคอนสตรักเตอร์ของ Python

เพื่อเปิดไฟล์ เรียกคอนสตรัคเตอร์ของ OlmStorage คลาสและส่งชื่อไฟล์เต็มหรือสตรีมเป็นอาร์กิวเมนต์ให้กับมัน:

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage(fileName)

เปิดไฟล์ OLM ด้วยเมธอดคงที่ FromFile ของ Python

เพื่อเปิดไฟล์ ให้ใช้เมธอดสเตติก ‘from_file’ ของ OlmStorage คลาสและส่งชื่อไฟล์เต็มหรือสตรีมเป็นอาร์กิวเมนต์ให้กับมัน:

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)

การจัดการโฟลเดอร์และอีเมลในไฟล์ OLM

เข้าถึงโครงสร้างโฟลเดอร์แบบเรียกซ้ำ

API ของ Aspose.Email ให้คุณจำลองและแสดงโครงสร้างโฟลเดอร์ที่ดึงจากไฟล์ OLM โดยใช้ฟังก์ชัน print_all_folders ฟังก์ชันนี้รับ property folder_hierarchy ของ OlmStorage คลาส พร้อมระดับการเยื้องเป็นอินพุต และทำการทริเวิร์สโครงสร้างแบบเรียกซ้ำเพื่อพิมพ์ชื่อโฟลเดอร์แต่ละอันด้วยการเยื้องที่เหมาะสม.

ต่อไปนี้คือตัวอย่างโค้ดที่สาธิตวิธีใช้ฟังก์ชัน print_all_folders เพื่อแสดงโครงสร้างโฟลเดอร์จากไฟล์ OLM:

import aspose.email as ae


def print_all_folders(folder_hierarchy, indent):
    for folder in folder_hierarchy:
        print(f"{indent}{folder.name}")
        print_all_folders(folder.sub_folders, indent + "-")

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage(fileName)
print_all_folders(olm.folder_hierarchy, "")

ตัวอย่างโค้ดข้างต้นมีจุดประสงค์เพื่อแสดงโครงสร้างโฟลเดอร์ของไฟล์ OLM ผ่านฟังก์ชันเรียกซ้ำในรูปแบบที่เป็นระเบียบและอ่านง่ายขึ้น.

เข้าถึงโครงสร้างโฟลเดอร์โดยตรง

Aspose.Email ยังทำให้สามารถเข้าถึงโครงสร้างโฟลเดอร์จากไฟล์ OLM โดยตรงด้วยเมธอด get_folders() ของ OlmStorage คลาส.

ต่อไปนี้คือตัวอย่างโค้ดสำหรับเข้าถึงโครงสร้างโฟลเดอร์โดยตรง:

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)
folders = olm.get_folders()

ดึงโฟลเดอร์ตามชื่อ

สามารถดึงโฟลเดอร์ใดก็ได้โดยชื่อโดยใช้เมธอด get_folder(name, ignore_case) ของ OlmStorage คลาส เมธอดนี้ต้องการพารามิเตอร์ชื่อโฟลเดอร์และความไวต่อการพิมพ์.

นี่คือตัวอย่างโค้ดที่แสดงวิธีดึงโฟลเดอร์โดยชื่อ:

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)
folder = olm.get_folder("Inbox", True)

รายการอีเมลจากไฟล์ Outlook OLM

ไลบรารี Aspose.Email สามารถใช้เพื่ออ่านและแยกข้อความอีเมลจากไฟล์ Outlook for Mac (OLM) คุณสามารถดึงรายการอีเมลโดยใช้เมธอดต่อไปนี้ของ OlmFolder คลาสที่แสดงโฟลเดอร์:

enumerate_messages() - วนซ้ำผ่านแต่ละข้อความอีเมลในโฟลเดอร์ เมธอดนี้คืนข้อความเป็นอินสแตนซ์ของ OlmMessageInfo คลาสที่ให้ข้อมูลพื้นฐานเกี่ยวกับแต่ละข้อความอีเมล เช่น หัวเรื่อง ผู้ส่ง วันที่ เป็นต้น.
enumerate_mapi_messages() - ยังวนซ้ำผ่านแต่ละข้อความอีเมลในโฟลเดอร์ แต่ในกรณีนี้จะคืนข้อความเป็นอินสแตนซ์ของ MapiMessage คลาสที่แสดงข้อความอีเมลในรูปแบบที่ละเอียดและเฉพาะเจาะจงตาม MAPI มากขึ้น มันให้การเข้าถึงคุณสมบัติและรายละเอียดหลากหลายของข้อความอีเมล เพื่อการประมวลผลที่ซับซ้อนและเฉพาะทางมากขึ้น.

ตัวอย่างโค้ดด้านล่างแสดงวิธีแยกหัวข้ออีเมลพื้นฐานและบันทึกข้อความอีเมลโดยละเอียดจากไฟล์ Outlook OLM โดยใช้ enumerate_messages() เพื่อดึงหัวข้อและ enumerate_mapi_messages() เพื่อบันทึกข้อความเป็นไฟล์ .msg.

แยกข้อมูลอีเมลพื้นฐานโดยใช้เมธอด ’enumerate_messages()’

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)
folder = olm.get_folder("Inbox", True)

for message_info in folder.enumerate_messages():
    print(message_info.subject)

บันทึกข้อความอีเมลโดยละเอียดโดยใช้เมธอด ’enumerate_mapi_messages()’

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)
folder = olm.get_folder("Inbox", True)

for msg in folder.enumerate_mapi_messages():
    msg.save(f"{msg.subject}.msg")

ดึงจำนวนข้อความทั้งหมดในโฟลเดอร์ OLM

นี้ OlmFolder คลาสให้ตัวเลือกเพิ่มเติมด้วยเมธอดต่อไปนี้:

has_messages - รับค่าที่บ่งบอกว่าโฟลเดอร์ปัจจุบันมีข้อความหรือไม่.
message_count - รับจำนวนข้อความ.

ตัวอย่างโค้ดด้านล่างแสดงวิธีใช้เมธอดเหล่านี้:

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)
folder = olm.get_folder("Inbox", True)

if folder.has_messages:
   print(f"Message count: {folder.message_count}")

รับหรือกำหนดวันที่แก้ไขสำหรับข้อความ Outlook OLM

Aspose.Email ทำให้สามารถดึงข้อมูลเวลาการแก้ไขล่าสุดของข้อความอีเมลได้ Property modified_date ของ OlmMessageInfo คลาสนี้แสดงวันที่และเวลาที่ข้อความถูกแก้ไขครั้งล่าสุด.

นี่คือตัวอย่างที่แสดงการใช้งานของ property:

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)
folder = olm.get_folder("Inbox", True)

for message_info in folder.enumerate_messages():
    modifiedDate = message_info.modified_date

การแยกเนื้อหา OLM

แยกอีเมลจากไฟล์ Outlook OLM

คุณสามารถดึงข้อมูลข้อความ MAPI จริงจากที่จัดเก็บอีเมลโดยใช้เมธอด extract_mapi_message(message_info) ของ OlmStorage คลาส เมธอดนี้แยกข้อความ MAPI จากที่จัดเก็บตาม message_info ที่ระบุ.

ตัวอย่างโค้ดด้านล่างแสดงวิธีใช้เมธอดนี้:

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)
folder = olm.get_folder("Inbox", True)

for message_info in folder.enumerate_messages():
    msg = olm.extract_mapi_message(message_info)

แยกข้อความ Outlook จากไฟล์ OLM ตามตัวระบุ

เพื่อเข้าถึงข้อมูลข้อความ MAPI คุณสามารถใช้ property entry_id เพื่อรับตัวระบุเฉพาะ (Entry ID) ของข้อความโดยใช้ OlmMessageInfo คลาส จากนั้นคุณสามารถใช้เมธอด extract_mapi_message(id) ของ OlmStorage คลาส โดยส่ง Entry ID เป็นพารามิเตอร์เพื่อดึงข้อความ MAPI ที่เชื่อมโยงกับ Entry ID นั้น ตัวอย่างโค้ดต่อไปนี้แสดงการใช้คุณลักษณะเหล่านี้:


import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)
folder = olm.get_folder("Inbox", True)

for message_info in folder.enumerate_messages():
    msg = olm.extract_mapi_message(message_info.entry_id)

การจัดการโครงสร้างโฟลเดอร์ OLM

ดึงเส้นทางโฟลเดอร์ในไฟล์ Outlook OLM

Aspose.Email อนุญาตให้คุณรับเส้นทางหรือที่ตั้งแบบลำดับชั้นของโฟลเดอร์ภายในไฟล์ Outlook OLM API ให้ property path ของ OlmFolder คลาสที่คืนค่าพาธของโฟลเดอร์ ตัวอย่างโค้ดต่อไปนี้แสดงการใช้คุณสมบัตินี้:

import aspose.email as ae


def print_path(storage, folders):
    for folder in folders:
        # print the current folder path
        print(folder.path)

        if folder.sub_folders:
            print_path(storage, folder.sub_folders)


fileName = "my.olm"
olm = ae.storage.olm.OlmStorage(fileName)
print_path(olm, olm.folder_hierarchy)

นับรายการในโฟลเดอร์ Outlook OLM

Aspose.Email ให้ความสามารถในการนับจำนวนข้อความอีเมลทั้งหมดที่อยู่ในโฟลเดอร์เฉพาะของไฟล์ Outlook OLM โดย property message_count ของ OlmFolder คลาสนี้คืนค่าจำนวนรายการทั้งหมด (ข้อความอีเมล) ที่เก็บอยู่ในโฟลเดอร์เฉพาะในไฟล์ OLM ตัวอย่างโค้ดต่อไปนี้แสดงการใช้คุณสมบัตินี้:

import aspose.email as ae


def print_message_count(folders):
    for folder in folders:
        print(f"Message Count [{folder.name}]: {folder.message_count}")


fileName = "my.olm"
olm = ae.storage.olm.OlmStorage(fileName)
print_message_count(olm.folder_hierarchy)

รับจำนวนรายการทั้งหมดในไฟล์ Outlook OLM

เมธอด get_total_items_count() ของ OlmStorage คลาสคืนค่าจำนวนรายการข้อความทั้งหมดที่อยู่ในที่จัดเก็บ OLM ตามที่แสดงในตัวอย่างโค้ดด้านล่าง:

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage(fileName)
count = olm.get_total_items_count()

การจัดการหมวดหมู่ Outlook

ดึงสีของหมวดหมู่ Outlook

ด้วย Aspose.Email คุณสามารถดึงและใช้สีของหมวดหมู่ที่เชื่อมโยงกับรายการ Outlook ที่เก็บในไฟล์ OLM ได้อย่างง่ายดาย OlmItemCategory คลาสนี้ทำให้คุณเข้าถึงชื่อหมวดหมู่และสีที่แสดงในรูปแบบฮेकซะเดซิล OlmStorage คลาสมีเมธอด GetCategories() สำหรับดึงรายการหมวดหมู่จากที่จัดเก็บ OLM โดยใช้ตัวอย่างโค้ดด้านล่าง คุณสามารถดึงหมวดหมู่ที่ใช้ทั้งหมดจากไฟล์ที่จัดเก็บ OML ได้อย่างง่ายดายและเข้าถึงชื่อหมวดหมู่พร้อมสีของมัน.

with OlmStorage.FromFile("storage.olm") as olm:
    categories = olm.GetCategories()
    
    for category in categories:
        print(f"Category name: {category.Name}")
        
        # Color is represented as a hexadecimal value: #rrggbb
        print(f"Category color: {category.Color}")

นอกจากนี้คุณยังสามารถดึงสีของหมวดหมู่ที่เชื่อมโยงกับข้อความเฉพาะโดยการวนลูปผ่านข้อความในโฟลเดอร์และเข้าถึงสีหมวดหมู่ที่สอดคล้องตามชื่อหมวดหมู่

for msg in olm.EnumerateMessages(folder):
    if msg.Categories is not None:
        for msgCategory in msg.Categories:
            print(f"Category name: {msgCategory}")
            categoryColor = next((c.Color for c in categories if c.Name.lower() == msgCategory.lower()), None)
            if categoryColor is not None:
                print(f"Category color: {categoryColor}")

Python-Net: อ่านไฟล์ OLM ของ Outlook for Mac และรับข้อมูลโฟลเดอร์และโฟลเดอร์ย่อย

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

การเปิดไฟล์รูปแบบ OLM

ไฟล์รูปแบบ OLM สามารถเปิดได้สองวิธี:

โดยใช้คอนสตรัคเตอร์
โดยใช้เมธอดสเตติก ‘from_file’

การเปิดไฟล์ด้วยตัวสร้าง

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage(fileName)

การเปิดไฟล์โดยใช้เมธอดสเตติก FromFile

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)

การดึงโฟลเดอร์

คุณสามารถจำลองและแสดงโครงสร้างโฟลเดอร์ที่ดึงจากไฟล์ OLM โดยใช้ฟังก์ชัน ‘print_all_folders’ ซึ่งรับ property ‘folder_hierarchy’ ของ OlmStorage คลาสและระดับการเยื้องเป็นอินพุต จากนั้นทำการทริเวิร์สโครงสร้างแบบเรียกซ้ำเพื่อพิมพ์ชื่อโฟลเดอร์แต่ละอันพร้อมการเยื้องที่เหมาะสม ตัวอย่างโค้ดด้านล่างแสดงวิธีใช้ฟังก์ชันนี้เพื่อแสดงโครงสร้างโฟลเดอร์จากไฟล์ OLM โดยแสดงรายการของโฟลเดอร์ทั้งหมดในลำดับแบบลำดับชั้น:

import aspose.email as ae


def print_all_folders(folder_hierarchy, indent):
    for folder in folder_hierarchy:
        print(f"{indent}{folder.name}")
        print_all_folders(folder.sub_folders, indent + "-")

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage(fileName)
print_all_folders(olm.folder_hierarchy, "")

ตัวอย่างโค้ดข้างต้นมีจุดประสงค์เพื่อแสดงโครงสร้างโฟลเดอร์ของไฟล์ OLM ผ่านฟังก์ชันเรียกซ้ำในรูปแบบที่เป็นระเบียบและอ่านง่ายขึ้น Aspose.Email ยังทำให้สามารถเข้าถึงโครงสร้างโฟลเดอร์โดยตรงจากไฟล์ OLM ด้วยเมธอด ‘get_folders()’ ของ OlmStorage คลาส.

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)
folders = olm.get_folders()

นอกจากนี้ ยังสามารถดึงโฟลเดอร์ใดก็ได้โดยชื่อ ตัวอย่างโค้ดต่อไปนี้ใช้เมธอด ‘get_folder(name, ignore_case)’ ของ OlmStorage คลาสที่ส่งชื่อโฟลเดอร์และความไวต่อการพิมพ์เป็นพารามิเตอร์เพื่อดึงโฟลเดอร์ตามชื่อ:

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)
folder = olm.get_folder("Inbox", True)

รายการอีเมล

โค้ดสแนปต่อไปนี้แสดงวิธีใช้ไลบรารี Aspose.Email เพื่ออ่านและแยกหัวข้ออีเมลจากไฟล์ Outlook for Mac (OLM). OlmFolder คลาสซึ่งแสดงโฟลเดอร์ มีเมธอดต่อไปนี้เพื่อดึงรายการอีเมล:

’enumerate_messages()’ - วนซ้ำผ่านแต่ละข้อความอีเมลในโฟลเดอร์ เมธอดนี้คืนข้อความเป็นอินสแตนซ์ของ OlmMessageInfo คลาสที่ให้ข้อมูลพื้นฐานเกี่ยวกับแต่ละข้อความอีเมล เช่น หัวเรื่อง ผู้ส่ง วันที่ เป็นต้น.
’enumerate_mapi_messages()’ - ยังวนซ้ำผ่านแต่ละข้อความอีเมลในโฟลเดอร์ แต่ในกรณีนี้จะคืนข้อความเป็นอินสแตนซ์ของ MapiMessage คลาสที่แสดงข้อความอีเมลในรูปแบบที่ละเอียดและเฉพาะเจาะจงตาม MAPI มากขึ้น มันให้การเข้าถึงคุณสมบัติและรายละเอียดหลากหลายของข้อความอีเมล เพื่อการประมวลผลที่ซับซ้อนและเฉพาะทางมากขึ้น.

การใช้เมธอด EnumerateMessages

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)
folder = olm.get_folder("Inbox", True)

for message_info in folder.enumerate_messages():
    print(message_info.subject)

การใช้เมธอด EnumerateMapiMessages

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)
folder = olm.get_folder("Inbox", True)

for msg in folder.enumerate_mapi_messages():
    msg.save(f"{msg.subject}.msg")

คุณสมบัติที่เป็นประโยชน์อื่น ๆ

คุณสมบัติที่เป็นประโยชน์อื่น ๆ ของ OlmFolder คลาสมี:

‘has_messages’ - รับค่าที่บ่งบอกว่าโฟลเดอร์ปัจจุบันมีข้อความหรือไม่.
‘message_count’ - รับจำนวนข้อความ.

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)
folder = olm.get_folder("Inbox", True)

if folder.has_messages:
   print(f"Message count: {folder.message_count}")

รับหรือกำหนดวันที่แก้ไขของข้อความ

คุณสามารถดึงข้อมูลเกี่ยวกับเวลาการแก้ไขครั้งล่าสุดของข้อความอีเมลได้ property ‘modified_date’ ของ OlmMessageInfo คลาสนี้แสดงวันที่และเวลาที่ข้อความถูกแก้ไขครั้งล่าสุด.

นี่คือตัวอย่างที่แสดงการใช้งานของ property:

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)
folder = olm.get_folder("Inbox", True)

for message_info in folder.enumerate_messages():
    modifiedDate = message_info.modified_date

การแยกอีเมล

คุณสามารถดึงข้อมูลข้อความ MAPI จริงจากที่จัดเก็บอีเมลได้ เมธอด ’extract_mapi_message(message_info)’ ของ OlmStorage คลาสนี้ใช้เพื่อแยกข้อความ MAPI จากที่จัดเก็บตาม message_info ที่ระบุ.

ตัวอย่างโค้ดด้านล่างแสดงวิธีใช้เมธอดนี้:

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)
folder = olm.get_folder("Inbox", True)

for message_info in folder.enumerate_messages():
    msg = olm.extract_mapi_message(message_info)

การแยกรายการทั้งหมดจากอีเมลโดยใช้ Traversal API

คุณสามารถแยกรายการทั้งหมดจากไฟล์ Outlook OLM ได้มากที่สุดโดยไม่โยนข้อยกเว้น แม้บางข้อมูลของไฟล์ต้นฉบับจะเสียหาย เพื่อทำเช่นนี้ ให้ใช้ OlmStorage(TraversalExceptionsCallback callback) คอนสตรัคเตอร์และ Load(string fileName) เมธอดแทนเมธอด FromFile. ตัวสร้างอนุญาตให้กำหนดเมธอด callback.

using (var olm = new OlmStorage((exception, id) => { /* Exception handling  code. */ }))

เมธอด callback ทำให้ข้อยกเว้นในการโหลดและการทริเวิร์สสามารถเข้าถึงได้.

นี้ Load เมธอดคืนค่า ’true’ หากไฟล์โหลดสำเร็จและสามารถเดินสำรวจต่อได้ หากไฟล์เสียหายและไม่สามารถเดินสำรวจได้ จะคืนค่า ‘false’.

if (olm.Load(fileName))

โค้ดสแนปและขั้นตอนต่อไปนี้แสดงวิธีใช้ API นี้:

สร้างอินสแตนซ์ใหม่ของ OlmStorage คลาส โดยส่ง callback การจัดการข้อยกเว้นเพื่อจัดการกับข้อผิดพลาดที่เกิดขึ้นระหว่างกระบวนการ.
โหลดไฟล์ OLM โดยเรียก Load เมธอดของอินสแตนซ์ OlmStorage.
หากไฟล์ OLM ถูกโหลดสำเร็จ ให้ดึงโครงสร้างโฟลเดอร์โดยเรียก GetFolders เมธอดบนอินสแตนซ์ OlmStorage ซึ่งจะคืนค่าเป็นรายการของอ็อบเจกต์ OlmFolder.
เรียกเมธอด ExtractItems โดยส่งอินสแตนซ์ OlmStorage และรายการของอ็อบเจกต์ OlmFolder.
ในเมธอด ExtractItems ให้วนซ้ำผ่านแต่ละโฟลเดอร์ในรายการ folders.
หากโฟลเดอร์มีข้อความ (อีเมล) ให้พิมพ์ชื่อโฟลเดอร์ไปยังคอนโซลโดยใช้ Console.WriteLine(folder).
วนซ้ำผ่านข้อความในโฟลเดอร์ปัจจุบันโดยเรียกเมธอด EnumerateMessages บนอินสแตนซ์ OlmStorage และส่งโฟลเดอร์ปัจจุบันเป็นอาร์กิวเมนต์.
พิมพ์หัวข้อของแต่ละข้อความไปยังคอนโซลโดยใช้ Console.WriteLine(msg.Subject).
หากโฟลเดอร์มีโฟลเดอร์ย่อย ให้เรียกเมธอด ExtractItems อีกครั้งอย่างเรียกซ้ำ โดยส่งอินสแตนซ์ OlmStorage และโฟลเดอร์ย่อยของโฟลเดอร์ปัจจุบัน

using (var olm = new OlmStorage((exception, id) => { /* Exception handling  code. */ }))
{
    if (olm.Load(fileName))
    {
        var folderHierarchy = olm.GetFolders();
        ExtractItems(olm, folderHierarchy);
    }
}

private static void ExtractItems(OlmStorage olm, List<OlmFolder> folders)
{
    foreach (var folder in folders)
    {
        if (folder.HasMessages)
        {
            Console.WriteLine(folder);

            foreach (var msg in olm.EnumerateMessages(folder))
            {
                Console.WriteLine(msg.Subject);
            }
        }

        if (folder.SubFolders.Count > 0)
        {
            ExtractItems(olm, folder.SubFolders);
        }
    }
}

ดึงข้อความจาก OLM ตามตัวระบุ

เพื่อเข้าถึงข้อมูลข้อความ MAPI คุณสามารถใช้คุณสมบัติ ’entry_id’ เพื่อรับตัวระบุที่ไม่ซ้ำ (Entry ID) ของข้อความโดยใช้ OlmMessageInfo คลาส จากนั้นคุณสามารถใช้เมธอด ’extract_mapi_message(id)’ ของ OlmStorage คลาส โดยส่ง Entry ID เป็นพารามิเตอร์เพื่อดึงข้อความ MAPI ที่เชื่อมโยงกับ Entry ID นั้น ตัวอย่างโค้ดต่อไปนี้แสดงการใช้คุณลักษณะเหล่านี้:


import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)
folder = olm.get_folder("Inbox", True)

for message_info in folder.enumerate_messages():
    msg = olm.extract_mapi_message(message_info.entry_id)

ดึงที่อยู่โฟลเดอร์

คุณอาจยังได้รับพาธหรือที่ตั้งระดับชั้นของโฟลเดอร์ภายในไฟล์ Outlook OLM Aspose.Email มีคุณสมบัติ ‘path’ ของ OlmFolder คลาสที่คืนค่าพาธของโฟลเดอร์ ตัวอย่างโค้ดต่อไปนี้แสดงการใช้คุณสมบัตินี้:

import aspose.email as ae


def print_path(storage, folders):
    for folder in folders:
        # print the current folder path
        print(folder.path)

        if folder.sub_folders:
            print_path(storage, folder.sub_folders)


fileName = "my.olm"
olm = ae.storage.olm.OlmStorage(fileName)
print_path(olm, olm.folder_hierarchy)

นับจำนวนรายการในโฟลเดอร์

Aspose.Email ให้ความสามารถในการนับจำนวนข้อความอีเมลทั้งหมดที่อยู่ในโฟลเดอร์เฉพาะของไฟล์ Outlook OLM คุณสมบัติ ‘message_count’ ของ OlmFolder คลาสนี้คืนค่าจำนวนรายการทั้งหมด (ข้อความอีเมล) ที่เก็บอยู่ในโฟลเดอร์เฉพาะในไฟล์ OLM ตัวอย่างโค้ดต่อไปนี้แสดงการใช้คุณสมบัตินี้:

import aspose.email as ae


def print_message_count(folders):
    for folder in folders:
        print(f"Message Count [{folder.name}]: {folder.message_count}")


fileName = "my.olm"
olm = ae.storage.olm.OlmStorage(fileName)
print_message_count(olm.folder_hierarchy)

รับจำนวนรายการทั้งหมดของ OlmStorage

เมธอด ‘get_total_items_count()’ ของ OlmStorage คลาสนี้คืนค่าจำนวนรายการข้อความทั้งหมดที่อยู่ในที่จัดเก็บ OLM

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage(fileName)
count = olm.get_total_items_count()

ดึงสีของหมวดหมู่ Outlook

ด้วย Aspose.Email คุณสามารถดึงและใช้สีของหมวดหมู่ที่เชื่อมโยงกับรายการ Outlook ที่เก็บในไฟล์ OLM ได้อย่างง่ายดาย OlmItemCategory คลาสนี้ทำให้คุณเข้าถึงชื่อหมวดหมู่และสีที่แสดงในรูปแบบฮेकซะเดซิล OlmStorage คลาสนี้มีเมธอด ‘GetCategories()’ สำหรับดึงรายการหมวดหมู่จากที่จัดเก็บ OLM โดยการใช้ตัวอย่างโค้ดด้านล่าง คุณสามารถดึงหมวดหมู่ที่ใช้งานทั้งหมดจากไฟล์ OML ได้อย่างง่ายดายและเข้าถึงชื่อหมวดหมู่พร้อมสีของมัน

with OlmStorage.FromFile("storage.olm") as olm:
    categories = olm.GetCategories()
    
    for category in categories:
        print(f"Category name: {category.Name}")
        
        # Color is represented as a hexadecimal value: #rrggbb
        print(f"Category color: {category.Color}")

for msg in olm.EnumerateMessages(folder):
    if msg.Categories is not None:
        for msgCategory in msg.Categories:
            print(f"Category name: {msgCategory}")
            categoryColor = next((c.Color for c in categories if c.Name.lower() == msgCategory.lower()), None)
            if categoryColor is not None:
                print(f"Category color: {categoryColor}")