💡 Tam çalışan örnek GitHub’da mevcuttur: convert-email-and-attachments-to-pdf-dotnet

Email-to-PDF dönüşümü, bir Outlook mesajını ve eklerini bir veya daha fazla PDF dosyasına dönüştüren bir GroupDocs.Conversion iş akışıdır; bir ekin diğerinin üzerine yazması ya da desteklenmeyen bir dosyanın tüm işlemi durdurması söz konusu değildir. Manuel dışa aktar‑ve‑yeniden adlandırma rutinini, her öğenin nereden geldiğini ve hiç dönüştürülüp dönüştürülmediğini bilen birkaç kod satırıyla değiştirir.

Eski Yöntem Acı Vericiydi

Her vaka e‑postasının iki ya da üç ek taşıdığı bir destek gelen kutusunu hayal edin – bir rapor burada, bir ekran görüntüsü orada, bazen ekipte kimsenin tanımadığı bir dosya biçimi. Bu durum olağan dışı değildir. O vakayı dosyalamak, mesajı açmak, her eki elle kaydetmek, iki sistemin aynı report.csv dosyasını dışa aktarması nedeniyle çakışanları yeniden adlandırmak ve set içindeki hiçbir dosyanın PDF görüntüleyicinizin açamadığı bir biçimde olmamasını ummak anlamına gelir. Bunu haftada elli kez yaparsanız “hızlı dışa aktarım” işin en yavaş kısmı haline gelir ve en çok acele edilen kısım olur; tam da hataların meydana geldiği an budur.

Bunu elle yapmak sadece zaman kaybı değildir – aynı zamanda dosyaların sessizce kaybolduğu yerdir. İki report.csv ekini aynı klasöre yeniden adlandırmadan kaydederseniz, ikinci kaydetme birincisinin üzerine yazar; kimse Eylül sayıları kaybolana kadar fark etmez. Bir ek bile, kimsenin dönüştürücüsü olmayan bir biçimde olduğunda, tüm dışa aktarımı durdurabilir ve birinin ne yapılacağına karar vermesini bekletir.

Manuel yapmanın gerçek maliyeti: yeniden adlandırılmış ve üzerine yazılmış bir ek hata vermez – sessizce kaybolur ve vaka dosyası eksiksiz görünür, ta ki birinin içinde olduğu veriye ihtiyacı gelene kadar.

Daha İyi Bir Yol Var

GroupDocs.Conversion for .NET bunu birkaç kod satırına indirger. Manuel yeniden adlandırma gerekmez. EmailLoadOptions sınıfı, mesajın, eklerin ya da her ikisinin dönüştürülüp dönüştürülmeyeceğini kontrol eder ve bir SaveContext geri çağrısı, iki report.csv ekinin asla çakışmamasını ve PDF yolu olmayan bir ekin çalışmanın geri kalanını durdurmamasını sağlayacak kadar ayrıntılı bilgi verir. Bu geri çağrının her çağrısı ItemIndex (1’den başlayan bir sayaç), HierarchyLevel (mesaj için 0, ek için 1) ve SourceFileName (orijinal dosya adı) rapor eder; bu, ekstra bir muhasebe kodu yazmadan çakışmasız bir çıktı adı oluşturmak için yeterli bağlamdır.

Başlamadan önce şunlara ihtiyacınız olacak:

  • .NET SDK 8.0 veya üzeri
  • GroupDocs.Conversion for .NET 26.10.0 (geçici bir lisans alın değerlendirme sınırlamalarını kaldırmak için)
  • Dönüştürülecek bir Outlook .msg veya .eml mesajı

Tek bir komutla kurun:

dotnet add package GroupDocs.Conversion --version 26.10.0

Yeni Yöntem: Bir Mesajı ve Eklerini Dönüştürmek

Aynı görevin GroupDocs.Conversion ile nasıl göründüğüne bir göz atın. Aşağıdaki örnek, bir Outlook mesajını ve her bir ekini kendi PDF dosyasına dönüştürür; dosya adları asla çakışmaz.

Adım 1 - Ne Dönüştürüleceğine Karar Ver

EmailLoadOptions.ConvertOwner ve ConvertOwned bağımsız olarak mesajı ve eklerini açar ya da kapatır; Depth (varsayılan 2) iç içe eklerin ne kadar takip edileceğini sınırlar.

// Mesajı ve taşıdığı her eki dönüştür
var loadOptions = new EmailLoadOptions
{
    ConvertOwner = true,
    ConvertOwned = true,
    Depth = 2
};

Adım 2 - SaveContext’ten Her Çıktıya İsim Ver

Converter.Convert yerine sabit bir çıktı yolu vermek yerine bir SaveContext geri çağrısı geçirin. Geri çağrı, her öğe için bir kez çalışır ve iki ek aynı dosya adına sahip olsa bile ItemIndex öğe başına benzersizdir.

using (var converter = new Converter(messagePath, (LoadContext _) => loadOptions))
{
    converter.Convert((SaveContext item) =>
    {
        // ItemIndex mesaj için 1, ardından ekler için artar
        string name = $"{item.ItemIndex:D2}-{item.SourceFileName}.pdf";
        return File.Create(Path.Combine(outputFolder, name));
    }, new PdfConvertOptions());
}

Adım 3 - PDF Yolu Olmayan Ekleri İşle

