Documentation – کار با فایل‌های ذخیره‌سازی Outlook (OST یا PST)

Python-Net: ایجاد و سازماندهی فایل‌های PST در پایتون

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

ایجاد فایل PST جدید و افزودن زیرپوشه‌ها

Aspose.Email قابلیت ایجاد فایل‌های جدول ذخیره‌سازی شخصی (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 دیگر

برای فهرست‌نگاری و بازیابی تمام پیام‌های 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 با همان خط کد ایجاد کرد با FileFormat enumerator. در حال حاضر، API تبدیل فرمت‌های OST به PST را به جز OST 2013/2016 پشتیبانی می‌کند. قطعه کد زیر نشان می‌دهد چگونه OST را به PST تبدیل کنید:

تبدیل PST به OST

تبدیل از PST به OST توسط Aspose.Email پشتیبانی نمی‌شود زیرا OST همیشه توسط اوتلوک هنگام افزودن حساب و همگام‌سازی با سرور ایمیل ایجاد می‌شود. تفاوت بین فایل‌های PST و OST این است که PST تنها به صورت محلی در دسترس است. محتوای OST نیز بر روی سرور ایمیل در دسترس است. بنابراین نیازی به تبدیل PST به OST برای استفاده محلی نیست. اما می‌توانید PST را با استفاده از ویزارد وارد/صادر کردن در اوتلوک به یک حساب موجود وارد کنید.

برای انجام عملیات دیگر با فایل‌های OST، لطفاً به صفحات زیر مراجعه کنید:

خواندن فایل PST اوتلوک و دریافت اطلاعات پوشه و زیرپوشه
دریافت اطلاعات پیام‌ها از یک فایل PST اوتلوک
استخراج پیام‌ها از فایل PST اوتلوک و ذخیره به دیسک یا استریم با فرمت MSG
دسترس‌آمدن به اطلاعات تماس از فایل PST اوتلوک و ذخیره‌سازی در دیسک با فرمت MSG

Python-Net: خواندن فایل‌های PST مایکروسافت اوتلوک با Aspose.Email برای Python .NET

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

Aspose.Email برای .NET یک API برای خواندن فایل‌های PST مایکروسافت اوتلوک فراهم می‌کند. می‌توانید یک فایل PST را از دیسک یا استریم به یک نمونهٔ PersonalStorage کلاس برای دسترسی به اطلاعات دقیق محتوای آن، مانند پوشه‌ها، زیرپوشه‌ها و پیام‌ها. علاوه بر این، API امکان گنجاندن پوشه‌های جستجو را هنگام بازیابی پیام‌ها از پوشه‌های PST فراهم می‌کند.

بارگذاری یک فایل PST

یک فایل 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 ذخیره‌شده در یک فایل PST اوتلوک دسترسی پیدا کنند و آنها را مدیریت کنند. با دریافت مرجع به "پوشه RSS Feeds"، می‌توانند با داده‌های فید RSS کار کنند، از جمله اشتراک در فیدهای جدید، به‌روزرسانی فیدهای موجود، یا استخراج اطلاعات از فیدها.

مقدار RssFeeds در StandardIpmFolder enum معمولاً نوع پوشه پیش‌تعریف‌شده‌ای را نمایندگی می‌کند که مخصوص ذخیرهٔ فیدهای RSS در یک فایل 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 enum برای کار با انواع مختلف پوشه‌های 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 - یک مقدار بولی است که تعیین می‌کند آیا متد باید هنگام مقایسه نام زیرپوشه به حروف بزرگ/کوچک حساس باشد یا نه. اگر بر روی True تنظیم شود، متد بدون توجه به حروف بزرگ/کوچک مقایسه می‌کند (مثلاً "folder" و "Folder" یک‌نواخت درنظر گرفته می‌شوند). اگر بر روی False تنظیم شود، مقایسه حساسی نسبت به حروف انجام می‌شود.
handle_path_separator - یک مقدار بولی است که مشخص می‌کند آیا متد باید هنگام جستجوی زیرپوشه، جداکنندهٔ مسیر را مدیریت کند یا نه. جداکننده‌های مسیر کاراکترهایی هستند که برای جداسازی پوشه‌ها در مسیر دایرکتوری استفاده می‌شوند (مثلاً "\" در ویندوز یا "/" در یونیکس). اگر بر روی 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

API Aspose.Email امکان تقسیم یک فایل PST به چند فایل PST با اندازهٔ دلخواه را فراهم می‌کند. همچنین می‌تواند چند فایل PST را به یک فایل PST واحد ترکیب کند. هر دو عملیات تقسیم و ترکیب PST می‌توانند با افزودن رویدادها به این عملیات ردیابی شوند.

امتحان کنید!

ادغام و ترکیب چندین فایل ایمیل به‌صورت آنلاین با نسخهٔ رایگان اپلیکیشن ادغام Aspose.Email.

تقسیم فایل‌های PST

تقسیم به چند PST

کد زیر نشان می‌دهد چگونه یک فایل ذخیره‌سازی را به چند فایل تقسیم کنید:

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

تقسیم بر اساس معیار مشخص

کد زیر نشان می‌دهد چگونه یک فایل ذخیره‌سازی را بر اساس معیاری مشخص تقسیم کنید:

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 واحد

کد زیر نشان می‌دهد چگونه چندین فایل ذخیره‌سازی را به یک فایل واحد ترکیب کنید:

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

اضافه کردن MapiCalendar به PST

«Create a New PST File and Add Subfolders» نشان داد چگونه یک فایل PST ایجاد کنید و یک زیرپوشه به آن اضافه کنید. با Aspose.Email می‌توانید MapiCalendar را به زیرپوشهٔ Calendar یک فایل PST که ساخته یا بارگذاری کرده‌اید اضافه کنید. مراحل افزودن MapiCalendar به یک PST به شرح زیر است:

یک شیء MapiCalendar ایجاد کنید.
ویژگی‌های MapiCalendar را با استفاده از سازنده و متدها تنظیم کنید.
یک PST را با استفاده از متد PersonalStorage.create() ایجاد کنید.
یک پوشه پیش‌تعریف‌شده (Calendar) را در ریشهٔ فایل PST با دسترسی به پوشهٔ ریشه و سپس فراخوانی متد add_mapi_message_item() ایجاد کنید.

کد زیر نشان می‌دهد چگونه یک MapiCalendar ایجاد کنید و سپس آن را به پوشهٔ تقویم یک فایل PST جدید اضافه کنید.

ذخیره موارد تقویم از PST به دیسک در فرمت ICS

این مقاله نشان می‌دهد چگونه به موارد تقویم از یک فایل PST اوتلوک دسترسی پیدا کنید و تقویم را در فرمت ICS روی دیسک ذخیره کنید. برای دریافت اطلاعات تقویم از کلاس‌های PersonalStorage و MapiCalendar استفاده کنید. مراحل ذخیرهٔ موارد تقویم به شرح زیر است:

فایل PST را در کلاس PersonalStorage بارگذاری کنید.
مرور پوشه Calendar.
محتویات پوشه Calendar را دریافت کنید تا مجموعه پیام‌ها را به دست آورید.
حلقه‌زدن در مجموعه پیام‌ها.
متد PersonalStorage.extract_message() را صدا بزنید تا اطلاعات تماس را در کلاس MapiCalendar دریافت کنید.
متد MapiCalendar.save() را صدا بزنید تا مورد تقویم را در فرمت ICS روی دیسک ذخیره کنید.

برنامه زیر یک فایل PST را از دیسک بارگذاری می‌کند و تمام موارد تقویم را در فرمت ICS ذخیره می‌سازد. سپس می‌توانید فایل‌های ICS را در هر برنامه‌ای که می‌تواند فایل تقویم استاندارد ICS را بارگذاری کند، استفاده کنید. زمانی که یک فایل ICS در Microsoft Outlook باز می‌شود، مشابه تصویر زیر خواهد بود.

|| | :- | کد زیر نشان می‌دهد چگونه موارد تقویم را از 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)

ویرایش/حذف رخدادها از تکرارها

با استفاده از API Aspose.Email برای .NET می‌توان استثناهایی را به تکرارهای موجود اضافه کرد. نمونه کد زیر استفاده از این ویژگی را نشان می‌دهد.

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

افزودن رویدادهای تقویم به فایل‌های 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

این مقاله توضیح می‌دهد چگونه به موارد تقویم از یک فایل PST Outlook دسترسی پیدا کنید و آنها را به دیسک در فرمت 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)

