Documentation – کار با پیام‌های MIME

Python-Net: ایجاد و مدیریت ایمیل‌ها

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

ایجاد یک پیام ایمیل جدید

این MailMessage کلاس نمایانگر یک پیام ایمیل است و به توسعه‌دهندگان اجازه می‌دهد پیام ایمیل جدیدی ایجاد کنند. ویژگی‌های پایه ایمیل مانند From، To، Subject و body می‌توانند به راحتی به پیام ایمیل جدید اضافه شوند. به طور مشابه می‌توانیم پیام ایمیل را در فرمت‌های مختلفی مانند EML، MSG و MHTML ذخیره کنیم.

یک نمونه از MailMessage کلاس.
ویژگی‌های پیام ایمیل را تنظیم کنید.
پیام ایمیل را در فرمت‌های مختلف ذخیره کنید.

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

مشخص کردن چندین گیرنده

این MailMessage شی نمایانگر یک پیام ایمیل است. نمونه‌های MailMessage کلاس برای ساختن پیام‌های ایمیل که به سرور SMTP منتقل می‌شوند، با استفاده از SmtpClient کلاس. این مقاله نشان می‌دهد چگونه بیش از یک آدرس ایمیل را مشخص کنیم. آدرس‌های ایمیل می‌توانند با استفاده از MailMessage کلاس. آنها عبارتند از:

To - آدرس‌های گیرنده می‌توانند در فیلد ‘To’ مشخص شوند. گیرندگان فیلد ‘To’ مخاطبان اصلی پیام هستند. می‌توان بیش از یک آدرس گیرنده داشت.
Cc - CC مخفف «کپی کربن» یا «کپی Courtesy» است و به شما امکان می‌دهد گیرندگانی را اضافه کنید که نیاز به مشاهده ایمیل دارند اما لزوماً انتظار نمی‌رود اقدام کنند. برای مثال مدیران یا اعضای تیم شما که باید از گفت‌وگو آگاه باشند. با Aspose.Email، می‌توانید آدرس‌های CC را در کد خود مشخص کنید. به این ترتیب، ایمیل‌های خودکار یا تمام ایمیل‌ها به یک آدرس خاص می‌توانند به پرسنل مربوطه کپی شوند.
Bcc - Bcc مخفف کپی سیاه‌رنگ است و به شما اجازه می‌دهد ایمیلی به گیرنده‌ای بفرستید که از سایر گیرندگان پنهان باشد. در حالی که CC در اطلاعات ایمیل برای گیرندگان اصلی ظاهر می‌شود، Bcc نه. این برای اطلاع‌رسانی مخفی استفاده می‌شود.

برای مشخص کردن چندین آدرس ایمیل در یک پیام ایمیل، مراحل زیر را دنبال کنید:

یک نمونه از MailMessage کلاس.
آدرس From و چندین آدرس To، Cc و Bcc را با استفاده از MailMessage نمونه.
یک نمونه از SmtpClient کلاس و ایمیل را با استفاده از متد Send ارسال کنید.

نمونه کد زیر نشان می‌دهد چگونه می‌توان چندین آدرس To، CC و BCC را مشخص کرد.

تنظیم نام‌های نمایشی فرستنده و گیرنده

نمونه‌های برنامه‌نویسی زیر نشان می‌دهند چگونه آدرس‌های ایمیل را به نام‌های دوستانه در یک پیام ایمیل تغییر دهیم. یک نام دوستانه نامی است که نسبت به آدرس ایمیل بیشتر انسانی به‌نظر می‌رسد، برای مثال John Smith به جای js346@domain.com. هنگام ارسال ایمیل، می‌توانیم یک نام دوستانه را به آدرس ایمیل در MailMessage سازنده کلاس.

برای تغییر آدرس‌های ایمیل به نام‌های دوستانه در یک پیام ایمیل، مراحل زیر را دنبال کنید:

یک نمونه از MailMessage کلاس و آدرس‌های ایمیل را در فیلدهای To و From همراه با نام‌های دوستانه مشخص کنید.
آدرس‌های ایمیل Cc و Bcc را به همراه نام‌های دوستانه با فراخوانی MailMessage سازنده کلاس در MailMessage نمونه.
یک نمونه از SmtpClient کلاس و ایمیل را با استفاده از ارسال متد.

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

تنظیم موضوع ایمیل

این MailMessage کلاس به شما اجازه می‌دهد خلاصهٔ مختصری از محتوای پیام را با استفاده از موضوع ویژگی. نمونه کد زیر نشان می‌دهد چگونه یک ایمیل ایجاد و موضوع آن را تنظیم کنید:

from aspose.email import MailMessage

# Create a new email message
message = MailMessage()

# Set the subject of the email
message.subject = "Meeting Reminder: Project Update"

# Set other email properties (optional)
message.from_address = "sender@example.com"
message.to.append("recipient@example.com")
message.body = "This is a reminder for the upcoming project update meeting."

# Print the email details
print(f"Subject: {message.subject}")
print(f"From: {message.from_address}")
print(f"To: {', '.join(message.to)}")
print(f"Body: {message.body}")

تنظیم بدنهٔ ایمیل

علاوه بر موضوع پیام، بدنهٔ ایمیل می‌تواند با همان MailMessage کلاس. یک ایمیل می‌تواند بدنه‌های متعددی داشته باشد. دو نوع بدنهٔ ایمیل در این کلاس وجود دارد:

بدنه HTML
بدنه متن

علاوه بر HtmlBody و TextBody، Aspose.Email دو ویژگی فقط خواندنی دیگر مرتبط با بدنهٔ ایمیل دارد:

IsBodyText: به کاربر می‌گوید آیا بدنه متن است یا خیر.
IsBodyHtml: به کاربر می‌گوید بدنه HTML است یا متن ساده.

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

تنظیم بدنه HTML

بدنه Html برای مشخص کردن محتوای HTML یک پیام استفاده می‌شود. بدنه Html باید بین تگ‌های قرار گیرد. قطعه کد زیر نشان می‌دهد چگونه بدنه HTML را تنظیم کنید.

تنظیم متن جایگزین