Her ek PDF’ye dönüşemez. SaveContext.TargetFormat değerini FileType.Unknown ile karşılaştırın ve o öğeyi dönüştürmek yerine kendi adıyla kaydedin.

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());

Bu kodu, iki ekinin ikisi de report.csv ve bir ekinin desteklenmeyen bir biçimde olduğu örnek bir destek e‑postasına yönlendirin. Üç PDF elde edilir: mesaj ve iki CSV raporu. Desteklenmeyen dosya da dokunulmadan çıkar – orijinaliyle yan yana açtığınızda 32 baytının tamamı aynı olur.

Aynı Dosya Adına Sahip Eklerin Üstüne Yazılmasını Nasıl Önleyebilirim?

Tek başına bir dosya adı, çıktının güvenli bir anahtarı olamaz; çünkü iki ek aynı adı taşıyabilir. SaveContext.ItemIndex değerini SaveContext.SourceFileName ile birleştirerek isimlendirin; böylece report.csv adlı iki ek, diskte aynı yuva için rekabet etmez; her biri kendi sıfır doldurulmuş ön ekini (02- ve 03- örnekte, mesajın 01- sonrası) ve kaynakta kullanılan adı alır.

Yan Yana: Önce vs. Sonra

Önce (Manuel) Sonra (GroupDocs.Conversion)
Time Mesaj başına dakikalar, elle Birkaç kod satırı, istenilen sayıda mesaj
Duplicate names Sessizce üzerine yazılır ItemIndex ile ayrı tutulur
Unsupported attachment Tüm dönüşümü bozar (pre-26.10) Kendi adıyla kaydedilir, işlem devam eder
Output PDF görüntüleyicinizin kaydedebildiği her şey Dosyalayıp indeksleyebileceğiniz yapılandırılmış PDF’ler

Örnek destek e‑postası tam olarak bu karışımdan oluşur: aynı ada sahip iki aylık CSV dışa aktarımı ve hiçbir dönüştürücünün tanımadığı bir yakalama dosyası.

Gerçek Dünya Örneği: Destek Desteği Arşivleme

Bir destek ekibi, her müşteri vakasını bir veya daha fazla elektronik tablo eki içeren bir e‑posta olarak kaydeder ve vaka takibi sistemi, her eki mesajdan ayrı, aranabilir bir PDF olarak dosyalamayı gerektirir. Gelen her vaka için KeepAttachmentsWithoutPdfRoute metodunu bir kez çalıştırmak, mesajı ve eklerini numaralı bir dosya setine dönüştürür; iki rapor aynı adı taşısa bile hiçbir ek bir diğerinin üzerine yazılmaz. İki aylık report.csv dışa aktarımı ve kimsenin dönüştüremediği bir yakalama dosyası içeren bir vaka e‑postası dört dosya olarak çıkar: mesaj, iki CSV raporu PDF olarak ve yakalama dosyası kendi adıyla kaydedilir – hiçbir şey düşmez, birleştirilmez, sessizce üzerine yazılmaz.

// Vaka e‑postası başına bir çağrı - manuel dışa aktarım yok, yeniden adlandırılmış kopya yok
int kept = KeepAttachmentsWithoutPdfRoute(caseMessagePath, caseOutputFolder);

GroupDocs.Conversion for .NET ile Başka Ne Yapabilirsiniz?

Mesajı eklerinden ayırmanın ötesinde, EmailLoadOptions mesajın kendisiyle ilgili daha fazla özelliği kapsar:

  • Field visibility: DisplayHeader ve ilgili Display* seçenekleriyle başlığı ve From, To, Cc, Bcc satırlarını gösterir ya da gizler (Cc ve Bcc varsayılan olarak gizlidir).
  • Localized headers: FieldTextMap ile her EmailField‘ı farklı bir başlıkla eşleştirir; örneğin Subject ve Attachments başlıklarını başka bir dile çevirir.
  • Date formatting: Sent satırı dönüşümü yapan makinenin kültürüne göre biçimlenir ve TimeZoneOffset mesaj tarihleri için kullanılan UTC kaymasını ayarlar.
  • Message-only output: PDF yalnızca mesajı temsil edecekse ConvertOwned değerini false yapın; ek adları hâlâ başlıkta referans olarak listelenir.

Her seçenek için tam EmailLoadOptions reference sayfasına bakın.

Sonuç

Eskiden bir mesajı açmak, ekleri elle kaydetmek ve üzerine yazılan kopyaları yeniden kontrol etmek anlamına gelen işlem, artık bir SaveContext geri çağrısı ve birkaç kod satırıyla yapılır. GroupDocs.Conversion for .NET, her çıktı öğesine – mesaj ve her ek – çakışmayan bir ad verir ve PDF yolu olmayan bir eki çalışmayı durdurmak yerine tutar. Aynı üç yapı taşı – ConvertOwner, ConvertOwned ve SaveContext geri çağrısı – tek bir özet PDF’den, mesaj ve tüm eklerinin çakışmasız bir şekilde ayrıntılı bir şekilde bölünmesine kadar ölçeklenir; böylece küçük başlayıp gelen kutunuzun taleplerine göre tam iş akışına büyüyebilirsiniz.

E‑mail‑to‑PDF iş akışınızı otomatikleştirmeye hazır mısınız?

Ek Kaynaklar