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. כתובות האימייל המשמשות ב‑MailMessage הן:

To - ניתן לציין כתובות נמען בשדה ‘To’. נמעני שדה ‘To’ הם קהל היעד הראשי של ההודעה. ניתן לציין יותר מכתובת נמען אחת.
Cc - CC מרמז על "Carbon Copy" או "Courtesy Copy", ומאפשר לך להוסיף נמעני דוא"ל שצריכים לראות את ההודעה אך אינם נדרשים לפעול על פיה. לדוגמה מנהלים או חברי צוות שצריכים להיות מודעים לשיחה. ב- Aspose.Email ניתן לציין כתובות CC בקוד שלך, כך שהודעות אוטומטיות, או כל הודעה לכתובת מסוימת, יועתקו לצוות רלוונטי.
Bcc - Bcc, Blind Carbon Copy, מאפשר לך לשלוח דוא"ל לנמען המוסתר משאר הנמענים. בעוד ש-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 ושלח את הדוא"ל באמצעות השיטה Send.

קטע הקוד הבא מראה כיצד להציג שמות עבור כתובות דוא"ל.

הגדר גוף הודעה

מחלקת MailMessage מייצגת הודעת אימייל. מופעי המחלקה משמשים לבנות הודעות אימייל שמועברות לשרת SMTP לצורך משלוח באמצעות מחלקת SmtpClient. ניתן לציין את גוף המייל באמצעות מחלקת MailMessage. אימייל יכול להכיל מספר גופים. ישנם שני סוגים של גופי מייל במחלקת MailMessage:

גוף HTML
גוף טקסט

בנוסף ל‑HtmlBody ו‑TextBody, Aspose.Email כוללת שתי תכונות קריאה‑ניתן בלבד נוספות הקשורות לגוף המייל:

IsBodyText: מודיע למשתמש האם הגוף הוא טקסט.
IsBodyHtml: מודיע למשתמש האם הגוף הוא HTML או טקסט רגיל.

מאמר זה מציג כיצד להגדיר טקסט רגיל או טקסט גוף HTML, להגדיר טקסט חלופי ולמקודד את גוף האימייל.

הגדרת גוף HTML

HtmlBody משמש לציון תוכן ה‑HTML של גוף ההודעה. HtmlBody חייב להיות מוקף בתגיות . קוד הדוגמה הבא מראה כיצד להגדיר את גוף ה‑HTML.

הגדרת טקסט חלופי

השתמש במחלקת AlternateView כדי לציין עותקים של הודעת אימייל בפורמטים שונים. לדוגמה, אם אתה שולח הודעה ב‑HTML, ייתכן ותרצה לכלול גרסה בטקסט רגיל למקרה שהמקבלים משתמשים בתוכנות קריאת אימייל שאינן מציגות תוכן HTML. למחלקה זו שתי תכונות, LinkedResources ו‑BaseUri, המשמשות לפתרון כתובות URL בתוך תוכן האימייל.

LinkedResources הוא אוסף של אובייקטים מסוג LinkedResources. בעת רנדור, כתובות ה-URL בתוכן האימייל מתאימות תחילה לכתובות ה-URL בקישור התוכן של כל אובייקט LinkedResources באוסף, ונפתרות.
BaseUri משמש את קורא המייל לפתרון כתובות URL יחסיות בתוך הגוף, וכן לפתרון כתובות URL של קישורי תוכן יחסיים, באוסף LinkedResources.

קטע הקוד הבא מראה איך להגדיר טקסט חלופי.

תכונות MailMessage

ה MailMessage class מייצג את תוכן הודעת האימייל. מופעים של MailMessage class משמשים לבניית הודעת אימייל המועברת לשרת SMTP לצורך מסירה באמצעות ה SmtpClient class. מאמר זה מראה כיצד להשתמש MailMessage מאפייני שירות class לבקרת המאפיינים הבאים של האימייל:

Date and time - באמצעות MailMessage תכונת class Date משמשת לקבלת או הגדרת התאריך והשעה של אימייל.
עדיפות הודעה - ה- MailPriority מחלקה המגדירה רמות עדיפות לשליחת הודעת דוא"ל. היא יכולה להיות נמוכה, רגילה או גבוהה. העדיפות משפיעה על מהירות השידור והמסירה.
רגישות הודעה - ה- MailSensitivity מחלקה המגדירה חמש רמות של רגישות.
הודעת מסירה - הודעות מסירה מודיעות לשולחים שהאימייל שהם שלחו נמסר לתיבת הדואר של הנמען.

