💡 مثال كامل يعمل متاح على GitHub:
convert-email-and-attachments-to-pdf-dotnet
تحويل البريد الإلكتروني إلى PDF هو سير عمل GroupDocs.Conversion لـ .NET يقوم بتحويل رسالة Outlook ومرفقاتها إلى ملف PDF واحد أو أكثر دون أن يقوم أحد المرفقات بالكتابة فوق آخر أو أن يتسبب ملف غير مدعوم في إيقاف العملية بأكملها. إنه يستبدل روتين التصدير وإعادة التسمية اليدوي ببضع أسطر من الشيفرة التي تعرف، لكل عنصر، من أين جاء وما إذا تم تحويله أم لا.
الطريقة القديمة كانت مؤلمة
تخيل صندوق بريد دعم حيث يحمل كل بريد إلكتروني للملف حالة مرفقين أو ثلاثة — تقرير هنا، لقطة شاشة هناك، أحيانًا تنسيق ملف لا يتعرف عليه أحد في الفريق. لا شيء في ذلك غير عادي. أرشفة تلك الحالة تعني فتح الرسالة، حفظ كل مرفق يدويًا، إعادة تسمية تلك التي تتصادم لأن نظامين صدرا ملفًا باسم report.csv، وتمنى ألا يكون أي من الملفات بتنسيق لا يستطيع عارض PDF الخاص بك فتحه. افعل ذلك خمسين مرة في الأسبوع وستصبح “التصدير السريع” أبطأ جزء في المهمة، وهو الجزء الأكثر احتمالًا أن يُعجّل، وهذا بالضبط عندما تحدث الأخطاء.
القيام بذلك يدويًا لا يكلف الوقت فقط - بل هو أيضًا المكان الذي تختفي فيه الملفات بهدوء
تختفي. احفظ مرفقين كلاهما اسمه report.csv في نفس
المجلد دون إعادة تسميتهما أولاً، وتكتب عملية الحفظ الثانية فوق
الأولى؛ لا يلاحظ أحد ذلك حتى لا تُعثر على أرقام سبتمبر.
رسالة تحتوي على مرفق واحد فقط بصيغة لا يملك أحد محولًا لها
يمكن أن تعطل عملية التصدير بأكملها حتى يقرر أحدهم ماذا يفعل بها.
التكلفة الحقيقية للقيام بذلك يدويًا: المرفق الذي يُعاد تسميته ويُستبدل لا يُظهر خطأ — يختفي بصمت، وتبدو ملف الحالة مكتملًا حتى يحتاج أحدهم إلى البيانات التي كان يحتويها.
هناك طريقة أفضل
GroupDocs.Conversion لـ .NET يحول ذلك إلى بضع أسطر من الشيفرة. لا حاجة لإعادة التسمية اليدوية. تتحكم فئة EmailLoadOptions فيما إذا كانت الرسالة أو المرفقات أو كليهما تُحوَّل، وتصف استدعاء SaveContext كل عنصر ناتج بما يكفي بحيث لا تتصادم مرفقان يحملان اسم report.csv أبدًا ولا يتوقف مرفق بلا مسار إلى PDF عن تشغيل باقي العملية. كل استدعاء لهذا الـ callback يُبلغ عن ItemIndex (عدد متسلسل يبدأ من 1)، HierarchyLevel (0 للرسالة، 1 للمرفق) وSourceFileName (اسم الملف الأصلي)، وهو ما يكفي لتكوين اسم إخراج خالٍ من التصادم دون كتابة أي سجل إضافي.
قبل أن نبدأ، ستحتاج إلى:
- .NET SDK 8.0 أو أحدث
- GroupDocs.Conversion لـ .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) يحدّ من عمق متابعة المرفقات المتداخلة.
// Convert the message itself and every attachment it carries
var loadOptions = new EmailLoadOptions
{
ConvertOwner = true,
ConvertOwned = true,
Depth = 2
};
الخطوة 2 - تسمية كل مخرج من SaveContext
مرّر استدعاء SaveContext إلى Converter.Convert بدلاً من مسار إخراج ثابت. يُستدعى الـ callback مرة لكل عنصر، مع ItemIndex فريد لكل عنصر حتى عندما يتشارك مرفقان اسم ملف.
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());
}
الخطوة 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 في الاسم، وسيتوقف مرفقان يحملان اسم report.csv عن التنافس على نفس الموقع على القرص؛ كل منهما يحصل على بادئة صفرية مملوءة (02- و 03- في العينة، بعد 01- للرسالة) وملف خاص به، مهما كان الاسم الأصلي.
جنبًا إلى جنب: قبل vs. بعد
| قبل (يدوي) | بعد (GroupDocs.Conversion) | |
|---|---|---|
| الوقت | دقائق لكل رسالة، يدويًا | بضع أسطر من الشيفرة، أي عدد من الرسائل |
| أسماء مكررة | تم الكتابة فوقها بصمت | محفوظة منفصلة عبر ItemIndex |
| مرفق غير مدعوم | يتسبب في فشل التحويل بالكامل (قبل 26.10) | محفوظ تحت اسمه الخاص، تستمر العملية |
| الإخراج | أي شيء يمكن لعارض PDF الخاص بك حفظه | ملفات PDF منظمة يمكنك حفظها أو فهرستها |
البريد الإلكتروني للدعم في العينة مبني على هذا المزيج بالضبط: تصديران شهريان لملفات CSV بنفس الاسم، وملف التقاط لا يتعرف عليه أي محول.
مثال واقعي: أرشفة حالات الدعم
يسجل فريق الدعم كل حالة عميل كبريد إلكتروني يحتوي على مرفق أو أكثر من جداول البيانات، ويحتاج نظام تتبع الحالات إلى حفظ كل مرفق كملف PDF قابل للبحث منفصل عن الرسالة. تشغيل الرسالة عبر KeepAttachmentsWithoutPdfRoute مرة لكل حالة واردة يحول الرسالة ومرفقاتها إلى مجموعة مرقمة من الملفات، دون أن يكتب أي مرفق فوق آخر حتى عندما يتشارك تقريران الاسم. بريد حالة يحتوي على تصديرين شهريين report.csv وملف التقاط بتنسيق لا يحوله أحد ينتج أربعة ملفات: الرسالة، وتقريرَي CSV كملفات PDF، وملف التقاط محفوظ باسمه الخاص — لا شيء مفقود، لا شيء مدمج، لا شيء يُكتب فوقه بصمت.
// One call per case e-mail - no manual export, no renamed duplicates
int kept = KeepAttachmentsWithoutPdfRoute(caseMessagePath, caseOutputFolder);
ماذا يمكنك أن تفعل أيضًا مع GroupDocs.Conversion لـ .NET؟
إلى جانب فصل الرسالة عن مرفقاتها، تغطي EmailLoadOptions المزيد من جوانب الرسالة نفسها:
- رؤية الحقول: إظهار أو إخفاء رأس الرسالة وأسطر
FromوToوCcوBccباستخدامDisplayHeaderوالخيارات المرتبطة بـDisplay*(CcوBccمخفيان افتراضيًا). - رؤوس محلية: ربط كل
EmailFieldبتسمية مختلفة عبرFieldTextMap، على سبيل المثال ترجمةSubjectوAttachmentsإلى لغة أخرى. - تنسيق التاريخ: سطر
Sentيتبع ثقافة الجهاز الذي يُجري التحويل، وTimeZoneOffsetيحدد إزاحة UTC المستخدمة لتواريخ الرسالة. - إخراج للرسالة فقط: اضبط
ConvertOwnedعلىfalseعندما يحتاج PDF إلى تمثيل الرسالة فقط، مع إبقاء أسماء المرفقات مدرجة في الرأس للمرجعية.
اطلع على مرجع EmailLoadOptions الكامل لكل خيار.
الخلاصة
ما كان يعني فتح رسالة، حفظ المرفقات يدويًا، وإعادة الفحص للملفات المكررة الآن يتحقق عبر استدعاء SaveContext وبضع أسطر من الشيفرة. يمنحك GroupDocs.Conversion لـ .NET لكل عنصر ناتج — الرسالة وكل مرفق — اسمًا لا يتصادم، ويحافظ على المرفق الذي لا مسار له إلى PDF بدلاً من إيقاف العملية. نفس اللبنات الثلاثة — ConvertOwner، ConvertOwned وSaveContext — تتوسع من PDF ملخص واحد إلى تفصيل كامل وآمن من الرسالة وكل مرفق تحمله، بحيث يمكنك البدء صغيرًا ثم النمو إلى سير عمل كامل حسب ما يطلب صندوق الوارد الخاص بك.
هل أنت مستعد لأتمتة سير عمل تحويل البريد الإلكتروني إلى PDF؟
- جرّب ترخيصًا مؤقتًا مجانيًا
- استكشف تحويل كل مرفق بريد إلكتروني إلى تنسيق إخراج مختلف
- اقرأ المرجع الكامل لـ EmailLoadOptions
- اطلع على مشروع العينة على GitHub