עבודה עם קבצים מצורפים להודעה

ניתוח ושמירת קבצים מצורפים

קבצי הודעת Outlook עשויים להכיל קובץ מצורף אחד או יותר. Aspose.Email מאפשר למפתחים לעבור על הקבצים המצורפים בקובץ MSG ולשמור אותם לכונן. נושא זה מתאר את התהליך. הוא גם מתאר כיצד לשבץ קובץ מצורף.

Aspose.Email MapiMessage מחלקה משמשת לטעון קובץ MSG מהכונן ומחשיפה את getAttachments() מתודה המתייחסת ל‑ MapiAttachment אוסף האובייקטים הקשור לקובץ MSG. ה‑ MapiAttachment האובייקט חושף בנוסף מתודות שמבצעות פעולות על הקובץ המצורף.

כדי לשמור קבצים מצורפים בקובץ MSG לכונן עם שם והרחבה מקוריים:

1. צור מופע של MapiMessage מחלקה לטעינת קובץ MSG באמצעות Load() מתודה סטטית.
2. הפעל את MapiRecipient מחלקה getAttachments() מתודה לקבלת הפניה לאוסף של MapiAttachment אובייקטים הקשורים לקובץ MSG.
3. לולאה על ה- MapiAttachmentCollection להציג תוכן לגבי כל MapiAttachment אובייקט דרך המתודות הציבוריות שלו.
4. הפעל את MapiAttachment מחלקה save() מתודה לשמירת קובץ מצורף לכונן.  

שיבוץ הודעות כקבצים מצורפים

הודעת Microsoft Outlook יכולה להכיל הודעות Microsoft Outlook אחרות בקבצים מצורפים, או כהודעות רגילות כמפורט למעלה, או כהודעות משובצות. ה‑ MapiAttachmentCollection מספק חברים מעודנים של מתודת add ליצירת הודעות Outlook עם שני סוגי קבצים מצורפים. קבצי Outlook MSG משובצים בקובץ MSG מכילים PR_ATTACH_METHOD בערך 5.

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

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

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

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

Aspose.Email API מספקת אפשרות להכניס קובץ מצורף MSG להודעה אב (parent MSG) באמצעות ה‑ MapiAttachmentCollection.Insert() שיטה.

החלפת תוכן קובץ מצורף MSG משובץ

ניתן להשתמש בזה כדי להחליף את תוכן הקובץ המצורף המשובץ בתוכן החדש באמצעות ה‑ החלף מתודה. עם זאת, לא ניתן להשתמש בה להוספת קובץ מצורף עם PR_ATTACH_NUM = 4 (לדוגמה) באוסף שבו collection.Count = 2.

שמירת קבצים מצורפים מהודעה חתומה דיגיטלית

Aspose.Email API מספקת אפשרות לקבל או להגדיר ערך המציין האם הודעה חותמת (clear‑signed) תפוענח. 

שינוי שם קובץ מצורף ב‑MapiMessage

Aspose.Email מאפשר לערוך את ה‑ שם תצוגה ערך המאפיין ב‑ קבצים מצורפים של MapiMessage.

קוד הדוגמה הבא מדגים כיצד לעדכן את שמות התצוגה של הקובץ הראשון והשני בתוך הודעת Mapi שהוטענה:

MapiMessage msg = MapiMessage.load(fileName);
msg.getAttachments().get_Item(0).setDisplayName("New display name 1");
msg.getAttachments().get_Item(1).setDisplayName("New display name 2");

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

ההבדל בין קבצים מצורפים מוטמעים (inline) וקבצים מצורפים רגילים הוא באופן הצגתם באימייל. קבצים מצורפים מוטמעים משולבים בגוף האימייל וניתנים לצפייה ללא צורך בפתיחת קובץ נפרד או הורדה. קבצים מצורפים רגילים הם קבצים נפרדים שמצורפים למייל אך אינם מוצגים ישירות בגוף ההודעה ויש צורך להורידם ולפתוח אותם חיצונית. ה‑ MapiAttachment.IsInline מאפיין של MapiAttachment מחלקה מקבלת ערך המציין האם הקובץ המצורף הוא מוטמע או רגיל.

קוד הדוגמה הבא טוען הודעת אימייל מקובץ ולאחר מכן מקבל מידע על הקבצים המצורפים, ובמיוחד מדפיס את שם התצוגה של כל קובץ מצורף ואת המצב האם הוא מוטמע (inline) בתוך ההודעה או לא:

MapiMessage message = MapiMessage.load("fileName");

for (MapiAttachment attach : message.getAttachments()) {
    System.out.println(attach.getDisplayName() + ": " + attach.isInline());
}