בברירת מחדל, התאריך הוא התאריך האמיתי שבו נשלח ההודעה, והזמן הוא הזמן שבו נשלחה, כפי שמוצג ב-Microsoft Outlook. אולם זמן המשלוח האמיתי של האימייל מתווסף על ידי שרת ה-SMTP עצמו בכותרת המייל. לדוגמה, להלן כותרת מייל נפוצה, שבה Date מגדיר את השדה Date.

קטע הקוד למטה מראה כיצד ניתן להשתמש בכל אחת מהתכונות שהוצגו למעלה.

בקשת קבלה של קריאה

דוגמאות הקוד למטה מראות כיצד ניתן לבקש קבלה של קריאת הודעה. The MailMessage מחלקה DeliveryNotificationOptions תכונת Enumeration מתארת את אפשרויות הודעת המשלוח עבור אימייל. כדי לבקש קבלה של קריאת הודעה לאחר שליחת אימייל, עקוב אחרי הצעדים הבאים:

צור מופע של MailMessage מחלקה.
ציין את השולח, המקבל וגוף HTML עבור האימייל ב- MailMessage מופע.
ציין את DeliveryNotificationOptions באחרים MailMessage מופעים.
צור מופע של SmtpClient מחלקה ושלח את האימייל באמצעות שיטת Send.

בקשות קבלה על קריאת ההודעה עשויות שלא תמיד תתקבלנה מכיוון ש:

לקוח דוא"ל עשוי לא לתמוך בפונקציה זו.
המשתמש הסופי עשוי לבטל את הפונקציה הזו.
המשתמש הסופי עשוי לבחור לא לשלוח אחד.

קטע הקוד הבא מראה כיצד לבקש קבלה על קריאת ההודעה.

הגדרת כותרות אימייל

כותרות אימייל מייצגות סטנדרט אינטרנט ו-RFC מגדיר שדות כותרת שנכללים באימיילים באינטרנט. ניתן לציין כותרת אימייל באמצעות מחלקת MailMessage. סוגי כותרות נפוצים מוגדרים במחלקת HeaderType. זו מחלקה sealed הפועלת כמו מונה רגיל.

בדרך כלל כותרת מייל מכילה את השדות הבאים:

To: ניתן לציין כתובות נמען בשדה To. נמען בשדה To הוא הקהל הראשי של ההודעה. ניתן לציין יותר מכתובת אחת.
From: שדה זה מציג את כתובת האימייל של שולח ההודעה.
Cc: מאפשר למשתמשים לשלוח הודעה כ„Carbon Copy“ או „Courtesy Copy“. כלומר, לא מצופה שהמקבל יגיב או יפעל. בדרך כלל, צוות פיקוח מודיע באמצעות CC.
Bcc: משמעותו Blind Carbon Copy, מתייחס לשיטת שליחת הודעה למספר נמענים כך שההודעה שהם מקבלים אינה כוללת את רשימת כל הנמענים. זה מיועד להודעה סמויה.
ReplyTo: שדה כותרת זה נועד לציין לאן השולח רוצה שהתגובות ילכו.
Subject: כותרת, נושא. משמש לעיתים כסמן נושא לשרשרות הודעות שמגיבות או מגיבות להודעות אחרות.
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 מופע.

קטע הקוד הבא מראה כיצד להגדיר כותרות אימייל.

קטע הקוד למעלה מייצר כותרת אימייל בפורמט הבא. ניתן לראות זאת על ידי פתיחת הקובץ שנוצר "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

הכנסת כותרת במיקום ספציפי

ה הוסף מתודה של HeadersCollection המחלקה מוסיפה את הכותרת בסוף האוסף. עם זאת, לפעמים יש צורך להכניס כותרת במיקום ספציפי. במקרה כזה, ה- הוסף השיטה לא תסייע. כדי לבצע זאת, השתמש ב- Insert שיטה של HeadersCollection. אם האוסף מכיל כותרות עם אותו שם, כותרת זו תתווסף לפני שאר הכותרות עם אותו שם. קוד הדוגמה הבא מראה כיצד להכניס כותרת במיקום ספציפי.

הוספת כותרות מותאמות אישית למייל

דוגמאות הקוד למטה מדגימות כיצד לציין כותרת מותאמת אישית בהודעת אימייל. ניתן לציין כותרת אימייל באמצעות MailMessage מחלקה. כדי לציין כותרת מותאמת אישית בהודעת אימייל, אנא פעל לפי הצעדים הבאים:

צור מופע של MailMessage מחלקה.
ציין ערכי to, from ו‑subject באמצעות מופע של MailMessage.
הוסף את הכותרת הסודית אל MailMessage מופע.
צור מופע של המחלקה SmtpClient ושלח את הדוא"ל באמצעות השיטה Send.