از AlternateView کلاس برای مشخص کردن نسخه‌های یک پیام ایمیل در فرمت‌های مختلف. به عنوان مثال، اگر پیامی را به صورت HTML ارسال کنید، ممکن است بخواهید نسخهٔ متن ساده‌ای نیز فراهم کنید تا در صورتی که برخی گیرندگان از برنامه‌های ایمیل استفاده می‌کنند که محتوای HTML را نشان نمی‌دهند، بتوانند بخوانند. این کلاس دو ویژگی دارد، linked_resources و base_uri، که برای حل URLها داخل محتوای ایمیل استفاده می‌شوند.

LinkedResources مجموعه‌ای از اشیاء LinkedResources است. هنگام رندر شدن، URLهای داخل محتوای ایمیل ابتدا با URLهای موجود در Content Link هر شیء LinkedResources در مجموعه LinkedResources مقایسه و حل می‌شوند.
BaseUri توسط خواننده ایمیل برای حل URLهای نسبی داخل بدنه استفاده می‌شود و همچنین برای حل URLهای لینک محتوای نسبی، در مجموعه LinkedResources.

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

ویژگی‌های MailMessage

این MailMessage class محتوای یک پیام ایمیل را نمایش می‌دهد. نمونه‌های MailMessage class برای ساخت یک پیام ایمیل استفاده می‌شود که به سرور SMTP برای تحویل ارسال می‌شود با استفاده از SmtpClient class. این مقاله نشان می‌دهد چگونه از آن استفاده کنید MailMessage ویژگی‌های utility کلاس برای کنترل ویژگی‌های زیر ایمیل:

Date and time - از طریق MailMessage ویژگی class Date که برای دریافت یا تنظیم تاریخ و زمان ایمیل استفاده می‌شود.
اولویت پیام - MailPriority کلاس سطوح اولویت برای ارسال پیام ایمیل را مشخص می‌کند. می‌تواند کم، معمولی یا بالا باشد. اولویت بر سرعت انتقال و تحویل تأثیر می‌گذارد.
حساسیت پیام - MailSensitivity کلاس پنج سطح حساسیت را مشخص می‌کند.
اطلاع تحویل - اطلاعیه‌های تحویل به فرستندگان می‌گویند ایمیل‌های ارسال‌شده به صندوق ورودی دریافت‌کننده تحویل داده شده‌اند.

به طور پیش‌فرض، تاریخ برابر با تاریخ واقعی ارسال پیام است و زمان نیز زمان ارسال را نشان می‌دهد، همان‌طور که در Microsoft Outlook نمایش داده می‌شود. با این حال، زمان واقعی تحویل ایمیل توسط خود سرور SMTP در هدر ایمیل افزوده می‌شود. برای مثال، در زیر یک هدر رایج ایمیل آورده شده است که در آن فیلد Date مقدار Date را تنظیم می‌کند.

import aspose.email as ae
from aspose.email import MailMessage

# Create a new MailMessage instance
message = MailMessage()

# Add SMTP headers to the message
message.headers.add("Received", "from ip-123.56.99.216.dsl-cust.ca.inter.net ([216.99.56.123]) by Aspose.secureserver.net with MailEnable ESMTP; Thu, 22 Feb 2007 13:58:57 -0700")
message.headers.add("Return-Path", "<xyz@oikoscucine.it>")
message.headers.add("Received", "from 195.120.225.20 (HELO mail.oikoscucine.it) by aspose.com with esmtp (:1CYY+<LA*- *1WK@) id Q8,/O/-.N83@7-9M for abc@aspose.com; Thu, 22 Feb 2007 20:58:51 +0300")

# Set email details
message.from_address = "XYZ <xyz@oikoscucine.it>"
message.to.append("abc@aspose.com")
message.subject = "For ABC"
message.date = "Thu, 22 Feb 2007 20:58:51 +0300"
message.message_id = "<01c756c4$41b554d0$6c822ecf@dishonestyinsufferably>"
message.headers.add("MIME-Version", "1.0")
message.headers.add("Content-Type", "multipart/alternative; boundary=\"----=_NextPart_000_0006_01C7569A.58DF4CD0\"")
message.headers.add("X-Mailer", "Microsoft Office Outlook, Build 11.0.5510")
message.headers.add("X-MimeOLE", "Produced By Microsoft MimeOLE V6.00.2800.1106")
message.headers.add("Thread-Index", "Aca6Q:=ES0M(9-=(<.<1.<Q9@QE6CD==")
message.headers.add("X-Read", "1")

# Save the message as an EML file
message.save("output.eml", ae.EmlSaveOptions())

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

import aspose.email as ae
from aspose.email import MailMessage, MailPriority, MailSensitivity
from datetime import datetime

# Create a new MailMessage instance
message = MailMessage("sender@gmail.com", "receiver@gmail.com", "Some subject", "Some body text")

# Set additional properties
message.date = datetime.now()
message.priority = MailPriority.HIGH
message.sensitivity = MailSensitivity.NORMAL
message.headers.add("X-Mailer", "Aspose.Email")

# Save the message as an EML file
message.save("output.eml", ae.EmlSaveOptions())

درخواست رسید خواندن

نمونه‌های برنامه‌نویسی زیر نشان می‌دهند که چگونه می‌توانید درخواست رسید خواندن کنید. The MailMessage کلاس DeliveryNotificationOptions ویژگی Enumeration گزینه‌های اعلان تحویل ایمیل را توصیف می‌کند. برای درخواست دریافت خوانده شده پس از ارسال ایمیل، مراحل زیر را دنبال کنید:

یک نمونه از MailMessage کلاس.
آدرس فرستنده، گیرنده و بدنه HTML ایمیل را در MailMessage نمونه.
مشخص کنید DeliveryNotificationOptions در سایر MailMessage نمونه‌ها.
یک نمونه از SmtpClient کلاس و ایمیل را با استفاده از متد Send ارسال کنید.

درخواست‌های رسید خواندن ممکن است همیشه رعایت نشوند زیرا:

یک کلاینت ایمیل ممکن است این قابلیت را پیاده‌سازی نکرده باشد.
کاربر نهایی ممکن است این قابلیت را غیرفعال کرده باشد.
کاربر نهایی ممکن است انتخاب کند که ارسال نکند.

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