تعديل یا حذف موارد تکرار در فایل‌های 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

افزودن مخاطب به 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

این مقاله توضیح می‌دهد چگونه به اطلاعات تماس از یک فایل PST مایکروسافت اوتلوک دسترسی پیدا کنید و تماس را در قالب MSG روی دیسک ذخیره کنید. برای دریافت و نمایش اطلاعات تماس از کلاس‌های PersonalStorage و MapiContact استفاده می‌شود. مراحل دریافت اطلاعات تماس به شرح زیر است:

فایل PST را در کلاس PersonalStorage بارگذاری کنید.
مرور پوشه Contacts.
دریافت محتویات پوشه Contacts برای به دست آوردن مجموعه پیام‌ها.
حلقه‌زدن در مجموعه پیام‌ها.
متد PersonalStorage.extract_message() را صدا بزنید تا اطلاعات تماس را در کلاس MapiMessage دریافت کنید.
متد MapiMessage.save() را صدا بزنید تا تماس را در قالب MSG روی دیسک ذخیره کنید.

کد زیر نشان می‌دهد چگونه تمام اطلاعات تماس را از فایل PST بازیابی کنید و در قالب MSG روی دیسک ذخیره کنید.

ذخیره اطلاعات تماس‌ها از فایل PST در قالب VCF