קטע הקוד הבא מציג כיצד להוסיף כותרות מותאמות אישית לאימייל.

Python-Net: חילוץ תוכן הודעות מדוא"ל

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

הצגת מידע הודעת דוא"ל על המסך

המחלקה MailMessage מייצגת הודעת דוא"ל ומאפשרת למפתחים לגשת למאפייני הודעת הדוא"ל. מידע הכותרת (כפי שנדון ב’חילוץ כותרות דוא"ל’) ניתן לחלץ ולשנות בדרכים שונות. מאמר זה מסביר כיצד להציג מידע נבחר מכותרת הדוא"ל וגוף ההודעה על המסך. כדי להציג מידע דוא"ל על המסך, פעל לפי הצעדים הבאים:

צור מופע של המחלקה MailMessage.
טען הודעת דוא"ל לתוך מופע MailMessage.
הצג את תוכן הדוא"ל על המסך.

קטע הקוד הבא מראה לך כיצד להציג מידע דוא"ל על המסך.

חילוץ כותרות הודעת דוא"ל

כותרת הדוא"ל מייצגת קבוצה תקנית של שדות כותרת המוגדרת באינטרנט וב-RFC ונכללת בהודעות דוא"ל באינטרנט. ניתן לציין כותרת דוא"ל באמצעות מחלקת MailMessage. סוגי כותרות נפוצים מוגדרים במחלקת HeaderType. זוהי מחלקה sealed הפועלת כמו מונה רגיל. כדי לחלץ כותרות מדוא"ל, פעל לפי הצעדים הבאים:

צור מופע של המחלקה MailMessage.
טען הודעת דוא"ל במופע של מחלקת MailMessage.
לאחר שהודעת אימייל נטענה, נקבל את התוכן הגולמי שלה.

מחלקת MailMessage עצמה מכילה מאפיינים כמו From, To, Cc, Subject וכן הלאה. ניתן לחלץ מאפיינים אלו מכותרות.

הצג את התוכן הגולמי.

קטע הקוד הבא מראה לך כיצד לחלץ כותרות דוא"ל.

קבלת ערכי כותרת מפוענחים

קטע הקוד הבא מראה לך כיצד לקבל ערכי כותרת מפוענחים.

Python-Net: טעינת ושמירת הודעה

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

אבחון פורמטים של קבצים

ממשק Aspose.Email API מספק את היכולת לאבחן את פורמט הקובץ של הודעה מסוימת. ניתן להשתמש במתודה 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 להגדרות נוספות בעת שמירה MailMessage ניתן להשתמש בו לשמירת הודעות לפורמטים אחרים. המאמר מראה כיצד להשתמש במחלקות אלה כדי לשמור דואר דוגמה כ:

פורמט EML.
Outlook MSG.
פורמט MHTML.
פורמט HTML.

טעינת EML ושמירתו כ‑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 תוך שמירת הגבולות המקוריים

קטע הקוד הבא מראה לך כיצד לטעון 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)

שמירה כ-EML תוך שמירה על צרופות TNEF

קטע הקוד הבא מראה לך כיצד לשמור כ‑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)

טעינת EML, שמירה כ‑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 המחלקה מאפשרת לשמור את הודעת המקור כקובץ הודעת Outlook (MSG) תוך שמירה על התאריכים. קטע הקוד הבא מראה כיצד לשמור כ-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)

שמירת MailMessage כ‑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 - מציין שיש לכתוב טקסט מאירוע לוח שנה בתוצר ה‑mhtml.
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 - מציין שיש לכתוב שדות משימה ספציפיים בתוצר ה‑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 מציג את אירועי היומן ל‑output 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)

ייצוא מייל ל-EML

קטע הקוד הבא מראה לך כיצד לייצא דוא"ל ל-eml.

from aspose.email import MailMessage, SaveOptions

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

# Save the Email message as EML
msg.save(data_dir + "ExporttoEml_out.eml", SaveOptions.default_eml)

שמירת הודעה כ-HTML

ה HtmlSaveOptions מחלקה המאפשרת לייצא את גוף ההודעה ל-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: תכונות שירות - MailMessage

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

הודעות אימייל המכילות קבצים מצורפים ב‑TNEF

Transport Neutral Encapsulation Format (TNEF) הוא פורמט קובץ מצורף קבוע בבעלות Microsoft Outlook ו- Microsoft Exchange Server. ממשק Aspose.Email API מאפשר לקרוא הודעות דוא"ל עם קבצים מצורפים בפורמט TNEF ולשנות את תוכן הקובץ המצורף. ניתן לשמור את ההודעה כדוא"ל רגיל או באותו פורמט, תוך שמירת קבצים מצורפים בפורמט TNEF. מאמר זה מציג דוגמאות קוד שונות לעבודה עם הודעות המכילות קבצים מצורפים בפורמט TNEF. הוא מציג גם עבודה עם יצירת קבצי TNEF EML מקבצי Outlook MSG.

