💡 ตัวอย่างทำงานเต็มที่พร้อมใช้งานบน GitHub:
convert-email-and-attachments-to-pdf-dotnet

การแปลง Email เป็น PDF เป็น workflow ของ 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 (ชื่อไฟล์ต้นฉบับ), ซึ่งเป็นข้อมูลเพียงพอที่จะสร้างชื่อไฟล์ผลลัพธ์ที่ไม่ชนกันโดยไม่ต้องเขียนบันทึกเพิ่มเติม

ก่อนเริ่ม, คุณจะต้องมี:

  • .NET SDK 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) จำกัดความลึกของไฟล์แนบที่ซ้อนกัน

// แปลงข้อความเองและไฟล์แนบทุกไฟล์ที่มันมี
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 คือ 1 สำหรับข้อความ, แล้วเพิ่มขึ้นต่อไฟล์แนบ
        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 เพื่อสร้างชื่อที่รวมลำดับ (02- และ 03- ในตัวอย่าง, หลังจากข้อความที่มี 01-) ทำให้แต่ละไฟล์มีคำนำหน้าที่ไม่ซ้ำกันและไฟล์ของมันเอง ไม่ว่าจะชื่อไฟล์ต้นฉบับเป็นอะไร

เปรียบเทียบข้างเคียง: ก่อน vs. หลัง

ก่อน (ทำด้วยมือ) หลัง (GroupDocs.Conversion)
เวลา นาทีต่อข้อความ, ทำด้วยมือ ไม่กี่บรรทัดโค้ด, จำนวนข้อความใดก็ได้
ชื่อซ้ำ ถูกเขียนทับโดยเงียบ แยกกันโดยใช้ ItemIndex
ไฟล์แนบที่ไม่รองรับ ทำให้การแปลงทั้งหมดล้มเหลว (ก่อน 26.10) บันทึกด้วยชื่อของมันเอง, การทำงานต่อเนื่อง
ผลลัพธ์ ตามที่โปรแกรมดู PDF ของคุณบันทึกได้ PDF ที่จัดโครงสร้างได้, สามารถจัดเก็บหรือทำดัชนีได้

อีเมลสนับสนุนในตัวอย่างสร้างมาจากการผสมผสานนี้: การส่งออก CSV รายเดือนสองไฟล์ที่มีชื่อเดียวกัน, และไฟล์ capture หนึ่งไฟล์ที่ไม่มีตัวแปลงใด ๆ รู้จัก

ตัวอย่างจากโลกจริง: การจัดเก็บเคสสนับสนุน

ทีมสนับสนุนบันทึกเคสลูกค้าทุกเคสเป็นอีเมลที่มีไฟล์แนบสเปรดชีตหนึ่งหรือหลายไฟล์, และระบบติดตามเคสต้องการให้ไฟล์แนบแต่ละไฟล์ถูกจัดเก็บเป็น PDF ที่ค้นหาได้แยกจากข้อความ การเรียก KeepAttachmentsWithoutPdfRoute หนึ่งครั้งต่อเคสที่เข้ามาจะทำให้ข้อความและไฟล์แนบทั้งหมดกลายเป็นชุดไฟล์ที่มีหมายเลขลำดับ, โดยไม่มีไฟล์แนบใดเขียนทับอีกแม้สองรายงานจะมีชื่อเดียวกัน เคสอีเมลที่มีการส่งออก CSV รายเดือนสองไฟล์ report.csv และไฟล์ capture หนึ่งไฟล์ในรูปแบบที่ไม่มีใครแปลงได้ จะออกมาเป็นสี่ไฟล์: ข้อความ, รายงาน CSV ทั้งสองเป็น PDF, และไฟล์ capture ที่บันทึกด้วยชื่อของมันเอง — ไม่มีไฟล์หาย, ไม่มีการรวมไฟล์, ไม่มีการเขียนทับโดยเงียบ

// หนึ่งการเรียกต่ออีเมลเคส - ไม่ต้องส่งออกด้วยมือ, ไม่ต้องเปลี่ยนชื่อซ้ำ
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 ที่ใช้สำหรับวันที่ของข้อความ
  • ผลลัพธ์เฉพาะข้อความ: ตั้งค่า ConvertOwned เป็น false เมื่อ PDF ต้องการแทนข้อความเท่านั้น, โดยยังคงแสดงชื่อไฟล์แนบในส่วนหัวเพื่ออ้างอิง

ดูเอกสารอ้างอิงเต็มของ EmailLoadOptions สำหรับทุกตัวเลือก

สรุป

สิ่งที่เคยหมายถึงการเปิดข้อความ, บันทึกไฟล์แนบด้วยมือ, และตรวจสอบไฟล์ซ้ำที่เขียนทับ ตอนนี้ทำได้ด้วย callback SaveContext และโค้ดไม่กี่บรรทัด GroupDocs.Conversion for .NET ให้ชื่อไฟล์ผลลัพธ์—ข้อความและไฟล์แนบแต่ละไฟล์—ที่ไม่ชนกัน, และเก็บไฟล์แนบที่ไม่มีเส้นทางไปเป็น PDF แทนการทำให้การทำงานล้มเหลว ส่วนประกอบสามอย่างเดียว — ConvertOwner, ConvertOwned และ callback SaveContext — สามารถขยายจาก PDF สรุปเดียวจนถึงการแยกไฟล์อย่างปลอดภัยของข้อความและไฟล์แนบทั้งหมด, ทำให้คุณเริ่มจากขนาดเล็กและขยายเป็น workflow เต็มรูปแบบตามที่กล่องขาเข้าของคุณต้องการ

พร้อมที่จะอัตโนมัติกระบวนการแปลงอีเมลเป็น PDF ของคุณหรือยัง?

แหล่งข้อมูลเพิ่มเติม