این مقاله نشان می‌دهد چگونه به اطلاعات تماس از یک فایل PST مایکروسافت اوتلوک دسترسی پیدا کنید و تماس را در قالب vCard (VCF) روی دیسک ذخیره کنید. برای دریافت اطلاعات تماس از فایل PST از کلاس‌های PersonalStorage و MapiContact استفاده کنید. برای دریافت اطلاعات تماس:

فایل 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)

کار با لیست‌های توزیع

امکان ایجاد فهرست توزیع با استفاده از API Aspose.Email وجود دارد که مجموعه‌ای از چندین مخاطب است. یک فهرست توزیع می‌تواند در قالب MSG اوتلوک بر روی دیسک ذخیره شود و با باز کردن آن در مایکروسافت اوتلوک قابل مشاهده/دستکاری باشد.

ایجاد و ذخیره لیست توزیع

کد نمونه زیر نشان می‌دهد چگونه یک لیست توزیعی ایجاد و ذخیره کنید.

خواندن لیست توزیعی از 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: مدیریت مخاطبان 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

برای دسترسی به اطلاعات مخاطب از یک فایل PST Outlook و ذخیره آن بر روی دیسک در قالب MSG، Aspose.Email فراهم می‌کند PersonalStorage و MapiContact کلاس‌ها. کد زیر نشان می‌دهد چگونه تمام اطلاعات مخاطب را از یک فایل PST بازیابی کرده و در قالب MSG بر روی دیسک ذخیره کنید:

بارگذاری فایل PST در PersonalStorage کلاس.
مرور پوشه Contacts.
دریافت محتویات پوشه Contacts برای به دست آوردن مجموعه پیام‌ها.
حلقه‌زدن در مجموعه پیام‌ها.
متد را فراخوانی کنید PersonalStorage.extract_message() متد برای دریافت اطلاعات مخاطب در MapiMessage کلاس.
متد را فراخوانی کنید MapiMessage.save() متد برای ذخیره مخاطب در دیسک با فرمت MSG.

صدور مخاطبین Outlook به عنوان فایل‌های VCF

برای دسترسی به اطلاعات مخاطب از یک فایل PST Microsoft Outlook و ذخیره‌سازی آن در دیسک به فرمت 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 ذخیره کنید.
نام و شناسه ورودی هر مخاطب را چاپ کنید.
ذخیره مخاطب به‌عنوان فایل 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

API Aspose.Email برای Python امکان ایجاد فهرست توزیع - مجموعه‌ای از چندین مخاطب - را فراهم می‌کند. فهرست توزیع می‌تواند در دیسک با فرمت MSG Outlook ذخیره شده و با باز کردن آن در MS Outlook مشاهده/ویرایش شود.

ایجاد و ذخیرهٔ فهرست توزیع

کد زیر نشان می‌دهد چگونه یک فایل PST ایجاد کرده و فهرست توزیع اضافه کنید. همچنین شامل ایجاد و افزودن مخاطبین به فهرست توزیع داخل فایل PST است.

تعریف جزئیات مخاطب - تنظیم displayName و ایمیل برای هر مخاطب.
یک فایل PST جدید ایجاد کنید با استفاده از PersonalStorage.create() با فرمت یونیکد.
ایجاد پوشه 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()

به‌روزرسانی فهرست توزیع در فایل‌های PST 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 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: کار با MapiJournal در PST

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

افزودن MapiJournal به PST

