Documentation – کار با آیتم‌های Outlook

Python-Net: ایجاد و ذخیرهٔ فایل‌های MSG

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

Aspose.Email از ایجاد فایل‌های پیام Outlook (MSG) پشتیبانی می‌کند. این مقاله توضیح می‌دهد چگونه:

ایجاد پیام‌های MSG.
ایجاد پیام‌های MSG با پیوست‌ها.
یک پیام MSG با بدنه RTF ایجاد کنید.
ذخیرهٔ پیام به‌عنوان پیش‌نویس.
کار با فشرده‌سازی بدنه.

ایجاد و ذخیرهٔ پیام‌های Outlook

کلاس MailMessage دارای متد Save() است که می‌تواند فایل‌های MSG آوتلوک را بر روی دیسک یا به صورت استریم ذخیره کند. قطعات کد زیر یک نمونه از کلاس MailMessage ایجاد می‌کنند و ویژگی‌هایی مانند from، to، subject و body را تنظیم می‌نمایند. متد Save() نام فایل را به عنوان آرگومان می‌گیرد. علاوه بر این، پیام‌های آوتلوک می‌توانند با بدنه RTF فشرده با استفاده از MapiConversionOptions ایجاد شوند. برای راه‌اندازی، یک برنامه جدید ویندوز ایجاد کنید و یک مرجع به کتابخانه Aspose.Email.dll به پروژه اضافه کنید.

یک نمونه جدید از کلاس MailMessage ایجاد کنید و ویژگی‌های From، To، Subject و Body را تنظیم کنید.
متد FromMailMessage کلاس MailMessage را فراخوانی کنید که یک شیء از نوع MailMessage را می‌پذیرد. متد FromMailMessage()، MailMessage را به MailMessage (MSG) تبدیل می‌کند.
متد MapiMessage.Save() را فراخوانی کنید تا فایل MSG ذخیره شود.

کد زیر را در رویداد کلیک کنترل دکمه برنامه ویندوز بنویسید.

ایجاد فایل‌های MSG با پیوست‌ها

در مثال بالا، یک فایل MSG ساده ایجاد کردیم. Aspose.Email همچنین از ذخیره‌سازی فایل‌های پیام با پیوست‌ها پشتیبانی می‌کند. تنها کاری که باید انجام دهید این است که پیوست‌ها را به نمونه MailMessage اضافه کنید. با فراخوانی متد Add() روی مجموعه MailMessage.Attachments پیوست‌ها را اضافه کنید. یک لیست‌باکس به فرم ایجاد شده در بالا اضافه کنید و دو دکمه برای افزودن و حذف پیوست‌ها قرار دهید. برنامه‌ای که پیوست‌ها را اضافه می‌کند به این صورت عمل می‌کند:

زمانی که دکمه Add Attachment کلیک می‌شود، یک Open File Dialog نمایش داده می‌شود تا به کاربران در مرور و انتخاب پیوست کمک کند.
وقتی فایلی انتخاب شد، مسیر کامل آن به یک لیست اضافه می‌شود.
زمانی که فایل MSG ایجاد می‌شود، مسیرهای پیوست‌ها از لیست استخراج شده و به مجموعه MailMessage.Attachments اضافه می‌شوند.

کد زیر را در رویداد کلیک دکمه Add Attachment بنویسید.

کد افزودن پیوست‌ها به نمونه MailMessage را اضافه کنید. کد نهایی برای تابع Write Msg به صورت زیر نوشته شده است.

ایجاد فایل‌های MSG با بدنهٔ RTF

شما می‌توانید با Aspose.Email فایل‌های پیام Outlook (MSG) با بدنه متن غنی (RTF) ایجاد کنید. بدنه RTF از قالب‌بندی متن پشتیبانی می‌کند. با تنظیم ویژگی MailMessage.HtmlBody یک مورد ایجاد کنید. وقتی یک نمونه MailMessage را به یک نمونه MailMessage دیگر تبدیل می‌کنید، بدنه HTML به RTF تبدیل می‌شود. به این ترتیب، قالب‌بندی بدنه ایمیل حفظ می‌شود.

مثال زیر یک فایل MSG با بدنه RTF ایجاد می‌کند. یک سرعنوان وجود دارد که قالب‌بندی بولد و زیرخط در بدنه HTML اعمال شده است. این قالب‌بندی هنگام تبدیل HTML به RTF حفظ می‌شود.

ذخیرهٔ پیام در وضعیت پیش‌نویس

ایمیل‌ها به‌ عنوان پیش‌نویس ذخیره می‌شوند وقتی کسی شروع به ویرایش آن‌ها کرده اما می‌خواهد برای تکمیل later به آن‌ها برگردد. Aspose.Email از ذخیره‌سازی پیام‌های ایمیل در وضعیت پیش‌نویس با تنظیم پرچم پیام پشتیبانی می‌کند. در زیر نمونه کدی برای ذخیره یک پیام ایمیل Outlook (MSG) به‌ عنوان پیش‌نویس آمده است.

پیامدهای فشرده‌سازی بدنه

روش فشرده‌سازی بدنه RTF می‌تواند برای تولید MSG با اندازه کوچکتر استفاده شود. اما این باعث کاهش سرعت می‌شود. برای ایجاد پیام‌ها با سرعت بهتر، پرچم را روی false تنظیم کنید. این پرچم به نوبه خود بر PSTهای ایجاد شده تأثیر دارد: فایل‌های MSG کوچکتر منجر به PST‌های کوچکتر می‌شوند و فایل‌های MSG بزرگ باعث ایجاد PST با سرعت کمتر می‌شوند.

