💡 Contoh lengkap yang berfungsi tersedia di GitHub: convert-email-and-attachments-to-pdf-dotnet
Konversi Email-ke-PDF adalah alur kerja GroupDocs.Conversion untuk .NET yang mengubah pesan Outlook dan lampirannya menjadi satu atau beberapa file PDF tanpa satu lampiran menimpa yang lain atau satu file yang tidak didukung menghentikan seluruh proses. Ini menggantikan prosedur ekspor-dan-ubah-nama manual dengan beberapa baris kode yang mengetahui, untuk setiap item, dari mana asalnya dan apakah berhasil dikonversi.
Cara Lama Sangat Menyakitkan
Bayangkan sebuah kotak masuk dukungan di mana setiap email kasus membawa dua atau tiga lampiran - sebuah laporan di sini, sebuah tangkapan layar di sana, kadang format file yang tidak dikenali tim. Tidak ada yang tidak biasa. Mengarsipkan kasus itu berarti membuka pesan, menyimpan setiap lampiran secara manual, mengganti nama yang bertabrakan karena dua sistem mengekspor file bernama report.csv, dan berharap tidak ada dalam kumpulan tersebut yang berupa format yang tidak dapat dibuka oleh penampil PDF Anda. Lakukan itu lima puluh kali seminggu dan “ekspor cepat” menjadi bagian paling lambat dari pekerjaan, dan bagian yang paling mungkin dipercepat, yang tepat saat kesalahan terjadi.
Melakukan ini secara manual tidak hanya memakan waktu - itu juga tempat file secara diam-diam hilang. Simpan dua lampiran yang keduanya bernama report.csv ke dalam folder yang sama tanpa mengganti nama terlebih dahulu, dan penyimpanan kedua menimpa yang pertama; tidak ada yang menyadari sampai angka-angka September tidak dapat ditemukan. Sebuah pesan dengan bahkan satu lampiran dalam format yang tidak ada konverternya dapat menghentikan seluruh proses ekspor sampai seseorang memutuskan apa yang harus dilakukan.
Biaya nyata melakukan secara manual: lampiran yang diubah nama dan ditimpa tidak menghasilkan error - ia hanya menghilang secara diam-diam, dan file kasus tampak lengkap sampai seseorang membutuhkan data yang ada di dalamnya.
Ada Cara yang Lebih Baik
GroupDocs.Conversion untuk .NET mengubah ini menjadi beberapa baris kode. Tidak diperlukan penggantian nama manual. Kelas EmailLoadOptions mengontrol apakah pesan, lampiran, atau keduanya yang dikonversi, dan callback SaveContext menjelaskan setiap item output dengan cukup detail sehingga dua lampiran bernama report.csv tidak pernah bertabrakan dan lampiran tanpa jalur ke PDF tidak pernah menghentikan sisa proses. Setiap pemanggilan callback tersebut melaporkan ItemIndex (jumlah berjalan mulai dari 1), HierarchyLevel (0 untuk pesan, 1 untuk lampiran) dan SourceFileName (nama file asli), yang cukup sebagai konteks untuk membuat nama output yang bebas tabrakan tanpa menulis pembukuan tambahan.
Sebelum kita mulai, Anda akan membutuhkan:
- .NET SDK 8.0 atau lebih baru
- GroupDocs.Conversion untuk .NET 26.10.0 (dapatkan lisensi sementara untuk menghapus batas evaluasi)
- Sebuah pesan Outlook
.msgatau.emluntuk dikonversi
Instal dengan satu perintah:
dotnet add package GroupDocs.Conversion --version 26.10.0
Cara Baru: Mengonversi Pesan dan Lampirannya
Berikut ini tampilan tugas yang sama dengan GroupDocs.Conversion. Contoh berikut mengonversi pesan Outlook dan setiap lampirannya menjadi PDF masing-masing, dengan nama file yang tidak pernah bertabrakan.
Langkah 1 - Tentukan Apa yang Akan Dikonversi
EmailLoadOptions.ConvertOwner dan ConvertOwned secara independen mengaktifkan atau menonaktifkan pesan dan lampirannya; Depth (default 2) membatasi seberapa dalam lampiran bersarang yang diikuti.
// Convert the message itself and every attachment it carries
var loadOptions = new EmailLoadOptions
{
ConvertOwner = true,
ConvertOwned = true,
Depth = 2
};
Langkah 2 - Beri Nama Setiap Output dari SaveContext
Berikan callback SaveContext ke Converter.Convert alih-alih jalur output tetap. Callback dipanggil sekali per item, dengan ItemIndex unik per item bahkan ketika dua lampiran memiliki nama file yang sama.
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());
}
Langkah 3 - Tangani Lampiran Tanpa Jalur PDF
Tidak setiap lampiran dapat menjadi PDF. Periksa SaveContext.TargetFormat terhadap FileType.Unknown dan simpan item tersebut dengan nama aslinya alih-alih mengonversinya.
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());
Arahkan kode ini ke contoh email dukungan dengan dua lampiran yang keduanya bernama report.csv dan satu lampiran dalam format yang tidak didukung. Tiga PDF dihasilkan: pesan dan kedua laporan CSV. File yang tidak didukung juga keluar, tidak tersentuh - buka di samping aslinya dan setiap satu dari 32 byte-nya cocok.
Bagaimana Saya Menghindari Menimpa Lampiran yang Memiliki Nama File yang Sama?
Nama file sendiri tidak dapat menjadi kunci aman untuk output, karena dua lampiran dapat memiliki nama yang persis sama. Gabungkan SaveContext.ItemIndex ke dalam nama bersama dengan SaveContext.SourceFileName, dan dua lampiran bernama report.csv tidak lagi bersaing untuk slot yang sama di disk; masing-masing mendapatkan prefiks berisi nol (02- dan 03- dalam contoh, setelah 01- milik pesan) dan file masing-masing, apa pun nama yang digunakan sumber.
Perbandingan: Sebelum vs. Sesudah
| Sebelum (Manual) | Sesudah (GroupDocs.Conversion) | |
|---|---|---|
| Waktu | Menit per pesan, secara manual | Beberapa baris kode, sejumlah pesan apa pun |
| Nama duplikat | Ditimpa secara diam-diam | Dipertahankan terpisah via ItemIndex |
| Lampiran tidak didukung | Menghentikan seluruh konversi (sebelum-26.10) | Disimpan dengan nama sendiri, proses berlanjut |
| Output | Apapun yang dapat disimpan penampil PDF Anda | PDF terstruktur yang dapat Anda arsipkan atau indeks |
Email dukungan contoh dibangun dari campuran itu: dua ekspor CSV bulanan dengan nama yang sama, dan satu file tangkapan yang tidak dikenali konverter mana pun.
Contoh Dunia Nyata: Pengarsipan Kasus Dukungan
Tim dukungan mencatat setiap kasus pelanggan sebagai email dengan satu atau lebih lampiran spreadsheet, dan sistem pelacakan kasus membutuhkan setiap lampiran diarsipkan sebagai PDF yang dapat dicari, terpisah dari pesan. Menjalankan pesan melalui KeepAttachmentsWithoutPdfRoute sekali per kasus masuk mengubah pesan dan lampirannya menjadi sekumpulan file bernomor, tanpa ada lampiran yang pernah menimpa yang lain bahkan ketika dua laporan memiliki nama yang sama. Email kasus dengan dua ekspor report.csv bulanan dan satu file tangkapan dalam format yang tidak dapat dikonversi menghasilkan empat file: pesan, kedua laporan CSV sebagai PDF, dan file tangkapan disimpan dengan nama sendiri - tidak ada yang hilang, tidak ada yang digabung, tidak ada yang ditimpa secara diam-diam.
// One call per case e-mail - no manual export, no renamed duplicates
int kept = KeepAttachmentsWithoutPdfRoute(caseMessagePath, caseOutputFolder);
Apa Lagi yang Bisa Anda Lakukan dengan GroupDocs.Conversion untuk .NET?
Selain memisahkan pesan dari lampirannya, EmailLoadOptions mencakup lebih banyak dari pesan itu sendiri:
- Visibilitas bidang: tampilkan atau sembunyikan header dan baris
From,To,Cc, danBcc-nya denganDisplayHeaderdan opsi terkaitDisplay*(CcdanBccdisembunyikan secara default). - Header terlokalisasi: petakan setiap
EmailFieldke caption yang berbeda denganFieldTextMap, misalnya menerjemahkanSubjectdanAttachmentske bahasa lain. - Pemformatan tanggal: baris
Sentmengikuti budaya mesin yang menjalankan konversi, danTimeZoneOffsetmengatur offset UTC yang digunakan untuk tanggal pesan. - Output hanya pesan: setel
ConvertOwnedkefalseketika PDF hanya perlu mewakili pesan, dengan nama lampiran tetap tercantum di header sebagai referensi.
Lihat referensi lengkap EmailLoadOptions reference untuk setiap opsi.
Kesimpulan
Apa yang dulu berarti membuka pesan, menyimpan lampiran secara manual, dan memeriksa kembali duplikat yang ditimpa kini hanya memerlukan callback SaveContext dan beberapa baris kode. GroupDocs.Conversion untuk .NET memberikan setiap item output - pesan dan setiap lampiran - nama yang tidak pernah bertabrakan, dan mempertahankan lampiran tanpa jalur PDF alih-alih membuat proses gagal. Tiga blok bangunan yang sama - ConvertOwner, ConvertOwned, dan callback SaveContext - dapat diskalakan dari satu PDF ringkasan hingga pemecahan lengkap yang aman dari tabrakan untuk sebuah pesan dan setiap lampirannya, sehingga Anda dapat memulai kecil dan berkembang menjadi alur kerja penuh sesuai kebutuhan kotak masuk Anda.
Siap mengotomatisasi alur kerja email-ke-PDF Anda?
- Coba lisensi sementara gratis
- Jelajahi mengonversi setiap lampiran email ke format output yang berbeda (converting each email attachment to a different output format)
- Baca referensi lengkap EmailLoadOptions reference
- Lihat proyek contoh di GitHub (sample project on GitHub)