קריאת הודעה תוך שמירת קבצים מצורפים בפורמט 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)

יצירת TNEF EML מתוך MSG

קבצי MSG של Outlook לעיתים כוללים מידע כגון טבלאות וסגנונות טקסט שעלולים להשתבש אם הם מומרי ל-EML. יצירת הודעות TNEF מקבצי MSG כאלה מאפשרת לשמר את העיצוב ואפילו לשלוח הודעות כאלה דרך לקוחות הדוא"ל תוך שמירת העיצוב. המאפיין convert_as_tnef משמש להשגת זאת. הקטע הקוד הבא מראה לך כיצד ליצור קובץ TNEF eML מקובץ 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, ניתן להשתמש בקוד הדוגמה הבא.

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.

from aspose.email import MailMessage

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

עיבוד הודעות קפוץ

זה מאוד נפוץ שהודעה שנשלחת לנמען יכולה לחזור (bounce) מסיבה כלשהי כגון כתובת נמען בלתי תקינה. לממשק Aspose.Email API יש אפשרות לעבד הודעה כזו כדי לבדוק אם היא דוא"ל קפוץ או הודעת דוא"ל רגילה. המתודה 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()

מנתח ספאם בייזי

Aspose.Email מספק סינון דוא"ל באמצעות מנתח ספאם בייזיאני. הוא מספק את SpamAnalyzer מחלקה למטרה זו. מאמר זה מציג כיצד לאמן את המסנן כדי להבדיל בין ספאם לדוא"ל רגיל בהתבסס על מסד נתוני מילים.

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)

Python-Net: עבודה עם קבצים מצורפים ופריטים משובצים

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

ניהול קבצים מצורפים לאימייל

קובץ מצורף לאימייל הוא קובץ מחשב שנשלח יחד עם הודעת אימייל. הקובץ יכול להישלח כהודעה נפרדת או כחלק מההודעה אליה הוא מצורף. מחלקת Attachment משמשת יחד עם מחלקת MailMessage. כל ההודעות כוללות גוף. בנוסף לגוף, ייתכן ותרצה לשלוח קבצים נוספים. קבצים אלה נשלחים כקבצים מצורפים ומיוצגים כמופע של מחלקת Attachment. ניתן לשלוח מספר בלתי מוגבל של קבצים מצורפים אך גודלם מוגבל על‑ידי שרת המייל. לדוגמה Gmail אינו תומך בקבצים גדולים יותר מ‑10 MB.

נסו זאת!

הוסף או הסר קבצים מצורפים למייל אונליין עם ה‑ Aspose.Email Editor App.

הוספת קובץ מצורף

להוספת קובץ מצורף לדוא"ל, אנא פעל לפי הצעדים:

צור מופע של מחלקת MailMessage.
צור מופע של מחלקת Attachment.
טען קובץ מצורף לתוך מופע ה-Attachment.
הוסף את מופע Attachment למופע של מחלקת MailMessage.

קטע הקוד הבא מראה כיצד להוסיף קובץ מצורף לדוא"ל.

מעלה תיארנו כיצד להוסיף קבצים מצורפים למסר הדוא"ל שלך עם Aspose.Email. מה שמופיע להלן מראה כיצד להסיר קבצים מצורפים ולהציג מידע עליהם על המסך.

הסרת קובץ מצורף

להסרת קובץ מצורף, פעל לפי הצעדים הבאים:

צור מופע של מחלקת Attachment.
טען קובץ מצורף למופע של מחלקת Attachment.
הוסף קובץ מצורף למופע של מחלקת MailMessage.
הסר את הקבצים המצורפים ממופע מחלקת Attachment באמצעות מופע של מחלקת MailMessage.

קטע הקוד הבא מראה כיצד להסיר קובץ מצורף.

הצגת שם קובץ מצורף

כדי להציג את שם הקובץ המצורף, פעל לפי הצעדים:

בצע לולאה על הקבצים המצורפים בהודעת הדוא"ל ו-
1. שמור כל קובץ מצורף.
2. הצג את שם כל קובץ מצורף על המסך.

קטע הקוד הבא מראה כיצד להציג על המסך את שם הקובץ המצורף.

חילוץ קבצים מצורפים מדוא"ל

