💡 ตัวอย่างทำงานเต็มที่พร้อมใช้งานบน 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 ของคุณหรือยัง?
- ลองใบอนุญาตชั่วคราวฟรี
- สำรวจการ แปลงไฟล์แนบแต่ละอีเมลเป็นรูปแบบผลลัพธ์ที่ต่างกัน
- อ่านเอกสารอ้างอิงเต็มของ EmailLoadOptions
- ตรวจสอบ โครงการตัวอย่างบน GitHub