Python-Net: بارگذاری، مشاهده و تجزیه فایل MSG

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

این موضوع توضیح می‌دهد چگونه یک فایل پیام Microsoft Outlook (*.msg) را بارگذاری کنید. این MapiMessage کلاس برای بارگذاری فایل‌های MSG استفاده می‌شود و چندین تابع بارگذاری استاتیک برای سناریوهای مختلف فراهم می‌کند. قطعه کد زیر نشان می‌دهد چگونه فایل‌های MSG را از فایل یا از جریان (stream) بارگذاری کنید.

امتحان کنید!

فایل‌های ایمیل را به‌صورت آنلاین با رایگان Aspose.Email Parser App.

بارگذاری فایل‌های MSG

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

from aspose.email.mapi import MapiMessage

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

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

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

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

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

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

بارگذاری از جریان

قطعه کد زیر نشان می‌دهد چگونه فایل را از جریان (stream) بارگذاری کنید.

from aspose.email.mapi import MapiMessage
import io

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

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

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

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

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

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

تبدیل EML به MSG با حفظ قالب EML توکار

فایل‌های EML می‌توانند به داخل … بارگذاری شوند MapiMessage کلاس با ایجاد یک MailMessage شیء را گرفته و به متد MapiMessage.from_mail_message پاس می‌دهد. اگر فایل EML شامل فایل‌های EML توکار باشد، از MapiConversionOptions.PreserveEmbeddedMessageFormat برای حفظ قالب فایل‌های EML توکار استفاده کنید. قطعه کد زیر نشان می‌دهد چگونه فایل‌های EML را به MapiMessage بارگذاری کنید در حالی که قالب فایل‌های EML توکار حفظ می‌شود.

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

eml_file = dir_path + "message.eml"

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

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

# Preserve Embedded Message Format
conversion_options.preserve_embedded_message_format = True

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

Python-Net: مدیریت فایل‌های پیام با Aspose.Email.Outlook

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

تعیین نوع آیتم MAPI در پوشه PST

فایل PST معمولاً انواع مختلف داده‌ها مانند پیام‌های ایمیل، رویدادهای تقویم، مخاطبان و غیره را شامل می‌شود. MapiItemType کلاس Aspose.Email به شما امکان می‌دهد انواع مختلفی از موارد MAPI را در یک فایل PST دسترسی و دسته‌بندی کنید. کد زیر نشان می‌دهد چگونه نوع یک مورد MAPI در یک پوشه PST را تعیین کنید:

import aspose.email as ae

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

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

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

تبدیل MSG به پیام MIME

API Aspose.Email امکان تبدیل فایل MSG به پیام MIME را با استفاده از متد ToMailMessage فراهم می‌کند.

تنظیم زمان‌انقضا برای تبدیل و بارگذاری یک پیام

برای محدود کردن زمان تبدیل پیام به میلی‌ثانیه (مقدار پیش‌فرض ۳ ثانیه)، ویژگی timeout از MailConversionOptions کلاس استفاده می‌شود.

در اینجا نحوه تنظیم زمان‌انتظار برای فرایندهای تبدیل و بارگذاری پیام آورده شده است:

import aspose.email as ae

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

با تنظیم زمان‌انتظار (timeout) برای فرایندهای تبدیل پیام و بارگذاری، می‌توانید حداکثر زمان مجاز برای اجرای این عملیات‌ها را کنترل کنید. پس از تنظیم زمان‌انتظار، می‌توانید به فرایندهای تبدیل و بارگذاری پیام خود ادامه دهید.

پردازش فایل‌های قالب Outlook (OFT)

بارگذاری، ویرایش و ذخیره یک فایل OFT

قالب‌های Outlook (OFT) روشی مناسب برای ساده‌سازی فرآیند ارسال پیام‌های ایمیل تکراری ارائه می‌دهند. به‌جای نوشتن هر بار یک ایمیل مشابه، می‌توانید یک پیام در Outlook ایجاد کرده و به‌عنوان قالب Outlook (OFT) ذخیره کنید. سپس هر زمان که نیاز به ارسال پیام مشابه داشتید، می‌توانید به‌سرعت از قالب تولید کنید. این روش از بازنویسی مکرر محتوا، موضوع، قالب‌بندی و غیره جلوگیری می‌کند.

Aspose.Email MailMessage کلاس ابزار قدرتمندی برای بارگذاری و دستکاری فایل‌های قالب Outlook (OFT) فراهم می‌کند. پس از بارگذاری یک قالب Outlook در یک نمونه از کلاس MailMessage، می‌توانید به راحتی ویژگی‌هایی مانند فرستنده، گیرنده، بدنه پیام، موضوع و سایر ویژگی‌ها را به‌روز کنید.

import aspose.email as ae

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

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

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

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

بعد از اعمال به‌روزرسانی‌های لازم، می‌توانید ایمیل را با استفاده از SmtpClient کلاس:

# Send the email
smtpClient.send(message)

ذخیره فایل MSG آوتلوک به‌عنوان قالب

برای این منظور، می‌توانید از MailMessage کلاس برای ایجاد یک ایمیل، سپس ذخیره آن به‌عنوان فایل OFT. نمونه کد زیر نشان می‌دهد چگونه یک ایمیل را به قالب Outlook ذخیره کنید:

import aspose.email as ae

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

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

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

OFT یا MSG: تعیین نوع یک MapiMessage