import aspose.email as ae
from aspose.email import MailMessage, SmtpClient, DeliveryNotificationOptions

# Create an instance of MailMessage class
message = MailMessage()

# Specify From, To, HtmlBody, and DeliveryNotificationOptions
message.from_address = "sender@sender.com"
message.to.append("receiver@receiver.com")
message.html_body = "<html><body>This is the Html body</body></html>"
message.delivery_notification_options = DeliveryNotificationOptions.ON_SUCCESS

message.headers.add("Return-Receipt-To", "sender@sender.com")
message.headers.add("Disposition-Notification-To", "sender@sender.com")

# Create an instance of SmtpClient class
client = SmtpClient()

# Specify your mailing host server, Username, Password, and Port
client.host = "smtp.server.com"
client.username = "Username"
client.password = "Password"
client.port = 25

try:
    # Client.send will send this message
    client.send(message)
    # Display 'Message sent' only if the message is sent successfully
    print("Message sent")
except Exception as ex:
    import traceback
    traceback.print_exc()

تنظیم هدرهای ایمیل

هدرهای ایمیل نمایانگر یک استاندارد اینترنتی هستند و RFC فیلدهای هدر را که در پیام‌های ایمیل اینترنتی گنجانده می‌شوند تعریف می‌کند. هدر ایمیل می‌تواند با استفاده از کلاس MailMessage مشخص شود. انواع هدرهای رایج در کلاس HeaderType تعریف شده‌اند. این کلاس یک کلاس sealed است که مانند یک enumeration معمولی عمل می‌کند.

معمولاً یک هدر ایمیل شامل این فیلدها است:

To: آدرس‌های گیرندگان می‌توانند در فیلد To مشخص شوند. این گیرندگان مخاطبان اصلی پیام هستند. می‌توان بیش از یک آدرس گیرنده داشت.
From: این فیلד آدرس ایمیل فرستنده پیام را نشان می‌دهد.
Cc: به کاربران امکان می‌دهد پیام را به‌صورت "Carbon Copy" یا "Courtesy Copy" ارسال کنند. به‌عبارت دیگر، دریافت‌کننده انتظار پاسخ یا واکنش ندارد. معمولاً پرسنل نظارتی با CC مطلع می‌شوند.
Bcc: مخفف Blind Carbon Copy است و به ارسال پیام به چندین گیرنده به‌طوری که لیست کامل گیرندگان برای آنها قابل مشاهده نباشد، اشاره دارد. برای اطلاع‌رسانی مخفی استفاده می‌شود.
ReplyTo: این فیلد هدر برای نشان دادن مقصدی است که فرستنده می‌خواهد پاسخ‌ها به آن ارسال شوند.
Subject: عنوان، سرخط، موضوع. اغلب به‌ عنوان شاخص رشته (thread) برای پیام‌های پاسخ‌دهی یا نظردهی بر پیام‌های دیگر استفاده می‌شود.
Date: این هدر تاریخ (و زمان) را مشخص می‌کند. به‌طور معمول، این تاریخی است که پیام نوشته و ارسال شده است.
XMailer: اطلاعاتی دربارهٔ نرم‌افزار کلاینت مبدا. مثال: X-Mailer: Aspose.Email. XMailer توسط کلاینت‌های ایمیل استفاده می‌شود. کلاینت‌های ایمیل مختلف مقادیر متفاوتی برای XMailer دارند. مقدار XMailer در MS Outlook برابر است با Microsoft Office Outlook, Build 11.0.5510. این مقدار توسط گیرنده یا مرورگر ایمیل نادیده گرفته می‌شود.

معمولاً، هدر ایمیل به صورت زیر ظاهر می‌شود:


Reply-To: reply@reply.com

From: sender@sender.com

To: guangzhou@guangzhoo.com

Subject: test mail

Date: 6 Mar 2006 8:2:2 +0800

X-Mailer: Aspose.Email

برای سفارشی‌سازی هدر ایمیل، این مراحل را دنبال کنید:

یک نمونه از MailMessage کلاس.
آدرس‌های To، From، CC، Bcc، ReplyTo، Subject، Date و XMailer را با استفاده از یک نمونه از MailMessage.
یک نمونه از MimeHeader کلاس و هدر مخفی را مشخص کنید.
هدر مخفی را به MailMessage نمونه.

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

import aspose.email as ae
from aspose.email import MailMessage
from datetime import datetime

# Create an instance of MailMessage class
message = MailMessage()

# Specify email details
message.reply_to_list.append("reply@reply.com")
message.from_address = "sender@sender.com"
message.to.append("receiver1@receiver.com")
message.cc.append("receiver2@receiver.com")
message.bcc.append("receiver3@receiver.com")
message.subject = "test mail"
message.date = datetime(2006, 3, 6)
message.headers.add("X-Mailer", "Aspose.Email")

قطعه کد بالا هدر ایمیل را در قالب زیر تولید می‌کند. این را می‌توانید با باز کردن فایل حاصل "MsgHeaders.msg" در Microsoft Outlook و سپس مشاهده خصوصیات مشاهده کنید.


Reply-To: reply@reply.com

From: sender@sender.com

To: receiver1@receiver.com

CC: receiver2@receiver.com

BCC: receiver3@receiver.com

Subject: test mail

Date: 6 Mar 2006 8:2:2 +0800

X-Mailer: Aspose.Email

secret-header: mystery

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

این Add متد HeadersCollection کلاس هدر را در انتهای مجموعه درج می‌کند. با این حال، گاهی اوقات لازم است هدر را در موقعیت خاصی درج کنید. در چنین حالتی، Add متد کمک نمی‌کند. برای دستیابی به این هدف، از Insert متد از HeadersCollection. اگر مجموعه هدرهایی با نام یکسان داشته باشد، این هدر قبل از سایر هدرهای با همان نام درج می‌شود.

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

# Insert a header into the MailMessage instance
message.headers.insert("Received", "Value")

افزودن هدرهای سفارشی به ایمیل

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

# Add a header into the MailMessage instance
message.headers.add("secret-header", "mystery")