«Create a New PST File and Add Subfolders» نشان داد چگونه یک فایل PST ایجاد کنید و یک زیرپوشه به آن اضافه کنید. با Aspose.Email می‌توانید MapiJournal را به زیرپوشهٔ Journal یک فایل PST که ساخته یا بارگذاری کرده‌اید اضافه کنید. مراحل افزودن MapiJournal به PST به صورت زیر است:

یک شیء MapiJournal ایجاد کنید
ویژگی‌های MapiJournal را با استفاده از سازنده و متدها تنظیم کنید.
یک PST را با استفاده از متد PersonalStorage.create() ایجاد کنید.
یک پوشه پیش‌تعریف‌شده (Journals) را در ریشهٔ فایل PST با دسترسی به پوشهٔ ریشه و سپس فراخوانی متد add_mapi_message_item() ایجاد کنید.

کد زیر نشان می‌دهد چگونه یک MapiJournal ایجاد کنید و سپس آن را به پوشهٔ ژورنال یک فایل 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 به فایل‌های PST

ایجاد یک فایل PST جدید و افزودن زیرپوشه‌ها نحوه ایجاد یک فایل PST جدید و افزودن یک زیرپوشه به آن را نشان می‌دهد. با Aspose.Email می‌توانید یک ورودی ژورنال MAPI جدید ایجاد کنید و آن را به یک فایل PST اضافه کنید. نمونه کد زیر نشان می‌دهد چگونه یک ورودی ژورنال ایجاد کنید، ویژگی‌های آن را تنظیم کنید و در یک فایل PST تازه‌ساخته ذخیره کنید:

Create MAPI Journal Entry: یک نمونه از MapiJournal شیء با موضوع، بدنه و نوع.
Set Journal Timing: زمان شروع ورودی ژورنال را به‌عنوان تاریخ و زمان جاری تنظیم کنید با استفاده از dt.datetime.now() و زمان پایان را یک ساعت بعد تنظیم کنید با استفاده از dt.datetime.today() + timedelta(hours=1).
Create PST File: استفاده کنید PersonalStorage.create برای تولید یک فایل PST جدید با فرمت یونیکد.
Create Journal Folder: در فایل PST جدید، یک پوشه پیش‌تعریف‌شده به نام "Journal" ایجاد کنید با استفاده از create_predefined_folder با StandardIpmFolder.JOURNAL پارامتر.
Add Journal Entry to Folder: ورودی ژورنال MAPI که قبلاً ایجاد شده را با استفاده از به پوشه "Journal" اضافه کنید add_mapi_message_item.

افزودن پیوست‌ها به ورودی‌های ژورنال MAPI در فایل‌های PST

نمونه کد زیر نشان می‌دهد چگونه یک مورد ژورنال MAPI را با استفاده از کتابخانه Aspose.Email ایجاد و ذخیره کنید. ورودی ژورنال مرتبط با یک تماس تلفنی است و شامل فایل‌های پیوست می‌شود.

تعریف پوشه و پیوست‌ها:
- data_dir: متغیری که مسیر پوشه داده‌ها را که فایل‌ها و خروجی‌ها در آن ذخیره می‌شوند نگه می‌دارد.
- attach_file_names: فهرستی شامل مسیرهای کامل فایل‌های پیوست که به ژورنال اضافه می‌شوند.
ایجاد یک شیء MapiJournal:
- A MapiJournal یک شیء با عنوان "testJournal" ایجاد می‌شود. این ورودی ژورنال در هر دو فیلد موضوع و نوع به عنوان "Phone call" توصیف می‌شود.
- journal.start_time با استفاده از به زمان فعلی تنظیم می‌شود. datetime.now().
- journal.end_time با افزودن یک ساعت به زمان شروع با استفاده از محاسبه می‌شود. timedelta(hours=1).
تنظیم شرکت‌های مشارکت‌کننده:
- این journal.companies صفت با فهرستی از شرکت‌های مشارکت‌کننده در این ورودی ژورنال به‌روز می‌شود.
پیوست‌کردن فایل‌ها به ژورنال:
- یک حلقه بر روی هر فایل در 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: کار با MapiNote در PST

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

اضافه کردن MapiNote به PST

«Create a New PST File and Add Subfolders» نشان داد چگونه یک فایل 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: مدیریت یادداشت‌های 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 مشخص کردن فرمت یونیکد.
در داخل فایل PST، یک پوشه پیش‌تعریف‌شده به نام "Tasks" برای ذخیره‌سازی یادداشت‌ها ایجاد می‌شود.
هر یک از یادداشت‌های MAPI (note1، note2، و note3) با استفاده از به notesFolder اضافه می‌شوند add_mapi_message_item روش. این فرآیند یادداشت‌ها را در ساختار PST برای ذخیره‌سازی ادغام می‌کند.