قطعه کد زیر نشان می‌دهد چگونه تعیین کنیم آیا یک پیام MAPI بارگذاری شده نمایانگر یک ایمیل استاندارد است یا یک قالب Outlook (OFT):

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

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

پس از بارگذاری فایل MSG، کد بررسی می‌کند آیا ویژگی is_template از MapiMessaage کلاس True یا False است. اگر false برگرداند، پیام بارگذاری‌شده یک پیام ایمیل استاندارد است، نه یک قالب Outlook؛ در غیر این صورت، اگر true برگرداند، پیام یک قالب Outlook است نه یک ایمیل استاندارد.

ذخیره MapiMessage یا MailMessage به‌عنوان OFT

این SaveOptions یک کلاس پایهٔ انتزاعی برای کلاس‌هایی است که به کاربر امکان می‌دهد گزینه‌های اضافی را هنگام ذخیره MailMessage به یک فرمت خاص مشخص کند. نمونه کد زیر نشان می‌دهد چگونه یک پیام را به فرمت OFT ذخیره کنید:

import aspose.email as ae

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

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

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

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

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

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

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

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

مدیریت پیام‌ها با امضای دیجیتال

کتابخانه ارائه می‌دهد LoadOptions کلاس، یک کلاس پایهٔ انتزاعی برای کلاس‌هایی که به کاربر اجازه می‌دهد گزینه‌های اضافی را هنگام بارگذاری MailMessage از یک فرمت خاص مشخص کند. گزینهٔ حفظ امضا به‌طور پیش‌فرض تنظیم شده است.

تبدیل از EML به MSG با حفظ امضا

نمونه کد زیر نشان می‌دهد چگونه پیامی را بارگذاری کنید، به فرمت MSG تبدیل کرده و به عنوان MSG ذخیره کنید (امضا به‌صورت پیش‌فرض حفظ می‌شود):


import aspose.email as ae

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

تبدیل پیام‌های S/MIME از MSG به EML

Aspose.Email به شما امکان تبدیل از MSG به EML را با حفظ امضای دیجیتال همان‌طور که در قطعه کد زیر نشان داده شده، می‌دهد.

import aspose.email as ae

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

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

تنظیم دسته‌بندی رنگ برای فایل‌های Outlook MSG

گاهی ممکن است نیاز داشته باشید ایمیل‌های دارای اهمیتی خاص را متمایز کنید و به‌صورت بصری سازماندهی کنید. این کتابخانه روشی برای این کار فراهم می‌کند که با اختصاص یک رنگ خاص به آیتم پیام. وقتی یک دسته‌بندی رنگ برای یک آیتم تنظیم می‌شود، به راحتی می‌توانید آیتم‌های مرتبط را در یک نگاه شناسایی کنید. استفاده کنید FollowUpManager کلاس برای تنظیم دسته‌بندی رنگی یک پیام همان‌طور که در مثال کد زیر آمده است:


import aspose.email as ae

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

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

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

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

دسترسی به اطلاعات Follow Up از فایل MSG

استخراج اطلاعات خواندن و رسید تحویل

نمونه کد زیر نشان می‌دهد چگونه اطلاعات گیرندگان و وضعیت ردیابی آن‌ها را از یک پیام Outlook (MSG) استخراج کنید:

import aspose.email as ae

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

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

ایجاد پیام‌های Forward و Reply

Aspose.Email روش‌های ساده‌ای برای ایجاد پیام‌های فوروارد و پاسخ بر پایه پیام‌های موجود فراهم می‌کند.

ایجاد پیام Forward

می‌توانید از ForwardMessageBuilder کلاس برای ایجاد یک پیام فوروارد با تنظیم پیام منبع، فرستنده، گیرندگان، موضوع و بدنه استفاده می‌شود. پیام‌های فوروارد می‌توانند پیام اصلی را به‌عنوان پیوست یا به‌عنوان بدنهٔ پیام فوروارد شامل کنند. شما انعطاف‌پذیری سفارشی‌سازی ویژگی‌های اضافی مانند پیوست‌ها، سرصفحه‌ها و گزینه‌های قالب‌بندی را دارید. نمونه کد زیر نشان می‌دهد چگونه یک پیام فوروارد ایجاد کنید:


import aspose.email as ae

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

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

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

ایجاد پیام پاسخ

این ReplyMessageBuilder کلاس برای پیکربندی تنظیمات پاسخ استفاده می‌شود، شامل پیام مبدا، فرستنده، گیرندگان، حالت پاسخ، پیشوند موضوع و بدنه پیام پاسخ. پیام‌های پاسخ می‌توانند در حالت‌های مختلفی مانند «پاسخ به فرستنده» یا «پاسخ به همه» بسته به نیاز شما ایجاد شوند. می‌توانید ویژگی‌های مختلفی مانند پیوست‌ها، سرصفحه‌ها و گزینه‌های قالب‌بندی را برای پیام پاسخ سفارشی کنید. نمونه کد زیر نحوه ایجاد یک پیام فوروارد را نشان می‌دهد:

import aspose.email as ae

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

builder = ae.tools.ReplyMessageBuilder()

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

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

Python-Net: کار با لیست‌های توزیعی

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

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

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

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

خواندن لیست توزیعی از PST

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

import aspose.email as ae

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

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

Python-Net: کار با پیگیری و تاریخ مهلت برای فایل‌های MSG Outlook

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

