💡 דוגמה מלאה עובדת זמינה ב‑GitHub:
convert-email-and-attachments-to-pdf-dotnet

המרת Email‑ל‑PDF היא זרימת עבודה של GroupDocs.Conversion עבור .NET שממירה הודעת Outlook והקבצים המצורפים אליה לקובץ PDF אחד או יותר מבלי שקובץ מצורף אחד ידרוס אחר או שקובץ לא נתמך יפגע בריצה כולה. היא מחליפה רוטינת ייצוא‑והחלפה ידנית במעט שורות קוד שיודעות, עבור כל פריט, מאיפה הוא הגיע והאם הוא הומר בכלל.

הדרך הישנה הייתה כואבת

דמיינו תיבת תמיכה שבה כל מקרה של אימייל כולל שניים או שלושה קבצים מצורפים – דוח כאן, צילום מסך שם, ולעיתים פורמט קובץ שאף אחד בצוות לא מכיר. אין דבר מוזר בזה. טיפול במקרה דורש פתיחת ההודעה, שמירת כל קובץ מצורף ידנית, שינוי שם של קבצים שמתנגשים מכיוון ששתי מערכות ייצאו קובץ בשם report.csv, והמתנה שלא יהיה קובץ בפורמט שהצופה PDF שלכם לא יוכל לפתוח. עשו זאת חמישים פעמים בשבוע וה„ייצוא המהיר” הופך לחלק האיטי ביותר בעבודה, ולחלק שבו הכי סביר למהר, וזה בדיוק הרגע שבו מתרחשות טעויות.

ביצוע זה ידנית לא רק גוזל זמן – זה גם המקום שבו קבצים נעלמים בשקט. שמרו שני קבצים מצורפים שנקראו report.csv באותה תיקייה ללא שינוי שם מראש, והשמירה השנייה תדרוס את הראשונה; אף אחד לא שם לב עד שמספרי ספטמבר נעלמים. הודעה עם אפילו קובץ מצורף בפורמט שאין לו ממיר יכולה לעצור את כל הייצוא עד שמישהו יחליט מה לעשות איתו.

העלות האמיתית של ביצוע ידני: קובץ מצורף ששונה שם ודרוס לא זורק שגיאה – הוא פשוט נעלם בשקט, וקובץ המקרה נראה שלם עד שמישהו צריך את הנתונים שהיו בו.

יש דרך טובה יותר

GroupDocs.Conversion עבור .NET ממירה זאת למספר שורות קוד. אין צורך בשינוי שם ידני. המחלקה EmailLoadOptions שולטת האם להמיר את ההודעה, את הקבצים המצורפים, או את שניהם, ו‑callback של SaveContext מתאר כל פריט פלט במידה מספיקה כך ששני קבצים מצורפים בשם report.csv לעולם לא יתנגשו וקובץ מצורף ללא מסלול PDF לא יעצור את שאר הריצה. כל קריאה ל‑callback מדווחת ItemIndex (ספירה רציפה שמתחילה ב‑1), HierarchyLevel (0 עבור ההודעה, 1 עבור קובץ מצורף) ו‑SourceFileName (שם הקובץ המקורי), וזה מספיק הקשר לבנות שם פלט ללא התנגשות ללא צורך ברישום נוסף.

לפני שנתחיל, תזדקקו ל‑:

  • SDK .NET 8.0 או מאוחר יותר
  • GroupDocs.Conversion for .NET 26.10.0 (קבל רישיון זמני להסרת מגבלות הערכה)
  • הודעת Outlook .msg או .eml להמרה

התקנה עם פקודה אחת:

dotnet add package GroupDocs.Conversion --version 26.10.0

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

הנה איך המשימה נראית עם GroupDocs.Conversion. הדוגמה הבאה ממירה הודעת Outlook וכל אחד מהקבצים המצורפים שלה לקובץ PDF נפרד, עם שמות קבצים שלעולם לא יתנגשו.

שלב 1 - החלט מה להמיר

EmailLoadOptions.ConvertOwner ו‑ConvertOwned מחליפים באופן עצמאי את ההודעה ואת הקבצים המצורפים; Depth (ברירת מחדל 2) מגביל עד כמה עומק הקבצים המצורפים ייטרו.

// Convert the message itself and every attachment it carries
var loadOptions = new EmailLoadOptions
{
    ConvertOwner = true,
    ConvertOwned = true,
    Depth = 2
};

שלב 2 - שם לכל פלט מ‑SaveContext

העבירו callback של SaveContext ל‑Converter.Convert במקום נתיב פלט קבוע. ה‑callback פועל פעם אחת לכל פריט, עם ItemIndex ייחודי לכל פריט גם כאשר שני קבצים מצורפים חולקים שם קובץ.

using (var converter = new Converter(messagePath, (LoadContext _) => loadOptions))
{
    converter.Convert((SaveContext item) =>
    {
        // ItemIndex is 1 for the message, then counts up per attachment
        string name = $"{item.ItemIndex:D2}-{item.SourceFileName}.pdf";
        return File.Create(Path.Combine(outputFolder, name));
    }, new PdfConvertOptions());
}

שלב 3 - טיפול בקבצים מצורפים ללא מסלול PDF

לא כל קובץ מצורף יכול להפוך ל‑PDF. בדקו SaveContext.TargetFormat מול FileType.Unknown ושמרו את הפריט בשם שלו במקום להמירו.