قطعه کد بالا هدر ایمیل را در قالب زیر تولید می‌کند:

secret-header: mystery

Python-Net: استخراج اطلاعات ایمیل

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

نمایش فراداده ایمیل

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

یک نمونه از MailMessage کلاس.
یک پیام ایمیل را به داخل بارگذاری کنید MailMessage نمونه.
محتوای ایمیل را روی صفحه نمایش دهید.

قطعه کد زیر نشان می‌دهد چگونه اطلاعات ایمیل را روی صفحه نمایش دهید:

استخراج هدرهای ایمیل

هدر ایمیل مجموعه‌ای استاندارد از فیلدهای هدر تعریف‌شده توسط اینترنت و RFC است که در پیام‌های ایمیل گنجانده می‌شوند. هدر ایمیل می‌تواند با استفاده از کلاس MailMessage تعیین شود. انواع هدرهای رایج در HeaderType class. این یک کلاس sealed است که شبیه به enumeration معمولی عمل می‌کند. برای استخراج هدرها از یک ایمیل، مراحل زیر را دنبال کنید:

یک نمونه از MailMessage کلاس.
یک پیام ایمیل را در نمونه‌ی MailMessage کلاس.
پس از بارگذاری پیام ایمیل، محتویات خام آن را دریافت می‌کنیم.

این MailMessage class خود شامل ویژگی‌هایی مانند From، To، Cc، Subject و غیره است. این ویژگی‌ها می‌توانند از هدرها استخراج شوند.

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

رمزگشایی مقادیر هدر

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

Python-Net: بارگذاری، ذخیره‌سازی و تبدیل ایمیل‌ها

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

تشخیص قالب‌های فایل ایمیل

API Aspose.Email قابلیت شناسایی قالب فایل پیام ارائه‌شده را فراهم می‌کند. این DetectFileFormat متد FileFormatUtil کلاس می‌تواند برای این هدف استفاده شود. کلاس‌ها و متدهای زیر می‌توانند برای شناسایی قالب فایل بارگذاری‌شده استفاده شوند:

Enum FileFormatType
کلاس FileFormatInfo
کلاس FileFormatUtil
متد detect_file_format(stream)
متد detect_file_format(file_path)

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

from aspose.email.tools import FileFormatUtil

# Detect file format and get the detected load format
info = FileFormatUtil.detect_file_format(data_dir + "message.msg")
print("The message format is: " + str(info.file_format_type))

بارگذاری پیام با گزینه‌های بارگذاری

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

from aspose.email import MailMessage, EmlLoadOptions, HtmlLoadOptions, MhtmlLoadOptions, MsgLoadOptions

# Load Eml, html, mhtml, msg, and dat files
mail_message = MailMessage.load(data_dir + "message.eml", EmlLoadOptions())
MailMessage.load(data_dir + "description.html", HtmlLoadOptions())
MailMessage.load(data_dir + "message.mhtml", MhtmlLoadOptions())
MailMessage.load(data_dir + "message.msg", MsgLoadOptions())

# Loading with custom options
eml_load_options = EmlLoadOptions()
eml_load_options.preferred_text_encoding = "utf-8"
eml_load_options.preserve_tnef_attachments = True

MailMessage.load(data_dir + "description.html", eml_load_options)

html_load_options = HtmlLoadOptions()
html_load_options.preferred_text_encoding = "utf-8"
html_load_options.should_add_plain_text_view = True
html_load_options.path_to_resources = data_dir

MailMessage.load(data_dir + "description.html", html_load_options)

حفظ قالب پیام توکار هنگام بارگذاری

from aspose.email import MailMessage, EmlLoadOptions, HtmlLoadOptions, MhtmlLoadOptions, MsgLoadOptions
from aspose.email.tools import FileFormatUtil

eml_load_options = EmlLoadOptions()
eml_load_options.preserve_embedded_message_format = True

mail = MailMessage.load(data_dir + "message.eml", eml_load_options)

file_format = FileFormatUtil.detect_file_format(mail.attachments[0].content_stream).file_format_type

print("Embedded message file format: " + str(file_format))

ذخیره و تبدیل ایمیل‌ها

Aspose.Email تبدیل هر نوع پیام به قالب دیگری را آسان می‌کند. برای نشان دادن این ویژگی، کد این مقاله سه نوع پیام را از دیسک بارگذاری کرده و دوباره در قالب‌های دیگر ذخیره می‌کند. کلاس پایه SaveOptions و کلاس‌ها EmlSaveOptions, MsgSaveOptions, MhtSaveOptions, HtmlSaveOptions می‌تواند برای تنظیمات اضافی هنگام ذخیره پیام‌ها به فرمت‌های دیگر استفاده شود. مقاله نشان می‌دهد چگونه از این کلاس‌ها برای ذخیره یک ایمیل نمونه به عنوان:

قالب EML.
Outlook MSG.
قالب MHTML.
قالب HTML.

ذخیره به‌عنوان EML

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

from aspose.email import MailMessage, SaveOptions

# Initialize and Load an existing EML file by specifying the MessageFormat
mail_message = MailMessage.load(data_dir + "message.eml")

mail_message.save(data_dir + "LoadAndSaveFileAsEML_out.eml", SaveOptions.default_eml)

حفظ مرزها در فایل‌های EML

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

from aspose.email import MailMessage, EmlSaveOptions, MailMessageSaveType

mail_message = MailMessage.load(data_dir + "message.eml")

# Save as eml with preserved original boundaries
eml_save_options = EmlSaveOptions(MailMessageSaveType.eml_format)

mail_message.save(data_dir + "PreserveOriginalBoundaries_out.eml", eml_save_options)

سفارشی‌سازی رشته‌های مرز MIME

Aspose.Email برای .NET به شما اجازه می‌دهد قالب مرز استفاده‌شده در پیام‌های MIME را پیکربندی کنید. این کار از طریق boundaries_template ویژگی EmlSaveOptions کلاس.