یک پرچم پیگیری یک پیام ایمیل را برای انجام نوعی اقدام علامت‌گذاری می‌کند. Microsoft Outlook به کاربران امکان می‌دهد پیام‌ها را پرچم بزنند و در تنظیم پرچم، تاریخ موعدی برای پیگیری تعیین کنند. Outlook یادآوری به دریافت‌کننده می‌فرستد تا او را به پیگیری ایمیل تحریک کند. پرچم زدن ایمیل‌ها و تنظیم تاریخ‌های موعد به‌صورت برنامه‌نویسی به توسعه‌دهندگان امکان خودکارسازی برخی انواع ایمیل‌ها و کمک به دریافت‌کنندگان برای یادآوری اقدام می‌دهد. به‌عنوان مثال، می‌تواند برای ارسال پیام‌های ماهانه به تیم فروش جهت یادآوری تکمیل گزارش‌ها استفاده شود؛ یا برای ارسال پیام به تمام کارمندان جهت یادآوری جلسه شرکت. Aspose.Email برای .NET از تنظیم پرچم پیگیری و تاریخ موعد برای اشیاء MapiMessage با استفاده از FollowUpManager و FollowUpOptions پشتیبانی می‌کند. چندین نوع مختلف برای تنظیم پرچم پیگیری روی پیام وجود دارد که همه در نمونه کد زیر استفاده شده‌اند:

تنظیم یک پرچم پیگیری برای پیام
افزودن تاریخ سررسید و تاریخ یادآوری به پیام
افزودن پرچم به پیام گیرنده.
علامت‌گذاری به‌عنوان تکمیل‌شده.
حذف پرچم.
خواندن گزینه‌های پیگیری.

تنظیم پرچم پیگیری

قطعه کد زیر نشان می‌دهد چگونه یک پرچم followUp تنظیم کنید.

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

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

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

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

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

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

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

تنظیم پیگیری برای گیرندگان

قطعه کد زیر نشان می‌دهد چگونه برای دریافت‌کنندگان پیگیری (follow Up) تنظیم کنید.

import aspose.email as ae
from datetime import datetime

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

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

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

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

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

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

علامت‌گذاری پرچم پیگیری به‌عنوان تکمیل شده

قطعه کد زیر نشان می‌دهد چگونه پرچم followUp را به عنوان تکمیل‌شده علامت‌گذاری کنید.

import aspose.email as ae

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

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

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

حذف پرچم پیگیری

قطعه کد زیر نشان می‌دهد چگونه پرچم followUp را حذف کنید.

import aspose.email as ae

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

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

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

خواندن گزینه‌های پرچم پیگیری برای یک پیام

قطعه کد زیر نشان می‌دهد چگونه گزینه‌های پرچم پیگیری (followup) را برای یک پیام بخوانید.

import aspose.email as ae

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

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

Python-Net: کار با ویژگی‌های MAPI

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

دسترسی و تنظیم ویژگی MAPI در Outlook

کلاس MapiProperty نمایانگر یک ویژگی MAPI است که شامل موارد زیر می‌شود:

نام: یک رشته که نام ویژگی را نشان می‌دهد.
Tag: یک مقدار طولانی که برچسب ویژگی را نشان می‌دهد.
داده: یک آرایه بایت که داده‌های ویژگی را نشان می‌دهد.

دریافت ویژگی MAPI با استفاده از برچسب ویژگی MAPI

برای دریافت ویژگی‌های MAPI:

یک نمونه از MapiMessage را با بارگذاری از فایل‌ها یا جریان (stream) ایجاد کنید.
ویژگی MapiProperty را از MapiMessage.Properties با کلیدهای MapiPropertyTag دریافت کنید.
داده‌های MapiProperty را با متد GetX دریافت کنید.

قطعه کد زیر نشان می‌دهد چگونه ویژگی MAPI را با استفاده از برچسب ویژگی MAPI دریافت کنید.

تنظیم ویژگی‌های MAPI

قطعه کد زیر نشان می‌دهد چگونه ویژگی‌های MAPI را تنظیم کنید.

که تعریف متد convertDateTime به شرح زیر است:

خواندن خصوصیات نام‌گذاری شده MAPI از فایل‌های MSG آوتلوک

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

خواندن خصوصیات نام‌گذاری شده MAPI از فایل MSG

برای خواندن خصوصیات نام‌گذاری شده MAPI، می‌توانیم از ویژگی named_properties استفاده کنیم MapiMessage کلاس. نمونه کد زیر نشان می‌دهد چگونه پیامی را بارگذاری کنید، تمام ویژگی‌های MAPI نام‌گذاری شده را بازیابی کنید و بر هر ویژگی برای بررسی مقدار آن پیمایش کنید:

import aspose.email as ae

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

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

خواندن ویژگی MAPI نام‌گذاری‌شده از پیوست

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

import aspose.email as ae

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

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

حذف ویژگی‌ها از MSGها و پیوست‌ها

این نمونه کد ایجاد یک پیام Outlook MSG با محتوای بدنه و یک فایل پیام پیوست‌شده را نشان می‌دهد. همچنین نحوه حذف ویژگی پیوست از پیام ایجادشده را به نمایش می‌گذارد.

import aspose.email as ae

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

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

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

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

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

Python-Net: کار با پیوست‌های پیام

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

مدیریت پیوست‌ها با Aspose Outlook

ایجاد و ذخیره فایل‌های پیام Outlook (MSG) توضیح می‌دهد چگونه پیام‌ها را ایجاد و ذخیره کنیم و همچنین چگونه فایل‌های MSG با پیوست‌ها را بسازیم. این مقاله نشان می‌دهد چگونه پیوست‌های Microsoft Outlook را با Aspose.Email مدیریت کنیم. پیوست‌های یک فایل پیام با استفاده از ویژگی Attachments کلاس MapiMessage دسترسی پیدا می‌کنند و روی دیسک ذخیره می‌شوند. ویژگی Attachments یک مجموعه از نوع کلاس MapiAttachmentCollection است.

