|
| 1 | +--- |
| 2 | +date: '2026-01-18' |
| 3 | +description: تعرّف على تحويل البريد الإلكتروني إلى PDF باستخدام خيارات متقدمة عبر |
| 4 | + GroupDocs.Conversion للغة Java. سيطر على رؤية حقول البريد الإلكتروني وحسّن إدارة |
| 5 | + المستندات. |
| 6 | +keywords: |
| 7 | +- convert emails to PDFs with GroupDocs |
| 8 | +- Java email conversion advanced options |
| 9 | +- control visibility in email PDF conversion |
| 10 | +title: 'تحويل البريد الإلكتروني إلى PDF في جافا باستخدام GroupDocs.Conversion: دليل |
| 11 | + الخيارات المتقدمة' |
| 12 | +type: docs |
| 13 | +url: /ar/java/pdf-conversion/convert-emails-to-pdfs-groupdocs-java/ |
| 14 | +weight: 1 |
| 15 | +--- |
| 16 | + |
| 17 | +# تحويل البريد الإلكتروني إلى PDF في جافا باستخدام GroupDocs.Conversion: دليل الخيارات المتقدمة |
| 18 | + |
| 19 | +تحويل رسائل البريد الإلكتروني إلى ملفات PDF هو طلب شائع للأرشفة والمشاركة وضمان خصوصية البيانات. في هذا البرنامج التعليمي ستتقن **تحويل البريد الإلكتروني إلى PDF** باستخدام GroupDocs.Conversion لجافا، وستتعلم كيفية إخفاء أو إظهار حقول البريد الإلكتروني المحددة، وكيفية ضبط العملية بدقة للحصول على أفضل أداء. |
| 20 | + |
| 21 | +## إجابات سريعة |
| 22 | +- **ما المكتبة التي تتعامل مع تحويل البريد الإلكتروني إلى PDF؟** GroupDocs.Conversion for Java. |
| 23 | +- **ما هو العنصر (artifact) في Maven الذي أحتاجه؟** `com.groupdocs:groupdocs-conversion`. |
| 24 | +- **هل يمكنني إخفاء تفاصيل المرسل/المستلم؟** نعم—استخدم `EmailLoadOptions` للتحكم في الرؤية. |
| 25 | +- **هل يلزم وجود ترخيص للإنتاج؟** يلزم وجود ترخيص GroupDocs صالح للاستخدام غير التجريبي. |
| 26 | +- **ما نسخة جافا المدعومة؟** Java 8 أو أعلى. |
| 27 | + |
| 28 | +## ما هو تحويل البريد الإلكتروني إلى PDF؟ |
| 29 | +تحويل البريد الإلكتروني إلى PDF يحول صيغ `.msg`، `.eml` أو صيغ البريد الإلكتروني الأخرى إلى مستند PDF ثابت ومحمول. هذه العملية تحافظ على تخطيط الرسالة الأصلي مع السماح لك بطمس المعلومات الحساسة مثل عناوين البريد الإلكتروني، رؤوس الرسالة، أو حقول CC/BCC. |
| 30 | + |
| 31 | +## لماذا تستخدم GroupDocs.Conversion لجافا؟ |
| 32 | +توفر GroupDocs.Conversion واجهة برمجة تطبيقات بسيطة، ودعم قوي للعديد من الصيغ، وخيارات تحميل دقيقة تتيح لك تحديد الأجزاء التي تريد ظهورها من البريد الإلكتروني في ملف PDF النهائي. كما أنها تتكامل بسلاسة مع Maven، مما يجعل إدارة التبعيات سهلة. |
| 33 | + |
| 34 | +## المتطلبات المسبقة |
| 35 | +- **مجموعة تطوير جافا (JDK) 8+** مثبتة. |
| 36 | +- **Maven** لإدارة التبعيات (انظر قسم *groupdocs conversion maven* أدناه). |
| 37 | +- إلمام أساسي بجافا ومشاريع Maven. |
| 38 | + |
| 39 | +## إعداد GroupDocs.Conversion لجافا |
| 40 | + |
| 41 | +للبدء، أضف مستودع GroupDocs واعتماد التحويل إلى ملف `pom.xml` الخاص بك. هذا هو تكوين **groupdocs conversion maven** الذي ستحتاجه. |
| 42 | + |
| 43 | +```xml |
| 44 | +<repositories> |
| 45 | + <repository> |
| 46 | + <id>repository.groupdocs.com</id> |
| 47 | + <name>GroupDocs Repository</name> |
| 48 | + <url>https://releases.groupdocs.com/conversion/java/</url> |
| 49 | + </repository> |
| 50 | +</repositories> |
| 51 | + |
| 52 | +<dependencies> |
| 53 | + <dependency> |
| 54 | + <groupId>com.groupdocs</groupId> |
| 55 | + <artifactId>groupdocs-conversion</artifactId> |
| 56 | + <version>25.2</version> |
| 57 | + </dependency> |
| 58 | +</dependencies> |
| 59 | +``` |
| 60 | + |
| 61 | +### الحصول على الترخيص |
| 62 | +- **تجربة مجانية** – استكشف جميع الميزات دون تكلفة. |
| 63 | +- **ترخيص مؤقت** – اطلب مفتاحًا قصير الأمد للتقييم الموسع. |
| 64 | +- **شراء** – احصل على ترخيص كامل للنشر في بيئة الإنتاج. |
| 65 | + |
| 66 | +## دليل التنفيذ |
| 67 | + |
| 68 | +### تحويل البريد الإلكتروني إلى PDF مع خيارات متقدمة |
| 69 | + |
| 70 | +فيما يلي دليل خطوة بخطوة يوضح كيفية **تحويل msg إلى pdf** مع تخصيص رؤية الحقول. |
| 71 | + |
| 72 | +#### الخطوة 1: تكوين خيارات تحميل البريد الإلكتروني |
| 73 | +أنشئ كائن `EmailLoadOptions` وأوقف الحقول التي لا تريد ظهورها في ملف PDF. |
| 74 | + |
| 75 | +```java |
| 76 | +import com.groupdocs.conversion.options.load.EmailLoadOptions; |
| 77 | + |
| 78 | +EmailLoadOptions loadOptions = new EmailLoadOptions(); |
| 79 | +loadOptions.setDisplayHeader(false); |
| 80 | +loadOptions.setDisplayFromEmailAddress(false); |
| 81 | +loadOptions.setDisplayToEmailAddress(false); |
| 82 | +loadOptions.setDisplayEmailAddress(false); |
| 83 | +loadOptions.setDisplayCcEmailAddress(false); |
| 84 | +loadOptions.setDisplayBccEmailAddress(false); |
| 85 | +loadOptions.setConvertOwned(false); // Prevent conversion of fields that are owned by the document |
| 86 | +``` |
| 87 | + |
| 88 | +#### الخطوة 2: تهيئة المحول |
| 89 | +مرّر خيارات التحميل المكوّنة عند إنشاء كائن `Converter`. |
| 90 | + |
| 91 | +```java |
| 92 | +import com.groupdocs.conversion.Converter; |
| 93 | +import com.groupdocs.conversion.options.convert.PdfConvertOptions; |
| 94 | + |
| 95 | +Converter converter = new Converter("YOUR_DOCUMENT_DIRECTORY/SAMPLE_MSG", () -> loadOptions); |
| 96 | +``` |
| 97 | + |
| 98 | +#### الخطوة 3: ضبط خيارات تحويل PDF |
| 99 | +يمكنك تخصيص مخرجات PDF أكثر باستخدام `PdfConvertOptions`. في هذا المثال، الإعدادات الافتراضية كافية. |
| 100 | + |
| 101 | +```java |
| 102 | +PdfConvertOptions options = new PdfConvertOptions(); |
| 103 | +``` |
| 104 | + |
| 105 | +#### الخطوة 4: تنفيذ التحويل |
| 106 | +استدعِ طريقة `convert`، مع توفير مسار الوجهة والخيارات المعرفة أعلاه. |
| 107 | + |
| 108 | +```java |
| 109 | +converter.convert("YOUR_OUTPUT_DIRECTORY/ConvertEmailWithAlteringFieldsVisibility.pdf", options); |
| 110 | +``` |
| 111 | + |
| 112 | +### خيارات التحميل حسب نوع المستند |
| 113 | +فهم كيفية تحميل أنواع المستندات المختلفة أمر أساسي للتحويلات المرنة. فيما يلي مثال مركّز للبريد الإلكتروني. |
| 114 | + |
| 115 | +#### الخطوة 1: تكوين خيارات تحميل البريد الإلكتروني (مُعاد الاستخدام) |
| 116 | + |
| 117 | +```java |
| 118 | +import com.groupdocs.conversion.options.load.EmailLoadOptions; |
| 119 | + |
| 120 | +EmailLoadOptions emailLoadOptions = new EmailLoadOptions(); |
| 121 | +emailLoadOptions.setDisplayHeader(false); |
| 122 | +emailLoadOptions.setDisplayFromEmailAddress(false); |
| 123 | +emailLoadOptions.setDisplayToEmailAddress(false); |
| 124 | +emailLoadOptions.setDisplayEmailAddress(false); |
| 125 | +emailLoadOptions.setDisplayCcEmailAddress(false); |
| 126 | +emailLoadOptions.setDisplayBccEmailAddress(false); |
| 127 | +emailLoadOptions.setConvertOwned(false); // Do not convert owned fields |
| 128 | +``` |
| 129 | + |
| 130 | +#### الخطوة 2: تهيئة المحول مع خيارات تحميل البريد الإلكتروني |
| 131 | + |
| 132 | +```java |
| 133 | +Converter emailConverter = new Converter("EMAIL_FILE_PATH", () -> emailLoadOptions); |
| 134 | +``` |
| 135 | + |
| 136 | +## التطبيقات العملية |
| 137 | +فيما يلي ثلاث سيناريوهات واقعية حيث يبرز **تحويل البريد الإلكتروني إلى PDF**: |
| 138 | + |
| 139 | +1. **الوثائق القانونية** – طمّس البيانات الشخصية قبل مشاركة أدلة البريد الإلكتروني مع العملاء. |
| 140 | +2. **الأرشفة المؤسسية** – احفظ الاتصالات الداخلية بصيغة موحدة للقراءة فقط. |
| 141 | +3. **التنظيم الشخصي** – احتفظ بأرشيف PDF نظيف للرسائل المهمة دون كشف عناوين غير ضرورية. |
| 142 | + |
| 143 | +## اعتبارات الأداء |
| 144 | +- **تحسين حجم الملفات** – عالج دفعات أصغر أو اضغط ملفات PDF بعد التحويل. |
| 145 | +- **إدارة الذاكرة** – استفد من جامع القمامة في جافا وتجنب تحميل رسائل بريد إلكتروني ضخمة إلى الذاكرة دفعة واحدة. |
| 146 | +- **ابقَ محدثًا** – قم بترقية نسخة GroupDocs.Conversion إلى أحدث إصدار بانتظام للحصول على تحسينات الأداء. |
| 147 | + |
| 148 | +## المشكلات الشائعة والحلول |
| 149 | +| المشكلة | السبب | الحل | |
| 150 | +|-------|-------|----------| |
| 151 | +| OutOfMemoryError على ملفات `.msg` الكبيرة | تم تحميل الملف بالكامل في الذاكرة | قم ببث محتوى البريد الإلكتروني أو زيادة حجم ذاكرة JVM (`-Xmx2g`). | |
| 152 | +| فقدان جسم البريد الإلكتروني في PDF | `displayHeader` تم تعيينه إلى `true` بينما تم إخفاء الجسم | تأكد من أن `setDisplayHeader(false)` يخفي الرؤوس فقط؛ يبقى الجسم مرئيًا. | |
| 153 | +| الترخيص غير معترف به | استخدام مفتاح تجريبي في بيئة الإنتاج | استبدله بملف ترخيص إنتاج صالح أو سلسلة ترخيص. | |
| 154 | + |
| 155 | +## الأسئلة المتكررة |
| 156 | + |
| 157 | +**س: ما هو GroupDocs.Conversion لجافا؟** |
| 158 | +ج: إنها مكتبة جافا تمكّن من التحويل بين أكثر من 100 صيغة ملف، بما في ذلك تحويل البريد الإلكتروني إلى PDF. |
| 159 | + |
| 160 | +**س: كيف أضمن خصوصية البريد الإلكتروني أثناء التحويل؟** |
| 161 | +ج: استخدم `EmailLoadOptions` لإيقاف الحقول مثل المرسل، المستلم، وعناوين CC/BCC قبل التحويل. |
| 162 | + |
| 163 | +**س: هل يمكنني تحويل أنواع مستندات أخرى غير البريد الإلكتروني؟** |
| 164 | +ج: نعم، تدعم المكتبة Word وExcel وPowerPoint والصور والعديد من الصيغ الأخرى. |
| 165 | + |
| 166 | +**س: ما هي متطلبات الذاكرة لتحويل رسائل بريد إلكتروني كبيرة؟** |
| 167 | +ج: خصص مساحة كافية للذاكرة (مثلاً `-Xmx2g`) وفكّر في معالجة الملفات على دفعات. |
| 168 | + |
| 169 | +**س: أين يمكنني العثور على مزيد من المعلومات حول GroupDocs.Conversion؟** |
| 170 | +ج: زر [الوثائق الرسمية](https://docs.groupdocs.com/conversion/java/) و[مرجع API](https://reference.groupdocs.com/conversion/java/). |
| 171 | + |
| 172 | +## الموارد |
| 173 | +- **الوثائق**: [GroupDocs.Conversion for Java Docs](https://docs.groupdocs.com/conversion/java/) |
| 174 | +- **مرجع API**: [GroupDocs.Conversion API Reference](https://reference.groupdocs.com/conversion/java/) |
| 175 | + |
| 176 | +--- |
| 177 | + |
| 178 | +**Last Updated:** 2026-01-18 |
| 179 | +**Tested With:** GroupDocs.Conversion 25.2 |
| 180 | +**Author:** GroupDocs |
0 commit comments