Python-Net: تبدیل OLM به PST

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

تبدیل OLM به PST

OLM (Outlook for Mac) فرمت فایلی است که توسط Microsoft Outlook برای مک استفاده می‌شود تا پیام‌های ایمیل، مخاطبین، تقویم‌ها، وظایف و سایر داده‌ها را ذخیره کند. این فرمت بومی Outlook برای مک است، بنابراین امکان باز کردن فایل OLM در Outlook برای ویندوز وجود ندارد. برای کار با فایل‌های OLM در ویندوز، Aspose Email ابزارهایی مخصوص برای پردازش فایل‌های OLM ارائه می‌دهد. رویکرد این ابزارها تبدیل فایل‌های OLM به فرمت PST (Outlook Data File) است که به‌صورت گسترده‌ای در محیط‌های ویندوز پشتیبانی می‌شود. پس از تبدیل به فرمت PST، می‌توانید داده‌ها را به Outlook برای ویندوز یا هر کلاینت ایمیل سازگار دیگری وارد کنید.

رویکرد اصلی

نمونه کد زیر نشان می‌دهد چگونه یک فایل OLM Outlook را با استفاده از کتابخانه Aspose.Email به فایل PST تبدیل کنید. این کد هر پوشه و پیام‌های مربوطه را از فایل 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/OST خراب

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

خواندن فایل‌های PST/OST خراب

در برخی موارد، فایل PST یا OST ممکن است به دلیل خرابی یا آسیب قابل دسترسی نباشد. در این وضعیت، Outlook ممکن است نتواند فایل را باز کند و بازیابی ایمیل‌های مهم و سایر داده‌های صندوق‌پست دشوار می‌شود.

Aspose.Email یک API فراهم می‌کند که به شما اجازه می‌دهد با استفاده از شناسه‌های پیام و پوشه، پیام‌های سالم را از یک فایل PST خراب اسکن و استخراج کنید.

متدهای زیر از PersonalStorage کلاس‌ها برای بازیابی داده‌ها از یک فایل PST خراب ضروری هستند:

دریافت شناسه‌های پیام و پوشه:

find_messages(parent_entry_id) - فهرستی از شناسه‌های پیام‌ها را در یک پوشهٔ مشخص بازیابی می‌کند.

find_subfolders(parent_entry_id) - فهرستی از شناسه‌های زیرپوشه‌ها را در یک پوشهٔ مشخص به‌دست می‌آورد.
دسترسی به پیام‌ها و پوشه‌ها با استفاده از شناسه‌هایشان:

extract_message(entry_id) - یک پیام را از فایل PST با استفاده از شناسهٔ ورودی آن استخراج می‌کند.

get_folder_by_id(entry_id) - یک پوشه را از فایل PST با استفاده از شناسهٔ ورودی آن بازیابی می‌کند.

نمونه کد زیر نشان می‌دهد چگونه در یک فایل 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: کار با 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

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

برای بروز رسانی فهرست توزیع در یک فایل 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: مدیریت فهرست توزیع Outlook در فایل‌های PST

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

API Aspose.Email برای Python به کاربران امکان ایجاد، مدیریت و دستکاری فهرست‌های توزیع را می‌دهد. این شامل ایجاد و ذخیرهٔ اعضا از فهرست، خواندن فهرست‌های توزیع، به‌روزرسانی ویژگی‌های فهرست و سایر عملیات مرتبط است.

ایجاد و ذخیره فهرست‌های توزیع در فایل‌های PST

اضافه کردن فهرست توزیع با مخاطبین موجود در PST

قطعه کد زیر نشان می‌دهد چگونه فهرست توزیعی شامل مخاطبینی که از قبل در فایل PST ذخیره شده‌اند، ایجاد شود.

یک فایل PST جدید ایجاد کنید با استفاده از PersonalStorage.create() با فرمت یونیکد.
یک پوشه‌ی پیش‌تعریف‌شده "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() با فرمت یونیکد.
به‌جای لینک‌کردن مخاطبین از PST، ورودی‌های مخاطب جدید (John R. Patrick و Tilly Bates) را مستقیماً به‌عنوان اعضای یک‌بار مصرف تعریف کنید.
اعضای یک‌بار مصرف را به فهرست توزیع اضافه کنید.
یک فهرست توزیع بنام "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}")