بررسی اینکه پیوست Inline است یا Regular

"Inline" و "Regular" به نوع شامل شدن پیوست در پیام ایمیل اشاره دارند. پیوست‌های Regular فایل‌هایی هستند که به‌صورت سنتی پیوست می‌شوند. معمولاً در لیستی در کلاینت ایمیل نمایش داده می‌شوند و دریافت‌کننده می‌تواند آن‌ها را دانلود و ذخیره کند. پیوست‌های Inline، که به‌عنوان تصاویر توکار یا تصاویر درون‌متن نیز شناخته می‌شوند، معمولاً برای درج تصاویر یا رسانه‌های دیگر در بدنه ایمیل استفاده می‌شوند. آن‌ها در یک لیست جداگانه نمایش داده نمی‌شوند بلکه مستقیماً در محتوای ایمیل، همانند بدنه ایمیل، نشان داده می‌شوند. این امکان را می‌دهد تا تصاویر یا رسانه‌های دیگری که بخشی از محتوای پیام هستند را درج کنید. نمونه کد زیر نشان می‌دهد چگونه تعیین کنید آیا یک پیوست به صورت in‑line است یا regular:

import aspose.email as ae

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

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

ذخیره پیوست‌ها از فایل پیام Outlook (MSG)

برای ذخیره پیوست‌ها از یک فایل MSG:

در مجموعه MapiAttachmentCollection تکرار کنید و پیوست‌های تک تک را دریافت کنید.
برای ذخیره پیوست‌ها، متد Save() کلاس MapiAttachment را فراخوانی کنید.

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

import aspose.email as ae

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

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

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

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

پیوست‌های OLE توکار نیز در مجموعه Attachment کلاس MapiMessage ظاهر می‌شوند. مثال کد زیر یک فایل پیام را برای پیوست‌های پیام توکار تجزیه می‌کند و روی دیسک ذخیره می‌نماید. متد استاتیک FromProperties() کلاس MapiMessage می‌تواند پیام جدیدی از پیوست توکار ایجاد کند. قطعه کد زیر نشان می‌دهد چگونه پیوست‌های پیام ایمیل تو در تو را دریافت کنید.

import aspose.email as ae

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

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

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

حذف پیوست‌ها

کتابخانه Aspose Outlook امکان حذف پیوست‌ها از فایل‌های پیام Microsoft Outlook (.msg) را فراهم می‌کند:

متد RemoveAttachments() را فراخوانی کنید. این متد مسیر فایل پیام را به‌ عنوان پارامتر می‌گیرد. به عنوان یک متد عمومی استاتیک پیاده‌سازی شده است، بنابراین نیازی به ساخت نمونه شیء ندارید.

قطعه کد زیر نشان می‌دهد چگونه پیوست‌ها را حذف کنید.

import aspose.email as ae

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

شما همچنین می‌توانید متد استاتیک DestoryAttachment() از کلاس MapiMessage را فراخوانی کنید. این متد سریع‌تر از RemoveAttachment() عمل می‌کند زیرا متد RemoveAttachment() فایل پیام را تجزیه می‌کند.

import aspose.email as ae

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

اضافه کردن پیوست‌های MSG

یک پیام Outlook می‌تواند پیام‌های دیگر Microsoft Outlook را به‌عنوان پیوست، چه به‌صورت عادی و چه به‌صورت توکار، شامل شود. MapiAttachmentCollection اعضای بارگذاری‌شده‌ی متد Add را برای ایجاد پیام‌های Outlook با هر دو نوع پیوست فراهم می‌کند.

امتحان کنید!

پیوست‌های ایمیل را به‌صورت آنلاین با نسخه رایگان اضافه یا حذف کنید. Aspose.Email Editor App.

اضافه کردن پیوست مرجع به یک MapiMessage

"Reference attachment" معمولاً به پیوستی اشاره دارد که شامل یک مرجع یا لینک به یک منبع خارجی است، نه خود فایل. این مرجع‌ها اغلب در ایمیل‌های HTML برای لینک دادن به تصاویر یا منابع میزبانی شده بر روی سرورهای خارجی استفاده می‌شوند. به‌جای جاسازی کل فایل، یک پیوست مرجع شامل یک URL یا مرجع به محتوای خارجی است.

Aspose.Email مجموعه‌ای از ابزارها برای نمایش صحیح پیوست‌های مرجع ارائه می‌دهد که در نمونه کد زیر نشان داده شده است:

import aspose.email as ae

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

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

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

جایگذاری یک پیام به‌عنوان پیوست

قطعه کد زیر نشان می‌دهد که فایل‌های MSG Outlook که در یک فایل MSG توکار هستند، دارای PR_ATTACH_METHOD با مقدار 5 می‌باشند.

import aspose.email as ae

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

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

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

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

خواندن پیام‌های توکار از پیوست‌ها

قطعه کد زیر نشان می‌دهد چگونه پیام توکار را از پیوست بخوانید.

import aspose.email as ae

file_name = "path/to/file.msg"

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

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

درج و جایگزینی پیوست‌ها

