💡 Ví dụ hoạt động đầy đủ có sẵn trên GitHub:
convert-email-and-attachments-to-pdf-dotnet
Chuyển đổi Email‑to‑PDF là một quy trình làm việc của GroupDocs.Conversion cho .NET giúp chuyển một tin nhắn Outlook và các tệp đính kèm của nó thành một hoặc nhiều tệp PDF mà không có tệp đính kèm nào bị ghi đè lên tệp khác hoặc một tệp không hỗ trợ làm hỏng toàn bộ quá trình. Nó thay thế quy trình xuất và đổi tên thủ công bằng một vài dòng mã biết, đối với mỗi mục, nguồn gốc và liệu nó có được chuyển đổi hay không.
Cách Cũ Đầy Đau Đầu
Hãy tưởng tượng một hộp thư hỗ trợ nơi mỗi email trường hợp đều có hai hoặc ba tệp đính kèm — một báo cáo ở đây, một ảnh chụp màn hình ở đó, đôi khi một định dạng tệp mà không ai trong nhóm nhận ra. Điều này không có gì bất thường. Xử lý trường hợp đó có nghĩa là mở tin nhắn, lưu từng tệp đính kèm bằng tay, đổi tên những tệp trùng nhau vì hai hệ thống đều xuất một tệp có tên report.csv, và hy vọng không có tệp nào trong tập hợp là định dạng mà trình xem PDF của bạn không thể mở. Làm việc này năm mươi lần một tuần và “xuất nhanh” trở thành phần chậm nhất của công việc, và cũng là phần có khả năng bị vội vàng nhất — chính lúc đó lỗi thường xảy ra.
Làm việc này bằng tay không chỉ tốn thời gian — nó còn là nơi các tệp im lặng biến mất. Lưu hai tệp đính kèm đều có tên report.csv vào cùng một thư mục mà không đổi tên trước, và lần lưu thứ hai sẽ ghi đè lên lần đầu; không ai nhận ra cho đến khi số liệu tháng 9 không còn tồn tại. Một tin nhắn chỉ có một tệp đính kèm ở định dạng mà không ai có bộ chuyển đổi có thể làm trễ toàn bộ quá trình xuất cho đến khi ai đó quyết định xử lý nó như thế nào.
Chi phí thực sự của việc làm thủ công: một tệp đính kèm đã được đổi tên và ghi đè không gây lỗi — nó chỉ biến mất một cách âm thầm, và hồ sơ trường hợp trông hoàn chỉnh cho đến khi ai đó cần dữ liệu đã mất.
Có Cách Tốt Hơn
GroupDocs.Conversion cho .NET biến việc này thành chỉ vài dòng mã. Không cần đổi tên thủ công. Lớp EmailLoadOptions kiểm soát việc chuyển đổi tin nhắn, các tệp đính kèm, hoặc cả hai, và một callback SaveContext mô tả mỗi mục đầu ra đủ chi tiết để hai tệp đính kèm có tên report.csv không bao giờ xung đột và một tệp đính kèm không có đường dẫn tới PDF không làm dừng lại phần còn lại của quá trình. Mỗi lần gọi callback sẽ báo cáo ItemIndex (đếm tăng dần bắt đầu từ 1), HierarchyLevel (0 cho tin nhắn, 1 cho tệp đính kèm) và SourceFileName (tên tệp gốc), đủ ngữ cảnh để tạo tên đầu ra không xung đột mà không cần ghi lại bất kỳ thông tin phụ trợ nào.
Trước khi bắt đầu, bạn sẽ cần:
- .NET SDK 8.0 trở lên
- GroupDocs.Conversion cho .NET 26.10.0 (lấy giấy phép tạm thời để bỏ giới hạn dùng thử)
- Một tin nhắn Outlook
.msghoặc.emlđể chuyển đổi
Cài đặt bằng một lệnh:
dotnet add package GroupDocs.Conversion --version 26.10.0
Cách Mới: Chuyển Đổi Tin Nhắn và Các Tệp Đính Kèm
Đây là cách thực hiện cùng một nhiệm vụ với GroupDocs.Conversion. Ví dụ dưới đây chuyển một tin nhắn Outlook và mọi tệp đính kèm của nó thành các PDF riêng biệt, với tên tệp không bao giờ trùng nhau.
Bước 1 - Xác Định Những Gì Cần Chuyển Đổi
EmailLoadOptions.ConvertOwner và ConvertOwned độc lập bật hoặc tắt việc chuyển đổi tin nhắn và các tệp đính kèm; Depth (mặc định 2) giới hạn mức độ theo dõi các tệp đính kèm lồng nhau.
// Convert the message itself and every attachment it carries
var loadOptions = new EmailLoadOptions
{
ConvertOwner = true,
ConvertOwned = true,
Depth = 2
};
Bước 2 - Đặt Tên Cho Mỗi Đầu Ra Từ SaveContext
Truyền một callback SaveContext vào Converter.Convert thay vì một đường dẫn đầu ra cố định. Callback sẽ được gọi một lần cho mỗi mục, với ItemIndex duy nhất cho mỗi mục ngay cả khi hai tệp đính kèm có cùng tên.
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());
}
Bước 3 - Xử Lý Các Tệp Đính Kèm Không Có Đường Dẫn PDF
Không phải mọi tệp đính kèm đều có thể trở thành PDF. Kiểm tra SaveContext.TargetFormat so với FileType.Unknown và lưu mục đó dưới tên riêng của nó thay vì chuyển đổi.
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());
Chỉ định đoạn mã này cho một email hỗ trợ mẫu có hai tệp đính kèm đều tên report.csv và một tệp ở định dạng không hỗ trợ. Ba PDF sẽ được tạo: tin nhắn và cả hai báo cáo CSV. Tệp không hỗ trợ cũng được xuất ra nguyên vẹn — mở nó cạnh bản gốc và mọi 32 byte của nó đều khớp.
Làm sao để tránh ghi đè các tệp đính kèm có cùng tên file?
Tên file đơn lẻ không thể là khóa an toàn cho đầu ra, vì hai tệp đính kèm có thể mang cùng một tên. Hòa SaveContext.ItemIndex vào tên cùng với SaveContext.SourceFileName, và hai tệp report.csv sẽ không còn cạnh tranh cùng một vị trí trên đĩa; mỗi tệp sẽ có tiền tố số 0‑đệm riêng (02- và 03- trong ví dụ, sau 01- của tin nhắn) và tệp của riêng nó, bất kể tên nguồn là gì.
So sánh: Trước và Sau
| Trước (Thủ công) | Sau (GroupDocs.Conversion) | |
|---|---|---|
| Thời gian | Phút cho mỗi tin nhắn, thực hiện thủ công | Vài dòng mã, bất kỳ số lượng tin nhắn nào |
| Tên trùng | Ghi đè im lặng | Giữ riêng biệt qua ItemIndex |
| Tệp đính kèm không hỗ trợ | Gây lỗi cho toàn bộ quá trình chuyển đổi (trước 26.10) | Lưu dưới tên riêng, quá trình tiếp tục |
| Đầu ra | Bất kỳ gì trình xem PDF của bạn có thể lưu | PDF có cấu trúc, bạn có thể lưu trữ hoặc lập chỉ mục |
Email hỗ trợ mẫu được xây dựng từ đúng hỗn hợp này: hai bản xuất CSV hàng tháng có cùng tên, và một tệp ghi lại không có bộ chuyển đổi nào nhận ra.
Ví dụ Thực Tế: Lưu Trữ Trường Hợp Hỗ Trợ
Một đội hỗ trợ ghi lại mỗi trường hợp khách hàng dưới dạng email có một hoặc nhiều tệp bảng tính đính kèm, và hệ thống theo dõi trường hợp cần lưu mỗi tệp đính kèm dưới dạng PDF có thể tìm kiếm riêng, tách biệt khỏi tin nhắn. Chạy tin nhắn qua KeepAttachmentsWithoutPdfRoute một lần cho mỗi trường hợp đến sẽ biến tin nhắn và các tệp đính kèm thành một tập hợp các tệp được đánh số, không có tệp nào bao giờ ghi đè lên tệp khác ngay cả khi hai báo cáo có cùng tên. Một email trường hợp có hai bản xuất report.csv hàng tháng và một tệp ghi lại ở định dạng không ai chuyển đổi sẽ xuất ra bốn tệp: tin nhắn, cả hai báo cáo CSV dưới dạng PDF, và tệp ghi lại được lưu dưới tên riêng của nó — không có gì bị mất, không có gì bị hợp nhất, không có gì bị ghi đè im lặng.
// One call per case e-mail - no manual export, no renamed duplicates
int kept = KeepAttachmentsWithoutPdfRoute(caseMessagePath, caseOutputFolder);
Những Điều Khác Bạn Có Thể Làm Với GroupDocs.Conversion cho .NET?
Ngoài việc tách tin nhắn ra khỏi các tệp đính kèm, EmailLoadOptions còn bao phủ nhiều khía cạnh của chính tin nhắn:
- Hiển thị trường: hiển thị hoặc ẩn phần đầu và các dòng
From,To,CcvàBccbằngDisplayHeadervà các tùy chọnDisplay*liên quan (CcvàBccmặc định bị ẩn). - Tiêu đề bản địa hoá: ánh xạ mỗi
EmailFieldtới một chú thích khác bằngFieldTextMap, ví dụ dịchSubjectvàAttachmentssang ngôn ngữ khác. - Định dạng ngày: dòng
Senttuân theo ngôn ngữ của máy chạy chuyển đổi, vàTimeZoneOffsetđặt độ lệch UTC được dùng cho ngày của tin nhắn. - Đầu ra chỉ tin nhắn: đặt
ConvertOwnedthànhfalsekhi PDF chỉ cần thay thế tin nhắn, với tên các tệp đính kèm vẫn được liệt kê trong phần đầu để tham chiếu.
Xem toàn bộ tài liệu tham khảo EmailLoadOptions reference để biết mọi tùy chọn.
Kết luận
Những gì trước đây có nghĩa là mở tin nhắn, lưu các tệp đính kèm bằng tay, và kiểm tra lại các bản sao bị ghi đè giờ chỉ cần một callback SaveContext và vài dòng mã. GroupDocs.Conversion cho .NET cung cấp cho mỗi mục đầu ra — tin nhắn và mỗi tệp đính kèm — một tên không bao giờ xung đột, và giữ lại các tệp không có đường dẫn PDF thay vì làm hỏng quá trình. Ba khối xây dựng giống nhau — ConvertOwner, ConvertOwned và callback SaveContext — có thể mở rộng từ một PDF tóm tắt đơn lẻ tới một bản phân tách an toàn, không xung đột của tin nhắn và mọi tệp đính kèm, vì vậy bạn có thể bắt đầu nhỏ và phát triển thành quy trình đầy đủ khi hộp thư đến của bạn yêu cầu.
Sẵn sàng tự động hoá quy trình chuyển email sang PDF của bạn?
- Try a free temporary license
- Khám phá converting each email attachment to a different output format
- Đọc toàn bộ EmailLoadOptions reference
- Xem dự án mẫu trên GitHub (convert-email-and-attachments-to-pdf-dotnet)