به‌روزرسانی فهرست توزیع در فایل‌های PST 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: مدیریت کارهای MAPI Outlook در فایل‌های PST

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

اضافه کردن کارهای MAPI Outlook به فایل‌های 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: کار با پیام‌ها در یک فایل PST

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

افزودن پیام‌ها به فایل‌های PST Outlook

افزودن یک پیام تک به فایل PST

ایجاد یک فایل PST جدید و افزودن زیرپوشه‌ها نشان می‌دهد چگونه یک فایل PST ایجاد و زیرپوشه‌ای به آن اضافه کنید. با Aspose.Email می‌توانید پیام‌ها را به زیرپوشه‌های یک فایل PST که ایجاد یا بارگذاری کرده‌اید نیز اضافه کنید. نمونه کد زیر نشان می‌دهد چگونه یک فایل PST جدید ایجاد، پوشه "Inbox" اضافه و سپس یک پیام را به آن پوشه اضافه کنید. این PersonalStorage و FolderInfo کلاس‌ها برای انجام این کار استفاده می‌شوند.

از PersonalStorage.create روشی برای ایجاد یک فایل PST جدید با مشخص‌کردن مسیر فایل و نسخه فرمت فایل به‌صورت یونیکود.
یک پوشه جدید با نام "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

در خواندن فایل‌های 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() کلاس MessageStore کلاس. این کلاس راهی راحت برای جمع‌آوری سریع اطلاعات در مورد حجم و مقدار داده‌های داخل مخزن فراهم می‌کند. نمونه کد زیر نشان می‌دهد چگونه تعداد کل آیتم‌ها را از یک فایل 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

فایل‌های ذخیره‌سازی شخصی (PST) می‌توانند حجم زیادی از داده‌ها را شامل شوند و برای یافتن داده‌های مطابق با معیارهای خاص نیاز به فیلترهای متعدد دارند. با PersonalStorageQueryBuilder کلاس، Aspose.Email به شما امکان می‌دهد رکوردهای خاصی را در یک PST بر اساس معیارهای تعریف‌شده جستجو کنید. می‌توانید پیام‌ها را با استفاده از پارامترهایی مانند ارسال‌کننده، گیرنده، موضوع، اهمیت پیام، وجود پیوست‌ها، حجم پیام و حتی شناسه پیام جستجو کنید. علاوه بر این، 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 overload به شما امکان می‌دهد پیام‌های نوع خاصی مانند فقط ایمیل‌ها، قرار ملاقات‌ها یا مخاطبین را دریافت کنید. نمونه کد زیر نشان می‌دهد چگونه به پیام‌های نوع خاص از یک پوشه معین دسترسی پیدا کرده و آنها را فیلتر کنید:

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)

به‌روزرسانی و سازماندهی محتوای PST اوتلوک

انتقال پیام‌ها بین پوشه‌ها

Aspose.Email امکان انتقال آیتم‌ها از یک پوشه منبع به پوشه دیگری در همان فایل ذخیره‌سازی شخصی (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()

حذف پیام‌ها و پوشه‌ها از فایل‌های PST اوتلوک

مدیریت محتوای فایل‌های 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

فایل‌های PST اوتلوک ممکن است پوشه‌هایی داشته باشند که دیگر نیازی به آن‌ها نیست. Aspose.Email برای Python از طریق .NET امکان حذف این پوشه‌ها را با انتقال به پوشه Deleted Items (قابل بازیابی) یا حذف دائم آن‌ها فراهم می‌کند. مثال‌های زیر هر دو رویکرد را نشان می‌دهند.

انتقال یک پوشه به Deleted Items (حذف نرم)

این move_item متد از PersonalStorage کلاس اجازه می‌دهد پوشه‌ها بعدها بازیابی شوند، زیرا به‌صورت دائم حذف نمی‌شوند بلکه به پوشه Deleted Items منتقل می‌شوند. قطعه کد زیر نشان می‌دهد چگونه این متد را در یک پروژه پایتون پیاده‌سازی کنید:

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 از MessageStore کلاسی همان‌طور که در نمونه کد زیر نشان داده شده است:

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) را ارائه می‌دهد از MessageStore کلاس. این متد رشتهٔ رمز عبور را به‌عنوان پارامتر می‌گیرد و اگر رمز صحیح باشد 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) از MessageStore کلاسی که برای مدیریت رمزهای عبور در فایل‌های 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: خواندن فایل OLM اوتلوک برای مک و دریافت اطلاعات پوشه‌ها و زیرپوشه‌ها

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