הנושא הזה מסביר כיצד לחלץ קובץ מצורף מקובץ דוא"ל. קובץ מצורף לדוא"ל הוא קובץ מחשב שנשלח יחד עם הודעת דוא"ל. הקובץ יכול להישלח כהודעה נפרדת וכן כחלק מההודעה אליה הוא מצורף. כל הודעות הדוא"ל כוללות גוף. בנוסף לגוף, יתכן ותרצה לשלוח קבצים נוספים. קבצים אלו נשלחים כקבצים מצורפים ומיוצגים כמופעים של מחלקת Attachment. מחלקת Attachment משמשת יחד עם מחלקת MailMessage לעבודה עם קבצים מצורפים. כדי לחלץ קבצים מצורפים מהודעת דוא"ל, פעל לפי הצעדים הבאים:

צור מופע של המחלקה MailMessage.
טען קובץ דוא"ל לתוך מופע MailMessage.
צור מופע של מחלקת Attachment והשתמש בו בלולאה כדי לחלץ את כל הקבצים המצורפים.
שמור את הקובץ המצורף והצג אותו על המסך.
ציין כתובת השולח והמקבל במופע MailMessage.
עכשיו אתה יכול לשלוח דוא"ל באמצעות המחלקה SmtpClient.

קטעי הקוד מחלצים קבצים מצורפים ממסר דוא"ל.

|קבצים מצורפים שחולצו בדוא"ל| | :- | || הקטע הקוד הבא מראה לך כיצד לחלץ קבצים מצורפים לדוא"ל.

קבלת Content-Description מקובץ מצורף

ממשק Aspose.Email API מספק את היכולת לקרוא את תוכן השדה Content-Description של הקובץ המצורף מכותרת הקובץ. הקטע הקוד הבא מראה לך כיצד לקבל את תיאור התוכן מהקובץ המצורף.

קביעת האם הקובץ המצורף הוא הודעה מוטמעת

עבודה עם אובייקטים משובצים

אובייקט מוטמע הוא אובייקט שנוצר עם אפליקציה אחת ונכלל בתוך מסמך או קובץ שנוצר על ידי אפליקציה אחרת. לדוגמה, גיליון Excel של Microsoft ניתן לשלב בתוך דוח Word של Microsoft, או קובץ וידאו ניתן לשלב בתוך מצגת PowerPoint של Microsoft. כאשר קובץ מושמט, במקום להיות מושב או מודבק למסמך אחר, הוא שומר על הפורמט המקורי שלו. ניתן לפתוח את המסמך המוטמע באפליקציה המקורית ולשנות אותו.

שיבוץ אובייקטים בדוא"ל

הסרת אובייקטים מוטמעים מדוא"ל

LinkedResourceCollection הנגיש דרך המאפיין MailMessage.LinkedResources, מספק שיטה להסרת מלאה של אובייקטים מוטמעים שנוספו להודעת דוא"ל. השתמש בגרסה המועמסת של השיטה LinkedResourceCollection.RemoveAt כדי להסיר כל עקבות של אוביקט מוטמע מהודעת דוא"ל.

קוד הדוגמה שלהלן מראה כיצד להסיר אובייקטים מוטמעים מהודעת דוא"ל.

חילוץ אובייקטים משובצים

הנושא הזה מסביר כיצד לחלץ אובייקטים מוטמעים מקובץ דוא"ל. אובייקט מוטמע הוא אובייקט שנוצר באפליקציה אחת ונכלל בתוך מסמך או קובץ שנוצר באפליקציה אחרת. לדוגמה, גיליון Excel של Microsoft ניתן לשלב בתוך דוח Word של Microsoft, או קובץ וידאו ניתן לשלב במצגת PowerPoint של Microsoft. כאשר קובץ מוטמע, במקום להיות מושב או מודבק למסמך אחר, הוא שומר על הפורמט המקורי שלו. ניתן לפתוח את המסמך המוטמע באפליקציה המקורית ולשנות אותו. כדי לחלץ אובייקט מוטמע מהודעת דוא"ל, פעל לפי הצעדים הבאים:

צור מופע של המחלקה MailMessage.
טען קובץ אימייל במופע MailMessage.
צור לולאה וצור בתוכה מופע של מחלקת Attachment.
שמור את הקובץ המצורף והצג אותו על המסך.
ציין כתובת השולח והמקבל במופע MailMessage.
שלח דוא"ל באמצעות מחלקת SmtpClient.

קטע הקוד שלמטה מחלץ אובייקטים מוטמעים מדוא"ל.

|עצמים משובצים שחולצו במייל| | :- | || הקטע הקוד הבא מראה לך כיצד לחלץ אובייקטים מוטמעים.