API Aspose.Email امکان افزودن پیوست‌ها در اندیس خاصی از پیام والد را فراهم می‌کند. همچنین امکان تعویض محتوای یک پیوست با پیوست پیام دیگر را می‌دهد. قطعه کد زیر نشان می‌دهد نحوه درج و جایگزینی پیوست‌ها.

درج در مکان خاص

API Aspose.Email امکان افزودن یک پیوست MSG به یک MSG والد را با استفاده از متد Insert از MapiAttachmentCollection فراهم می‌کند: MapiAttachmentCollection Insert(int index, string name, MapiMessage msg). قطعه کد زیر نشان می‌دهد چگونه در مکان مشخصی درج کنید.

import aspose.email as ae
from io import BytesIO

file_name = "path/to/file.msg"

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

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

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

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

جایگزین کردن محتوای پیوست

این می‌تواند برای جایگزینی محتوای پیوست‌های توکار با موارد جدید با استفاده از متد Replace مورد استفاده قرار گیرد. اما نمی‌توان از آن برای افزودن پیوست با PR_ATTACH_NUM = 4 (به عنوان مثال) در مجموعه‌ای که تعداد آن 2 باشد استفاده کرد. قطعه کد زیر نشان می‌دهد چگونه محتوای پیوست را جایگزین کنید.

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

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

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

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

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

تغییر نام یک پیوست در MapiMessage

امکان تغییر نام‌های نمایش پیوست‌ها در پیام‌های ایمیل که از یک فایل بارگذاری شده‌اند وجود دارد. نمونه کد زیر نشان می‌دهد چگونه این کار را انجام دهید:

import aspose.email as ae

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

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

Python-Net: کار با موارد تقویم Outlook

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

کار با MapiCalendar

کلاس MapiCalendar از Aspose.Email متدها و خصوصیات برای تنظیم ویژگی‌های مختلف یک آیتم تقویم را فراهم می‌کند.

ایجاد و ذخیره آیتم‌های تقویم

کد نمونهٔ زیر نشان می‌دهد چگونه می‌توانید یک مورد تقویم را در قالب ICS ایجاد و ذخیره کنید.

import aspose.email as ae
from datetime import datetime

data_dir = "path/to/data/directory"

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

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

ذخیره آیتم تقویم به‌عنوان MSG

کد نمونهٔ زیر نشان می‌دهد چگونه می‌توانید مورد تقویم را به صورت MSG ذخیره کنید.

تنظیم شناسه محصول هنگام ذخیره MapiCalendar به فرمت ICS

کتابخانه Aspose.Email به شما امکان می‌دهد یک MapiCalendar (یک آیتم تقویم) را با گزینه‌های خاص به یک فایل ICS (iCalendar) ذخیره کنید. با ویژگی‌های ics_save_options.keep_original_date_time_stamp و ics_save_options.product_identifier می‌توانید مهر زمان اصلی مرتبط با آیتم تقویم را حفظ کرده و شناسه محصول را در فایل ICS تنظیم کنید، به‌عنوان مثال به "Foo Ltd". شناسه محصول فیلدی است که نرم‌افزار یا سرویس تولیدکننده فایل ICS را شناسایی می‌کند.

در اینجا نمونه کدی آورده شده است که به شما امکان تنظیم شناسه محصول (Product ID) هنگام ذخیره MapiCalendar به فرمت ICS را می‌دهد:

import aspose.email as ae

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

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

دریافت تعداد کل رویدادها

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

import aspose.email as ae

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

اضافه کردن یادآوری نمایش به تقویم

کد نمونهٔ زیر نشان می‌دهد چگونه می‌توانید یک یادآوری نمایش به تقویم اضافه کنید.

اضافه کردن یادآوری صوتی به تقویم

قطعه کد زیر نشان می‌دهد چگونه یک یادآور صوتی به تقویم اضافه کنید.

افزودن/بازیابی پیوست‌ها از فایل‌های تقویم

ماژول تقویم Aspose.Email ("ae.calendar") همچنین امکان افزودن و استخراج اطلاعات پیوست را فراهم می‌کند.

برای افزودن پیوست به قرار ملاقات، یک شیء "Attachment" ایجاد می‌شود که مسیر فایل را می‌دهد. سپس این پیوست به فهرست پیوست‌های قرار ملاقات اضافه می‌شود. قرار ملاقات با استفاده از ذخیره متد و قالب فایل مناسب.
برای بازیابی پیوست‌ها از یک قرار ملاقات، ابتدا با استفاده از بارگذاری متد، تعداد پیوست‌های موجود در "appointment2" را نمایش می‌دهد و با تکرار بر روی پیوست‌ها، نام آنها چاپ می‌شود.

قطعه کد زیر نشان می‌دهد چگونه قرار ملاقات‌ها را همراه با پیوست‌ها ایجاد کنید، آن‌ها را ذخیره کنید و اطلاعات پیوست‌ها را با استفاده از ماژول "ae.calendar" بازیابی کنید. این کد قابلیت‌ها و عملکرد کار با قرار ملاقات‌ها و پیوست‌ها در یک برنامه تقویم را برجسته می‌کند.

import aspose.email as ae
import datetime as dt

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

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

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

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

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

وضعیت دریافت‌کنندگان از یک درخواست جلسه

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

تبدیل قرار ملاقات EML به MSG با حفظ بدنه در قالب HTML