OLM (Outlook for Mac Archive) یک فرمت فایل است که با Microsoft Outlook برای مک مرتبط است. از آن برای بایگانی و ذخیره‌سازی پیام‌های ایمیل، مخاطبین، موارد تقویم، وظایف و سایر داده‌های Outlook بر روی کامپیوترهای مک استفاده می‌شود. فایل‌های OLM به‌عنوان فرمت پشتیبان یا بایگانی عمل می‌کنند و به کاربران اجازه می‌دهند داده‌های Outlook برای مک خود را برای مراجعهٔ آینده یا مهاجرت ذخیره کنند. لازم به ذکر است که فایل‌های OLM مختص Outlook برای مک هستند و با فرمت PST (Personal Storage Table) که در Outlook ویندوز استفاده می‌شود، سازگار نیستند. اگر نیاز به انتقال داده‌های Outlook بین پلتفرم‌های مختلف دارید، ابزارهای تبدیل مفید خواهند بود. Aspose.Email چنین ابزارهایی را شامل باز کردن، خواندن و سایر قابلیت‌ها برای کار با فایل‌های OLM ارائه می‌دهد.

باز کردن فایل‌های فرمت OLM

فایل‌های فرمت OLM می‌توانند به دو روش باز شوند:

استفاده از سازنده
با استفاده از متد استاتیک ‘from_file’

باز کردن فایل‌ها با سازنده

برای باز کردن یک فایل، سازندهٔ OlmStorage کلاس و نام کامل فایل یا جریان را به عنوان آرگومان به آن پاس دهید:

import aspose.email as ae

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

باز کردن فایل‌ها با استفاده از متد استاتیک FromFile

برای باز کردن یک فایل، از متد استاتیک ‘from_file’ در OlmStorage کلاس و نام کامل فایل یا جریان را به عنوان آرگومان به آن پاس دهید:

import aspose.email as ae

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

دریافت پوشه‌ها

می‌توانید با استفاده از تابع ‘print_all_folders’ ساختار درختی پوشه‌های استخراج‌شده از یک فایل OLM را به‌صورت بصری نشان دهید. این تابع ویژگی ‘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}")

دریافت یا تنظیم تاریخ تغییر یک پیام

می‌توانید اطلاعات درباره زمان آخرین تغییر پیام ایمیل را بازیابی کنید. ویژگی ‘modified_date’ از OlmMessageInfo کلاس تاریخ و زمانی که پیام به‌آخرین بار تغییر یافته است را نشان می‌دهد.

در اینجا نمونه‌ای که استفاده از این ویژگی را نشان می‌دهد:

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

می‌توانید تمام آیتم‌ها را از یک فایل OLM در Outlook تا حد امکان استخراج کنید، بدون پرتاب استثناها، حتی اگر برخی داده‌های فایل اصلی خراب باشند. برای انجام این کار، از OlmStorage(TraversalExceptionsCallback callback) سازنده و Load(string fileName) متد به‌جای متد FromFile استفاده می‌شود. سازنده امکان تعریف یک متد کال‌بک را فراهم می‌کند.

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

متد کال‌بک، استثنای‌های بارگذاری و مرور را در دسترس قرار می‌دهد.

این Load متد در صورتی که فایل با موفقیت بارگذاری شده باشد و ادامه مرور ممکن باشد، ’true’ برمی‌گرداند. اگر فایل خراب باشد و مرور امکان‌پذیر نباشد، ‘false’ برگردانده می‌شود.

if (olm.Load(fileName))

کد نمونه زیر و مراحل، نشان می‌دهند چطور از این API استفاده کنید:

یک نمونهٔ جدید از OlmStorage کلاس، به‌همراه یک کال‌بک برای مدیریت استثناها تا هر استثنای رخ‌داده در طول فرآیند را مدیریت کند.
فایل OLM را با فراخوانی Load متد نمونه OlmStorage بدست آورید.
اگر فایل OLM با موفقیت بارگذاری شد، ساختار سلسله‌مراتبی پوشه‌ها را با فراخوانی GetFolders متد روی نمونه OlmStorage. این متد لیستی از اشیاء OlmFolder را برمی‌گرداند.
متد ExtractItems را فراخوانی کنید و نمونه OlmStorage و لیست اشیاء OlmFolder را به‌عنوان پارامترها پاس دهید.
در متد ExtractItems، بر هر پوشه در لیست پوشه‌ها پیمایش کنید.
اگر پوشه شامل پیام‌ها (ایمیل‌ها) باشد، نام پوشه را با استفاده از 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)