converter.Convert((SaveContext item) =>
{
    bool passedThrough = item.TargetFormat == FileType.Unknown;
    string baseName = $"{item.ItemIndex:D2}-{item.SourceFileName}";
    string name = passedThrough
        ? baseName
        : $"{baseName}.{item.TargetFormat.Extension}";
    return File.Create(Path.Combine(outputFolder, name));
}, new PdfConvertOptions());

הצב את הקוד על אימייל תמיכה לדוגמה עם שני קבצים מצורפים שנקראו report.csv וקובץ אחד בפורמט לא נתמך. יוצאים שלושה קבצי PDF: ההודעה ושני דוחות ה‑CSV. הקובץ הלא נתמך יוצא גם הוא, ללא שינוי – פתחו אותו לצד המקור וכל 32 הבייטים שלו תואמים.

איך למנוע דריסה של קבצים מצורפים בעלי שם קובץ זהה?

שם קובץ לבדו אינו יכול לשמש כמפתח בטוח לפלט, מכיוון ששני קבצים מצורפים יכולים לשאת בדיוק את אותו שם. שלבו SaveContext.ItemIndex בשם יחד עם SaveContext.SourceFileName, ושני קבצים מצורפים בשם report.csv יפסיקו להתחרות על אותו משבצת בדיסק; לכל אחד יהיה קידומת אפס‑מולאה משלו (02- ו‑03- בדוגמה, אחרי 01- של ההודעה) וקובץ משלו, לא משנה מה היה שם המקור.

השוואה ציד-ציד: לפני מול אחרי

לפני (ידני) אחרי (GroupDocs.Conversion)
זמן דקות לכל הודעה, ידנית כמה שורות קוד, כל מספר של הודעות
שמות כפולים נדרסים בשקט נשמרים בנפרד באמצעות ItemIndex
קובץ מצורף לא נתמך משבית את כל ההמרה (לפני 26.10) נשמר בשם שלו, הריצה ממשיכה
פלט מה שהצופה PDF שלכם יכול לשמור קבצי PDF מובנים שניתן לתייק או למיין

אימייל התמיכה בדוגמה נבנה בדיוק מהתמהיל הזה: שני ייצואי CSV חודשיים עם אותו שם, וקובץ לכידה שלא מזהה ממיר.

דוגמה מהעולם האמיתי: ארכוב מקרים של תמיכה

צוות תמיכה מתעד כל מקרה לקוח כהודעת אימייל עם קובץ או יותר של גיליונות אלקטרוניים, ומערכת המעקב צריכה שכל קובץ מצורף יוגש כ‑PDF ניתנת לחיפוש משלו, נפרד מההודעה. הרצת ההודעה דרך KeepAttachmentsWithoutPdfRoute פעם אחת לכל מקרה נכנס ממירה את ההודעה והקבצים המצורפים למספר קבצים ממוספרים, ללא דריסה של קובץ מצורף אף פעם גם כששני דוחות חולקים שם. אימייל מקרה עם שני ייצואי report.csv חודשיים וקובץ לכידה בפורמט שאין לו ממיר יוצא כארבעה קבצים: ההודעה, שני דוחות ה‑CSV כ‑PDF, וקובץ הלכידה נשמר בשם שלו – ללא איבוד, ללא מיזוג, ללא דריסה שקטה.

// One call per case e-mail - no manual export, no renamed duplicates
int kept = KeepAttachmentsWithoutPdfRoute(caseMessagePath, caseOutputFolder);

מה עוד אפשר לעשות עם GroupDocs.Conversion for .NET?

מעבר לפיצול הודעה מהקבצים המצורפים, EmailLoadOptions מכסה גם יותר מההודעה עצמה:

  • נראות שדות: הצגה או הסתרת הכותרת ושורות From, To, Cc ו‑Bcc עם DisplayHeader והאפשרויות הקשורות Display* (Cc ו‑Bcc מוסתרות כברירת מחדל).
  • כותרות מתורגמות: מיפוי כל EmailField לכותרת אחרת עם FieldTextMap, לדוגמה תרגום Subject ו‑Attachments לשפה אחרת.
  • עיצוב תאריך: שורת Sent מתאימה לתרבות של המחשב שמריץ את ההמרה, ו‑TimeZoneOffset מגדיר את ה‑UTC offset המשמש לתאריכי ההודעה.
  • פלט רק הודעה: הגדרת ConvertOwned ל‑false כאשר ה‑PDF נדרש רק להחליף את ההודעה, כאשר שמות הקבצים המצורפים עדיין מופיעים בכותרת כהפניה.

ראו את ההפניה המלאה ל‑EmailLoadOptions reference לכל אפשרות.

סיכום

מה שהיה אומר פתיחת הודעה, שמירת קבצים מצורפים ידנית ובדיקה חוזרת של קבצים כפולים שנדרסים, נעשה כעת בעזרת callback של SaveContext ומספר שורות קוד. GroupDocs.Conversion for .NET נותן לכל פריט פלט – ההודעה וכל קובץ מצורף – שם שלעולם לא יתנגש, ושומר קובץ מצורף ללא מסלול PDF במקום לגרום לכשל בריצה. שלושת הבניינים הבסיסיים – ConvertOwner, ConvertOwned ו‑callback של SaveContext – ניתנים להרחבה מה‑PDF הסיכום היחיד ועד לפירוק מלא, בטוח מתנגשות, של הודעה וכל הקבצים המצורפים שהיא נושאת, כך שניתן להתחיל בקטן ולגדול עם תהליך העבודה ככל שתיבת הדואר שלכם דורשת זאת.

מוכן לאוטומציה של תהליך המרת אימייל ל‑PDF?

משאבים נוספים