Aspose.Email امکان تبدیل قرار ملاقات EML به MSG و حفظ بدنه HTML را می‌دهد. ویژگی "forced_rtf_body_for_appointment" در MapiConversionOptions کلاسی برای دستکاری نوع بدنهٔ قرار ملاقات استفاده می‌شود. وقتی به True تنظیم شود، بدنه به‌صورت پیش‌فرض به فرمت RTF تبدیل می‌شود. برای حفظ بدنه در قالب HTML، باید به False تنظیم شود. نمونه کد زیر نشان می‌دهد چگونه بدنه HTML قرار ملاقات را هنگام تبدیل از EML به MSG حفظ کنید:

import aspose.email as ae

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

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

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

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

msg.save("appointment.msg")

Python-Net: کار با مخاطبان آوتلوک

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

ایجاد، ذخیره و خواندن مخاطبان

مشابه MapiMessage، Aspose.Email به شما امکان ایجاد مخاطبین Outlook را می‌دهد. کلاس MapiContact تمام ویژگی‌های مرتبط با مخاطب را برای ایجاد یک مخاطب Outlook فراهم می‌کند. این مقاله نشان می‌دهد چگونه با استفاده از کلاس MapiContact، یک مخاطب Outlook را ایجاد، ذخیره و بخوانید.

ایجاد و ذخیره مخاطب Outlook

برای ایجاد یک مخاطب و ذخیره آن بر روی دیسک:

یک شیء جدید از کلاس MapiContact ایجاد کنید.
اطلاعات خصوصیات مخاطب را وارد کنید.
داده‌های عکس را اضافه کنید (در صورت وجود).
مخاطب را به صورت فرمت MSG یا VCard ذخیره کنید.

قطعه کد زیر نشان می‌دهد چگونه یک مخاطب Outlook ایجاد و ذخیره کنید.

import aspose.email as ae

data_dir = "path/to/data/directory"

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

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

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

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

ذخیره مخاطب در قالب VCF نسخه 3

برای ذخیرهٔ مخاطب در فرمت VCF نسخه 3، از خصوصیت version استفاده کنید VCardSaveOptions کلاس. یک نمونه جدید از کلاس VCardSaveOptions ایجاد کنید، ویژگی version شیء VCardSaveOptions را به VCardVersion.V30 تنظیم کنید. این کار نسخه vCard را به 3.0 تنظیم می‌کند. سپس متد save کلاس MapiContact را صدا بزنید و نام فایل "contact.vcf" و شیء VCardSaveOptions را به‌عنوان پارامترها پاس کنید. این کار مخاطب را به‌عنوان فایل vCard با نام و گزینه‌های مشخص شده ذخیره می‌کند. قطعه کد زیر نشان می‌دهد چگونه یک مخاطب را در قالب VCF نسخه 3 ذخیره کنید:

import aspose.email as ae

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

خواندن MapiContact

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

بارگذاری مخاطب از MSG

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

بارگذاری مخاطب از VCard

قطعه کد زیر نشان می‌دهد چگونه یک مخاطب را از vCard بارگذاری کنید.

بارگذاری مخاطب از VCard با رمزگذاری مشخص

قطعه کد زیر نشان می‌دهد چگونه یک مخاطب را از vCard با رمزگذاری مشخص بارگذاری کنید.

ذخیره موارد تماس VCard با رمزگذاری مشخص

هنگام ذخیره یک فایل vCard، امکان تعیین رمزگذاری کاراکترهای مورد استفاده برای اطمینان از سازگاری با کاراکترهای غیر ASCII وجود دارد. ویژگی preferred_text_encoding شیء VCardSaveOptions را به "utf-8" تنظیم کنید. قطعه کد زیر نشان می‌دهد چگونه این عملکرد را در پروژه خود پیاده‌سازی کنید:

import aspose.email as ae

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

ذخیره فایل‌های VCard با فیلدهای گسترده

هنگام ذخیره یک فایل vCard، می‌توانید گزینه‌هایی از جمله استفاده از فیلدهای گسترده که ویژگی‌ها یا خصوصیات اضافی هستند و می‌توانند به vCard اضافه شوند، مشخص کنید. ویژگی use_extensions برای VCardSaveOptions کلاس به شما امکان این کار را می‌دهد. قطعه کد زیر نشان می‌دهد چگونه یک فایل VCard با فیلدهای گسترده ذخیره کنید:

import aspose.email as ae

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

خواندن چندین مخاطب در قالب VCard

برای دریافت فهرست تمام مخاطبان از VCard به متدهای زیر نیاز دارید:

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

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

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

قطعه کد زیر فرآیند خواندن چندین مخاطب از یک فایل VCard را نشان می‌دهد:

import aspose.email as ae

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

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

رندر اطلاعات مخاطب به MHTML

مخاطب Outlook می‌تواند با استفاده از API Aspose.Email به MHTML تبدیل شود. این مثال نشان می‌دهد چگونه یک VCard به MapiContact بارگذاری شده و سپس با کمک API MailMessage به MHTML تبدیل می‌شود.

Python-Net: کار با یادداشت‌های Outlook

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

ایجاد، ذخیره و خواندن یادداشت‌ها

Aspose.Email این امکان را فراهم می‌کند تا یادداشت‌های Outlook را ایجاد کرده و به‌صورت فرمت MSG بر روی دیسک ذخیره کنید. کلاس MapiNote ویژگی‌ها و متدهایی برای تنظیم اطلاعات وظیفه ارائه می‌دهد. این مقاله نشان می‌دهد چگونه یک MapiNote را ایجاد، ذخیره و از دیسک بخوانید.

ایجاد و ذخیره یک یادداشت Outlook

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

یک شیء از کلاس MapiNote ایجاد کنید.
تنظیم ویژگی‌های مختلف.
یادداشت را به عنوان یک فایل MSG بر روی دیسک ذخیره کنید.

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