دریافت مسیر پوشه

شما همچنین می‌توانید مسیر سلسله‌مراتبی یا مکان پوشه داخل فایل 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 امکان شمارش کل پیام‌های ایمیل موجود در پوشه خاص یک فایل 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()

بازیابی رنگ‌های دسته‌بندی اوتلوک

با Aspose.Email، می‌توانید به‌راحتی رنگ‌های دسته‌بندی مرتبط با دسته‌های آیتم اوتلوک که در فایل‌های 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 در برنامه‌های پایتون

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

باز کردن فایل‌های OLM Outlook

فایل‌های فرمت OLM می‌توانند به دو روش باز شوند:

استفاده از سازنده
با استفاده از متد استاتیک ‘from_file’

باز کردن فایل‌های OLM Outlook با استفاده از سازنده‌های پایتون

برای باز کردن یک فایل، سازندهٔ OlmStorage کلاس و نام کامل فایل یا جریان را به عنوان آرگومان به آن پاس دهید:

import aspose.email as ae

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

باز کردن فایل‌های OLM با استفاده از متد ثابت FromFile پایتون

import aspose.email as ae

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

مدیریت پوشه و ایمیل در فایل‌های OLM

دسترسی بازگشتی به ساختار پوشه‌ها

API Aspose.Email به شما امکان می‌دهد ساختار درختی پوشه‌های استخراج‌شده از یک فایل OLM را با استفاده از تابع print_all_folders به‌صورت بصری نمایش دهید. این تابع ویژگی 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)

فهرست ایمیل‌ها از فایل‌های OLM Outlook

کتابخانه Aspose.Email می‌تواند برای خواندن و استخراج پیام‌های ایمیل از فایل‌های Outlook for Mac (OLM) استفاده شود. می‌توانید لیست ایمیل‌ها را با استفاده از متدهای زیر در OlmFolder کلاسی که یک پوشه را نمایان می‌کند:

enumerate_messages() - بر هر پیام ایمیل در پوشه پیمایش می‌کند. این متد پیام‌ها را به‌صورت نمونه‌هایی از OlmMessageInfo کلاس که اطلاعات پایه‌ای درباره هر پیام ایمیل مانند موضوع، فرستنده، تاریخ و غیره را فراهم می‌کند.
enumerate_mapi_messages() - همچنین بر هر پیام ایمیل در یک پوشه پیمایش می‌کند، اما در این حالت پیام‌ها را به‌صورت نمونه‌هایی از MapiMessage کلاسی که پیام ایمیل را به‌صورت جزئی‌تر و خاص MAPI نشان می‌دهد. دسترسی به مجموعه گسترده‌ای از ویژگی‌ها و جزئیات پیام ایمیل را فراهم می‌کند و امکان پردازش پیشرفته‌تر و تخصصی را می‌دهد.

کدهای نمونه زیر نشان می‌دهند چگونه موضوعات پایه ایمیل‌ها را استخراج کرده و پیام‌های ایمیل جزئی را از یک فایل OLM Outlook ذخیره کنید، با استفاده از 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}")

دریافت یا تنظیم تاریخ‌های تغییر برای پیام‌های OLM Outlook

Aspose.Email امکان دریافت اطلاعات درباره زمان آخرین تغییر یک پیام ایمیل را فراهم می‌کند. ویژگی modified_date در OlmMessageInfo کلاس تاریخ و زمانی که پیام به‌آخرین بار تغییر یافته است را نشان می‌دهد.

در اینجا نمونه‌ای که استفاده از این ویژگی را نشان می‌دهد:

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

استخراج ایمیل‌ها از فایل‌های OLM Outlook

می‌توانید داده‌های واقعی پیام 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، می‌توانید از ویژگی 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

دریافت مسیرهای پوشه در فایل‌های OLM Outlook

Aspose.Email به شما اجازه می‌دهد مسیر یا مکان سلسله‌مراتبی پوشه داخل فایل OLM Outlook را بدست آورید. API ویژگی 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)

شمارش آیتم‌ها در پوشه‌های OLM Outlook

Aspose.Email امکان شمارش کل پیام‌های ایمیل موجود در پوشه خاصی از یک فایل OLM Outlook را فراهم می‌کند. ویژگی 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)

دریافت تعداد کل آیتم‌ها در فایل‌های OLM Outlook

متد 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، می‌توانید به‌راحتی رنگ‌های دسته‌بندی مرتبط با دسته‌های آیتم اوتلوک که در فایل‌های 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}")