با تنظیم یک قالب سفارشی، می‌توانید نحوه تولید مرزهای MIME را تعریف کنید. کاراکتر عام {#} در قالب با یک عدد مرز افزایشی جایگزین می‌شود که امکان ایجاد رشته‌های مرز پویا و قابل خواندن را فراهم می‌کند.

اگر boundaries_template تنظیم نشده است (به‌صورت پیش‌فرض None)، کتابخانه از قالب مرز داخلی خود استفاده می‌کند.

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

import aspose.email as ae

# Create a sample MailMessage
message = ae.MailMessage()
message.subject = "Custom MIME Boundary"
message.body = "This message uses a custom MIME boundary template."
message.to.append(ae.MailAddress("recipient@example.com"))

# Configure save options with a custom boundary template
save_options = ae.EmlSaveOptions(ae.MailMessageSaveType.EML_FORMAT)
save_options.boundaries_template = "boundary--{#}"

# Save the message to .eml with custom boundaries
message.save("Custom_Boundary_Message.eml", save_options)

در اینجا یک مثال از ساختار پیام با مرزهای سفارشی که با کد بالا ذخیره شده است، آورده شده است:

From: sender@example.com  
To: recipient@example.com  
Subject: Custom_Boundary_Message  
Date: Fri, 27 Dec 2024 12:00:00 +0000
Content-Type: multipart/mixed;
 boundary="boundary--1"

This is a multi-part message in MIME format.

--boundary--1
Content-Type: multipart/alternative; boundary="boundary--2"


--boundary--2
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: quoted-printable

Content-Type: text/plain; charset="us-ascii"

This is the plain text content of the email.


--boundary--2
Content-Type: text/html; charset="windows-1251"
Content-Transfer-Encoding: quoted-printable

<html>
  <body>
    <p>This is the <b>HTML</b> content of the email.</p>
  </body>
</html>

--boundary--2--

--boundary--1
Content-Type: application/octet-stream; name="report-2023-08.xlsx"
Content-Transfer-Encoding: base64
Content-Disposition: attachment; filename="report-2023-08.xlsx"

UEsDBBQABgAIAAAAIQBi7...

--boundary--1--

حفظ پیوست‌های TNEF در فایل‌های EML

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

from aspose.email import MailMessage, EmlSaveOptions, MailMessageSaveType, FileCompatibilityMode

mail_message = MailMessage.load(data_dir + "message.eml")

# Save as eml with preserved attachment
eml_save_options = EmlSaveOptions(MailMessageSaveType.eml_format)
eml_save_options.file_compatibility_mode = FileCompatibilityMode.PRESERVE_TNEF_ATTACHMENTS

mail_message.save(data_dir + "PreserveTNEFAttachment_out.eml", eml_save_options)

ذخیره به‌عنوان MSG

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

from aspose.email import MailMessage, SaveOptions, MailMessageSaveType, FileCompatibilityMode

# Initialize and Load an existing EML file by specifying the MessageFormat
eml = MailMessage.load(data_dir + "message.eml")

# Save the Email message to disk in ASCII format and Unicode format
eml.save(data_dir + "AnEmail_out.msg", SaveOptions.default_msg_unicode)

حفظ تاریخ‌ها در فایل‌های MSG

این MsgSaveOptions class به شما اجازه می‌دهد پیام منبع را به‌عنوان فایل پیام Outlook (MSG) ذخیره کنید و تاریخ‌ها را حفظ کنید. قطعه کد زیر نشان می‌دهد چگونه یک فایل EML را به عنوان MSG ذخیره کنید و تاریخ‌ها را حفظ کنید.

from aspose.email import MailMessage, MsgSaveOptions, MailMessageSaveType, FileCompatibilityMode

# Initialize and Load an existing EML file by specifying the MessageFormat
eml = MailMessage.load(data_dir + "message.eml")

# Save as msg with preserved dates
msg_save_options = MsgSaveOptions(MailMessageSaveType.outlook_message_format_unicode)
msg_save_options.preserve_original_dates = True

eml.save(data_dir + "outTest_out.msg", msg_save_options)

ذخیره به‌عنوان MHTML

گزینه‌های مختلف MHTML می‌توانند برای دست‌یابی به نتایج مطلوب استفاده شوند. قطعه کد زیر نشان می‌دهد چگونه یک پیام EML را بارگذاری کنید در MailMessage و آن را به MHTML تبدیل کنید.

from aspose.email import MailMessage, SaveOptions, MailMessageSaveType, FileCompatibilityMode

# Initialize and Load an existing EML file by specifying the MessageFormat
eml = MailMessage.load(data_dir + "message.eml")

eml.save(data_dir + "AnEmail_out.mhtml", SaveOptions.default_mhtml)

تنظیمات تبدیل سفارشی MHTML

این MhtSaveOptions کلاسی که گزینه‌های اضافی برای ذخیره پیام‌های ایمیل به قالب MHTML فراهم می‌کند. شمارنده MhtFormatOptions امکان نوشتن اطلاعات ایمیل اضافی به MHTML خروجی را فراهم می‌کند. فیلدهای اضافی زیر می‌توانند نوشته شوند:

NONE - هیچ تنظیم خاصی مشخص نشده است.
WRITE_HEADER - نشان می‌دهد که اطلاعات هدر باید نوشته شود.
WRITE_OUTLINE_ATTACHMENTS - نشان می‌دهد که پیوست‌های outline باید نوشته شوند.
WRITE_COMPLETE_EMAIL_ADDRESS - نشان می‌دهد که آدرس ایمیل کامل باید در تمام هدرهای ایمیل نوشته شود.
NO_ENCODE_CHARACTERS - نشان می‌دهد که هیچ کدگذاری انتقالی برای کاراکترها استفاده نشود.
HIDE_EXTRA_PRINT_HEADER - نشان می‌دهد که PageHeader نامرئی خواهد شد.
WRITE_COMPLETE_TO_EMAIL_ADDRESS - نشان می‌دهد که آدرس ایمیل کامل باید در هدر ‘To’ نوشته شود.
WRITE_COMPLETE_FROM_EMAIL_ADDRESS - نشان می‌دهد که آدرس ایمیل کامل باید در هدر ‘From’ نوشته شود.
WRITE_COMPLETE_CC_EMAIL_ADDRESS - نشان می‌دهد که آدرس ایمیل کامل باید در هدر ‘Cc’ نوشته شود.
WRITE_COMPLETE_BCC_EMAIL_ADDRESS - نشان می‌دهد که آدرس ایمیل کامل باید در هدر ‘Bcc’ نوشته شود.
RENDER_CALENDAR_EVENT - نشان می‌دهد که متن از رویداد تقویم باید در خروجی مhtml نوشته شود.
SKIP_BYTE_ORDER_MARK_IN_BODY - نشان می‌دهد که بایت‌های Byte Order Mark (BOM) باید در بدنه نوشته شوند.
RENDER_V_CARD_INFO - نشان می‌دهد که متن از VCard AlternativeView باید در خروجی mhtml نوشته شود.
DISPLAY_AS_OUTLOOK - نشان می‌دهد که هدر From همان‌طور که در Outlook نمایش داده می‌شود، نمایش داده شود.
RENDER_TASK_FIELDS - نشان می‌دهد که فیلدهای خاص Task باید در خروجی mhtml نوشته شوند.

قطعه کد زیر نشان می‌دهد چگونه یک فایل EML را به MHTML با تنظیمات اختیاری تبدیل کنید.

from aspose.email import MailMessage, MhtSaveOptions, MhtFormatOptions, MailMessageSaveType, FileCompatibilityMode

# Load an existing EML file
eml = MailMessage.load(data_dir + "message.eml")

# Save as mht with header
mht_save_options = MhtSaveOptions()

# Specify formatting options required
# Here we are specifying to write header information to output without writing extra print header
# and the output headers should be displayed as the original headers in the message
mht_save_options.mht_format_options = MhtFormatOptions.WRITE_HEADER | MhtFormatOptions.HIDE_EXTRA_PRINT_HEADER | MhtFormatOptions.DISPLAY_AS_OUTLOOK

# Check the body encoding for validity.
mht_save_options.check_body_content_encoding = True

eml.save(data_dir + "outMessage_out.mht", mht_save_options)

شامل کردن رویدادهای تقویم در تبدیل به MHTML

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

from aspose.email import MailMessage, MhtSaveOptions, MhtFormatOptions, MhtTemplateName, MailMessageSaveType, FileCompatibilityMode

file_name = "message.msg"

# Load the MSG file
msg = MailMessage.load(data_dir + file_name)

# Create MHT save options
options = MhtSaveOptions()
options.mht_format_options = MhtFormatOptions.WRITE_HEADER | MhtFormatOptions.RENDER_CALENDAR_EVENT

# Save the message as MHTML
msg.save(data_dir + "Meeting with Recurring Occurrences.mhtml", options)

صادر کردن ایمیل به MHT بدون تصاویر درون‌خط

from aspose.email import MailMessage, MhtSaveOptions, MhtFormatOptions, MhtTemplateName, MailMessageSaveType, FileCompatibilityMode

# Load the EML file
eml = MailMessage.load(data_dir + "message.eml")

# Create MHT save options
mht_save_options = MhtSaveOptions()
mht_save_options.skip_inline_images = True

# Save the message as MHTML without inline images
eml.save(data_dir + "EmlToMhtmlWithoutInlineImages_out.mht", mht_save_options)

صادر کردن ایمیل به MHT با منطقه زمانی سفارشی

MailMessage کلاس فراهم می‌کند TimeZoneOffset ویژگی برای تنظیم منطقه زمانی سفارشی هنگام صادر کردن به MHT. قطعه کد زیر نشان می‌دهد چگونه ایمیل را به MHT با منطقه زمانی سفارشی صادر کنید:

from aspose.email import MailMessage, MhtSaveOptions, MhtFormatOptions, MhtTemplateName, MailMessageSaveType, FileCompatibilityMode
from datetime import timedelta

# Load the EML file
eml = MailMessage.load(data_dir + "message.eml")

# Set the local time for message date
eml.time_zone_offset = timedelta(hours=-8)

# The dates will be rendered by the local system time zone
mht_save_options = MhtSaveOptions()
mht_save_options.mht_format_options = MhtFormatOptions.WRITE_HEADER
eml.save(data_dir + "ExportEmailToMHTWithCustomTimezone_out.mhtml", mht_save_options)

ذخیره به‌عنوان HTML

این HtmlSaveOptions class به شما اجازه می‌دهد بدنه پیام را به HTML صادر کنید با گزینه ذخیره منابع جاسازی‌شده. قطعه کد زیر نشان می‌دهد چگونه یک پیام را به عنوان HTML ذخیره کنید که در آن مقدار پیش‌فرض embed_resources برابر true است.

from aspose.email import MailMessage, SaveOptions, HtmlSaveOptions, HtmlFormatOptions

# Load the EML file
message = MailMessage.load(data_dir + "message.eml")

# Save the Email message as HTML
message.save(data_dir + "SaveAsHTML_out.html", SaveOptions.default_html)

# OR

eml = MailMessage.load(data_dir + "message.eml")
options = HtmlSaveOptions()
options.embed_resources = False
options.html_format_options = (
    HtmlFormatOptions.WRITE_HEADER
    | HtmlFormatOptions.WRITE_COMPLETE_EMAIL_ADDRESS
)  # save the message headers to output HTML using the formatting options
eml.save(data_dir + "SaveAsHTML1_out.html", options)

ذخیره به‌عنوان قالب Outlook (.OFT)

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

from aspose.email import MailMessage, SaveOptions

eml = MailMessage("test@from.to", "test@to.to", "template subject", "Template body")

oft_eml_file_name = "EmlAsOft_out.oft"
options = SaveOptions.default_msg_unicode
options.save_as_template = True
eml.save(data_dir + oft_eml_file_name, options)

Python-Net: مدیریت پیوست‌ها و اشیاء توکار

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

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

یک پیوست ایمیل یک فایل کامپیوتری است که همراه با یک پیام ایمیل ارسال می‌شود. این فایل می‌تواند به‌عنوان یک پیام جداگانه یا به‌عنوان بخشی از پیام اصلی که به آن پیوست شده است، ارسال شود. این Attachment کلاس برای مدیریت و دستکاری فایل‌های پیوست‌شده در یک پیام ایمیل استفاده می‌شود.

تمام پیام‌ها شامل یک بدنه هستند. علاوه بر بدنه، ممکن است بخواهید فایل‌های اضافی ارسال کنید. این‌ها به‌عنوان پیوست‌ها ارسال می‌شوند و به صورت نمونه‌ای از Attachment کلاس. می‌توانید هر تعداد پیوست ارسال کنید اما اندازه پیوست توسط سرور ایمیل محدود می‌شود. به عنوان مثال Gmail از فایل‌های بزرگتر از 10 مگابایت پشتیبانی نمی‌کند.

امتحان کنید!

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

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

برای پیوست کردن یک فایل به پیام ایمیل، لطفاً مراحل زیر را دنبال کنید:

یک نمونه از MailMessage کلاس.
یک نمونه از Attachment کلاس.
پیوست را در نمونه Attachment بارگذاری کنید.
نمونه Attachment را به داخل MailMessage نمونهٔ کلاس.

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

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

حذف پیوست‌ها

برای حذف یک پیوست، مراحل زیر را دنبال کنید:

یک نمونه از MailMessage کلاس.
یک پیوست را از مسیر فایل مشخص‌شده با استفاده از Attachment کلاس.
پیوست را به MailMessage مجموعه پیوست‌های نمونه.
تعداد پیوست‌ها را قبل از حذف هر چیزی چاپ کنید.
پیوست را از MailMessage مجموعه پیوست‌های نمونه.
تعداد پیوست‌ها را پس از حذف پیوست چاپ کنید.

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

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

برای نمایش نام فایل پیوست، مراحل زیر را دنبال کنید:

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

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

استخراج پیوست‌ها

در Aspose.Email، MailMessage کلاس برای کار با پیوست‌ها استفاده می‌شود. یک پیوست ایمیل یک فایل کامپیوتری است که همراه با یک پیام ایمیل ارسال می‌شود. این فایل می‌تواند به‌عنوان یک پیام جداگانه یا به‌عنوان بخشی از پیام اصلی که به آن پیوست شده است، ارسال شود. فایل به صورت نمونه‌ای از Attachment کلاس. برای استخراج پیوست‌ها از پیام‌های ایمیل، مراحل زیر را دنبال کنید:

یک نمونه از MailMessage کلاس.
یک فایل ایمیل را به MailMessage نمونه.
یک نمونه از Attachment کلاس را استفاده کنید و در یک حلقه تمام پیوست‌ها را استخراج کنید.
پیوست را ذخیره کنید و روی صفحه نمایش دهید.
آدرس فرستنده و گیرنده را در MailMessage نمونه.
حال می‌توانید ایمیل را با استفاده از SmtpClient کلاس.

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

|پیوست‌های استخراج‌شده در ایمیل| | :- | ||

دریافت Content-Description از پیوست‌ها

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

شناسایی پیوست‌های پیام توکار

کار با اشیاء جاسازی‌شده

یک شی توکار، شی‌ای است که با یک برنامه ساخته شده و در یک سند یا فایلی که با برنامهٔ دیگری ایجاد شده، توکار می‌شود. برای مثال، یک صفحه‌گستردهٔ Microsoft Excel می‌تواند داخل یک گزارش Microsoft Word توکار شود، یا یک فایل ویدئویی می‌تواند داخل یک ارائهٔ Microsoft PowerPoint توکار شود. وقتی فایلی توکار می‌شود، به‌جای این که به‌عنوان درج یا چسباندن در سند دیگری قرار بگیرد، قالب اصلی خود را حفظ می‌کند. سند توکار می‌تواند در برنامهٔ اصلی خود باز و ویرایش شود.

استخراج اشیاء جاسازی‌شده

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

یک نمونه از MailMessage کلاس.
یک فایل ایمیل را در نمونه MailMessage بارگذاری کنید.
یک حلقه و یک نمونه از Attachment کلاس در آن.
پیوست را ذخیره کنید و روی صفحه نمایش دهید.
آدرس فرستنده و گیرنده را در نمونه MailMessage مشخص کنید.
ارسال ایمیل با استفاده از SmtpClient کلاس.

|اشیای جاسازی‌شده استخراج‌شده در ایمیل| | :- | ||

Python-Net: مدیریت پیوست‌های TNEF در پیام‌های ایمیل

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

پیام‌های ایمیل حاوی پیوست‌های TNEF

فرمت Transport Neutral Encapsulation Format (TNEF) یک قالب پیوست ایمیل اختصاصی است که توسط Microsoft Outlook و Microsoft Exchange Server استفاده می‌شود. API Aspose.Email به شما امکان می‌دهد پیام‌های ایمیلی که حاوی پیوست‌های TNEF هستند را بخوانید و محتوای آن‌ها را تغییر دهید. سپس ایمیل می‌تواند به عنوان پیام عادی یا به همان فرمت ذخیره شود، به‌طوری که این پیوست‌ها حفظ شوند. این مقاله نمونه‌های کد متفاوتی برای کار با پیام‌های حاوی پیوست‌های TNEF نشان می‌دهد. همچنین نحوه ایجاد فایل‌های TNEF EML از فایل‌های Outlook MSG را نشان می‌دهد.

شناسایی پیوست‌های TNEF در یک ایمیل

قطعه کد زیر نشان می‌دهد چگونه تشخیص دهید که آیا ایمیل شامل پیوست‌های TNEF است یا خیر:

from aspose.email import MailMessage

mail = MailMessage.load(data_dir + "message.eml")
is_tnef = mail.original_is_tnef

خواندن ایمیل‌ها در هنگام حفظ پیوست‌های TNEF

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

from aspose.email import MailMessage, SaveOptions, EmlLoadOptions, MessageFormat, FileCompatibilityMode

options = EmlLoadOptions()
# This will Preserve the TNEF attachment as it is, file contains the TNEF attachment
options.preserve_tnef_attachments = True

eml = MailMessage.load(data_dir + "message.eml", options)
for attachment in eml.attachments:
    print(attachment.name)

تبدیل MSG به TNEF

پیام‌های Outlook MSG گاهی شامل اطلاعاتی مانند جدول‌ها و سبک‌های متن هستند که هنگام تبدیل به EML ممکن است خراب شوند. ایجاد پیام‌های TNEF از چنین فایل‌های MSG به شما امکان می‌دهد قالب‌بندی را حفظ کنید و حتی این پیام‌ها را از طریق کلاینت‌های ایمیل که قالب‌بندی را حفظ می‌کنند، ارسال کنید. The convert_as_tnef ویژگی برای دستیابی به این منظور استفاده می‌شود. قطعه کد زیر نشان می‌دهد چگونه ایمیل TNEF را از MSG ایجاد کنید.

from aspose.email.mapi import MapiMessage, MailConversionOptions, OutlookMessageFormat

mapi_msg = MapiMessage.from_file(data_dir + "message.msg")

mail_conversion_options = MailConversionOptions()
mail_conversion_options.convert_as_tnef = True

message = mapi_msg.to_mail_message(mail_conversion_options)

ایجاد ایمیل TNEF

کد نمونه زیر می‌تواند برای ایجاد ایمیل در قالب TNEF استفاده شود:

گزینه‌های فایل را با استفاده از MsgLoadOptions کلاس.
اطمینان حاصل کنید که پیوست‌های TNEF در ایمیل هنگام بارگذاری فایل حفظ شوند با تنظیم options.preserve_tnef_attachments به True.
از MailMessage.load(eml_file_name, options) متد برای بارگذاری فایل ایمیل ورودی در حالی که گزینه‌های قبلاً پیکربندی‌شده اعمال می‌شود. این به‌طور خاص اطمینان می‌دهد که ایمیل بارگذاری‌شده اطلاعات مرتبط با TNEF (مانند پیوست‌ها یا فرمت‌های اختصاصی Microsoft Outlook) را حفظ می‌کند.

from aspose.email import MailMessage, SaveOptions, MsgLoadOptions, MessageFormat, FileCompatibilityMode

options = MsgLoadOptions()
# The PreserveTnefAttachments option with MessageFormat.Msg will create the TNEF eml.
options.preserve_tnef_attachments = True

eml = MailMessage.load(eml_file_name, options)

تشخیص پیام‌های TNEF

قطعه کد زیر نشان می‌دهد چگونه تشخیص دهید که آیا پیام TNEF است یا خیر. The original_is_tnef ویژگی MailMessage شیء بررسی می‌شود تا تعیین شود آیا ایمیل در ابتدا به صورت TNEF (Transport Neutral Encapsulation Format) بوده است یا خیر. اگر is_tnef اگر مقدار True باشد، به این معنی است که ایمیل شامل رمزگذاری TNEF است که معمولاً در ایمیل‌های ارسال‌شده از Microsoft Outlook یا Exchange رخ می‌دهد.

from aspose.email import MailMessage

mail = MailMessage.load(data_dir + "message.eml")
is_tnef = mail.original_is_tnef

Python-Net: شناسایی و پردازش ایمیل‌های برگشتی در پایتون

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

پردازش ایمیل‌های برگشتی

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

from aspose.email import MailMessage, SaveOptions, MsgLoadOptions, MessageFormat, FileCompatibilityMode

mail = MailMessage.load(data_dir + "message.eml")
result = mail.check_bounced()

print("IsBounced: " + str(result.is_bounced))
print("Action: " + str(result.action))
print("Recipient: " + str(result.recipient))
print()
print("Reason: " + str(result.reason))
print("Status: " + str(result.status))
print()

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

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

استفاده از فیلترینگ اسپم بیزی

Aspose.Email قابلیت فیلتر کردن ایمیل را با استفاده از تحلیل‌گر اسپم بیزی فراهم می‌کند. این قابلیت را ارائه می‌دهد SpamAnalyzer کلاس برای این منظور. این مقاله نشان می‌دهد چگونه فیلتر را برای تشخیص بین اسپم و ایمیل معمولی بر اساس یک دیتابیس واژگان آموزش داد.

مسیرهای پوشه‌ها را برای ایمیل‌های سالم (ham_folder)، ایمیل‌های اسپم (spam_folder)، ایمیل‌های تست (test_folder) و فایل دیتابیس (database_file) فیلتر اسپم مشخص کنید.
تعریف تابع کمکی print_result برای چاپ اینکه آیا پیام بر اساس احتمال محاسبه‌شده به عنوان اسپم طبقه‌بندی شده است یا نه.
تحلیل‌گر اسپم را با استفاده از فایل دیتابیس ایجاد کنید، آن را با ایمیل‌های موجود در ham_folder (غیر اسپم) و spam_folder (اسپم) آموزش دهید، سپس دیتابیس آموزش‌دیده را ذخیره کنید.
فایل‌های .eml را از ’test_folder’ بارگذاری کنید، هر کدام را با SpamAnalyzer.test تجزیه و تحلیل کنید تا احتمال اسپم به دست آید، و موضوع ایمیل و طبقه‌بندی را با استفاده از ‘print_result’ چاپ کنید.

from aspose.email import MailMessage, SaveOptions, MsgLoadOptions, MessageFormat, FileCompatibilityMode
from aspose.email.antispam import SpamAnalyzer
import os

ham_folder = "/hamFolder"
spam_folder = "/Spam"
test_folder = data_dir
database_file = "SpamFilterDatabase.txt"

def print_result(probability):
    if probability >= 0.5:
        print("The message is classified as spam.")
    else:
        print("The message is classified as not spam.")
    print("Spam Probability: " + str(probability))
    print()

def teach_and_create_database(ham_folder, spam_folder, database_file):
    analyzer = SpamAnalyzer(database_file)
    analyzer.teach_from_directory(ham_folder, True)
    analyzer.teach_from_directory(spam_folder, False)
    analyzer.save_database()

teach_and_create_database(ham_folder, spam_folder, database_file)

test_files = [f for f in os.listdir(test_folder) if f.endswith(".eml")]
analyzer = SpamAnalyzer(database_file)

for file in test_files:
    file_path = os.path.join(test_folder, file)
    msg = MailMessage.load(file_path)
    print(msg.subject)
    probability = analyzer.test(msg)
    print_result(probability)