خواندن MapiNote

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

Python-Net: کار با وظایف Outlook

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

ایجاد، ذخیره و خواندن وظایف

Aspose.Email برای .NET به شما امکان می‌دهد وظایف Outlook را ایجاد کرده و در قالب MSG ذخیره کنید. کلاس MapiTask مجموعه‌ای از ویژگی‌ها مانند Percentcomplete، Estimatedeffort، ActualEffort، History، LastUpdate و دیگران را ارائه می‌دهد تا اطلاعات مورد نیاز برای یک وظیفه Outlook را تنظیم کنید. این مقاله نشان می‌دهد چگونه یک MapiTask را روی دیسک ایجاد، ذخیره و بخوانید. برای ایجاد و ذخیره یک وظیفه روی دیسک:

یک شیء جدید از کلاس MapiContact ایجاد کنید.
اطلاعات ویژگی‌های وظیفه را وارد کنید.
وظیفه را در فرمت MSG روی دیسک ذخیره کنید.

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

خواندن یک MapiTask

شیء کلاس MapiContact برای تبدیل شیء MapiMessage که یک وظیفه را از دیسک به فرمت MSG بارگذاری می‌کند، استفاده می‌شود. قطعه کد زیر نشان می‌دهد چگونه یک MapiTask را بخوانید.

خواندن یک وظیفه VToDo

وظایف Google که به صورت iCalendar به عنوان رویدادهای VToDo صادر شده‌اند، می‌توانند با استفاده از کلاس MapiTask همان‌طور که در نمونه کد زیر نشان داده شده، بارگذاری شوند. قطعه کد زیر نشان می‌دهد چگونه یک وظیفه VToDo را بخوانید.

import aspose.email as ae

data_dir = "path/to/data/directory"

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

اضافه کردن اطلاعات یادآوری به یک MapiTask

مشابه Microsoft Outlook، Aspose.Email می‌تواند اطلاعات یادآوری را به یک MapiTask اضافه کند. قطعه کد زیر نشان می‌دهد چگونه اطلاعات یادآوری را به یک MapiTask اضافه کنید.

اضافه کردن پیوست‌ها به یک MapiTask

از Add متد از MapiAttachmentCollection کلاس برای افزودن پیوست به یک MapiTask. نمونه کد زیر به شما کمک خواهد کرد:

import aspose.email as ae
import datetime as dt

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

اضافه کردن تکرار به MapiTask

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

تبدیل یک وظیفه به MHT

نمونه کد زیر نشان می‌دهد چگونه یک وظیفه را به فرمت MHT تبدیل کنید و گزینه‌های اضافی برای فرمت MHT را مشخص کنید زمانی که فیلدهای خاص وظیفه باید رندر شوند (RENDER_TASK_FIELDS) و اطلاعات سرصفحه نیز گنجانده شود (WRITE_HEADER). ویژگی mht_format_options از MhtSaveOptions کلاس برای تعریف گزینه‌های اضافی هنگام ذخیره به فرمت MHTML استفاده می‌شود.

import aspose.email as ae

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

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

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

Python-Net: کار با گزینه رأی‌گیری با استفاده از MapiMessage

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

ایجاد گزینه رأی‌گیری با استفاده از MapiMessage

Microsoft Outlook به کاربران اجازه می‌دهد هنگام ایجاد یک پیام جدید یک نظرسنجی ایجاد کنند. این امکان را می‌دهد تا گزینه‌های رأی‌گیری مانند بله، خیر، شاید و غیره را شامل شوند. Aspose.Email همین قابلیت را هنگام ایجاد یک پیام Outlook جدید فراهم می‌کند. این FollowUpOptions کلاس ویژگی VotingButtons را فراهم می‌کند که می‌تواند برای تنظیم یا دریافت مقدار گزینه‌های رای‌گیری استفاده شود. این مقاله یک مثال دقیق از ایجاد MapiMessage با گزینه‌های رای‌گیری برای ساخت نظرسنجی ارائه می‌دهد.

ایجاد نظرسنجی با استفاده از MapiMessage

نمونه کد زیر نشان می‌دهد چگونه از ویژگی voting_buttons کلاس استفاده کنید. FollowUpOptions کلاسی برای ایجاد نظرسنجی:

import aspose.email as ae

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

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

msg.save("voting_btns.msg")

خواندن گزینه‌های رأی‌گیری از یک MapiMessage

قطعه کد زیر نشان می‌دهد چگونه گزینه‌های رای‌گیری را از یک MapiMessage بخوانید.

خواندن فقط دکمه‌های رأی‌گیری

قطعه کد زیر نشان می‌دهد چگونه فقط دکمه‌های رأی‌گیری را بخوانید.

اضافه کردن دکمه رای‌گیری به یک پیام موجود

قطعه کد زیر نشان می‌دهد چگونه یک دکمه رای‌گیری به یک پیام موجود اضافه کنید.

حذف دکمه رای‌گیری از یک پیام

قطعه کد زیر نشان می‌دهد چگونه دکمه رای‌گیری را از یک پیام حذف کنید.

خواندن اطلاعات نتایج رأی‌گیری

قطعه کد زیر نشان می‌دهد چگونه اطلاعات نتایج رأی‌گیری را بخوانید.

تنظیم پرچم پیام ارسال‌نشده

قطعه کد زیر نشان می‌دهد چگونه روش‌های نمونه استفاده شده در مثال‌ها را اجرا کنید.

import aspose.email as ae

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