Skip to content

_index.md

Latest commit

 

History

History
180 lines (137 loc) · 10.6 KB

_index.md

File metadata and controls

180 lines (137 loc) · 10.6 KB
date 2026-01-18
description تعرّف على تحويل البريد الإلكتروني إلى PDF باستخدام خيارات متقدمة عبر GroupDocs.Conversion للغة Java. سيطر على رؤية حقول البريد الإلكتروني وحسّن إدارة المستندات.
keywords
convert emails to PDFs with GroupDocs
Java email conversion advanced options
control visibility in email PDF conversion
title تحويل البريد الإلكتروني إلى PDF في جافا باستخدام GroupDocs.Conversion: دليل الخيارات المتقدمة
type docs
url /ar/java/pdf-conversion/convert-emails-to-pdfs-groupdocs-java/
weight 1

تحويل البريد الإلكتروني إلى PDF في جافا باستخدام GroupDocs.Conversion: دليل الخيارات المتقدمة

تحويل رسائل البريد الإلكتروني إلى ملفات PDF هو طلب شائع للأرشفة والمشاركة وضمان خصوصية البيانات. في هذا البرنامج التعليمي ستتقن تحويل البريد الإلكتروني إلى PDF باستخدام GroupDocs.Conversion لجافا، وستتعلم كيفية إخفاء أو إظهار حقول البريد الإلكتروني المحددة، وكيفية ضبط العملية بدقة للحصول على أفضل أداء.

إجابات سريعة

  • ما المكتبة التي تتعامل مع تحويل البريد الإلكتروني إلى PDF؟ GroupDocs.Conversion for Java.
  • ما هو العنصر (artifact) في Maven الذي أحتاجه؟ com.groupdocs:groupdocs-conversion.
  • هل يمكنني إخفاء تفاصيل المرسل/المستلم؟ نعم—استخدم EmailLoadOptions للتحكم في الرؤية.
  • هل يلزم وجود ترخيص للإنتاج؟ يلزم وجود ترخيص GroupDocs صالح للاستخدام غير التجريبي.
  • ما نسخة جافا المدعومة؟ Java 8 أو أعلى.

ما هو تحويل البريد الإلكتروني إلى PDF؟

تحويل البريد الإلكتروني إلى PDF يحول صيغ .msg، .eml أو صيغ البريد الإلكتروني الأخرى إلى مستند PDF ثابت ومحمول. هذه العملية تحافظ على تخطيط الرسالة الأصلي مع السماح لك بطمس المعلومات الحساسة مثل عناوين البريد الإلكتروني، رؤوس الرسالة، أو حقول CC/BCC.

لماذا تستخدم GroupDocs.Conversion لجافا؟

توفر GroupDocs.Conversion واجهة برمجة تطبيقات بسيطة، ودعم قوي للعديد من الصيغ، وخيارات تحميل دقيقة تتيح لك تحديد الأجزاء التي تريد ظهورها من البريد الإلكتروني في ملف PDF النهائي. كما أنها تتكامل بسلاسة مع Maven، مما يجعل إدارة التبعيات سهلة.

المتطلبات المسبقة

  • مجموعة تطوير جافا (JDK) 8+ مثبتة.
  • Maven لإدارة التبعيات (انظر قسم groupdocs conversion maven أدناه).
  • إلمام أساسي بجافا ومشاريع Maven.

إعداد GroupDocs.Conversion لجافا

للبدء، أضف مستودع GroupDocs واعتماد التحويل إلى ملف pom.xml الخاص بك. هذا هو تكوين groupdocs conversion maven الذي ستحتاجه.

<repositories>
    <repository>
        <id>repository.groupdocs.com</id>
        <name>GroupDocs Repository</name>
        <url>https://releases.groupdocs.com/conversion/java/</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-conversion</artifactId>
        <version>25.2</version>
    </dependency>
</dependencies>

الحصول على الترخيص

  • تجربة مجانية – استكشف جميع الميزات دون تكلفة.
  • ترخيص مؤقت – اطلب مفتاحًا قصير الأمد للتقييم الموسع.
  • شراء – احصل على ترخيص كامل للنشر في بيئة الإنتاج.

دليل التنفيذ

تحويل البريد الإلكتروني إلى PDF مع خيارات متقدمة

فيما يلي دليل خطوة بخطوة يوضح كيفية تحويل msg إلى pdf مع تخصيص رؤية الحقول.

الخطوة 1: تكوين خيارات تحميل البريد الإلكتروني

أنشئ كائن EmailLoadOptions وأوقف الحقول التي لا تريد ظهورها في ملف PDF.

import com.groupdocs.conversion.options.load.EmailLoadOptions;

EmailLoadOptions loadOptions = new EmailLoadOptions();
loadOptions.setDisplayHeader(false);
loadOptions.setDisplayFromEmailAddress(false);
loadOptions.setDisplayToEmailAddress(false);
loadOptions.setDisplayEmailAddress(false);
loadOptions.setDisplayCcEmailAddress(false);
loadOptions.setDisplayBccEmailAddress(false);
loadOptions.setConvertOwned(false); // Prevent conversion of fields that are owned by the document

الخطوة 2: تهيئة المحول

مرّر خيارات التحميل المكوّنة عند إنشاء كائن Converter.

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;

Converter converter = new Converter("YOUR_DOCUMENT_DIRECTORY/SAMPLE_MSG", () -> loadOptions);

الخطوة 3: ضبط خيارات تحويل PDF

يمكنك تخصيص مخرجات PDF أكثر باستخدام PdfConvertOptions. في هذا المثال، الإعدادات الافتراضية كافية.

PdfConvertOptions options = new PdfConvertOptions();

الخطوة 4: تنفيذ التحويل

استدعِ طريقة convert، مع توفير مسار الوجهة والخيارات المعرفة أعلاه.

converter.convert("YOUR_OUTPUT_DIRECTORY/ConvertEmailWithAlteringFieldsVisibility.pdf", options);

خيارات التحميل حسب نوع المستند

فهم كيفية تحميل أنواع المستندات المختلفة أمر أساسي للتحويلات المرنة. فيما يلي مثال مركّز للبريد الإلكتروني.

الخطوة 1: تكوين خيارات تحميل البريد الإلكتروني (مُعاد الاستخدام)

import com.groupdocs.conversion.options.load.EmailLoadOptions;

EmailLoadOptions emailLoadOptions = new EmailLoadOptions();
emailLoadOptions.setDisplayHeader(false);
emailLoadOptions.setDisplayFromEmailAddress(false);
emailLoadOptions.setDisplayToEmailAddress(false);
emailLoadOptions.setDisplayEmailAddress(false);
emailLoadOptions.setDisplayCcEmailAddress(false);
emailLoadOptions.setDisplayBccEmailAddress(false);
emailLoadOptions.setConvertOwned(false); // Do not convert owned fields

الخطوة 2: تهيئة المحول مع خيارات تحميل البريد الإلكتروني

Converter emailConverter = new Converter("EMAIL_FILE_PATH", () -> emailLoadOptions);

التطبيقات العملية

فيما يلي ثلاث سيناريوهات واقعية حيث يبرز تحويل البريد الإلكتروني إلى PDF:

  1. الوثائق القانونية – طمّس البيانات الشخصية قبل مشاركة أدلة البريد الإلكتروني مع العملاء.
  2. الأرشفة المؤسسية – احفظ الاتصالات الداخلية بصيغة موحدة للقراءة فقط.
  3. التنظيم الشخصي – احتفظ بأرشيف PDF نظيف للرسائل المهمة دون كشف عناوين غير ضرورية.

اعتبارات الأداء

  • تحسين حجم الملفات – عالج دفعات أصغر أو اضغط ملفات PDF بعد التحويل.
  • إدارة الذاكرة – استفد من جامع القمامة في جافا وتجنب تحميل رسائل بريد إلكتروني ضخمة إلى الذاكرة دفعة واحدة.
  • ابقَ محدثًا – قم بترقية نسخة GroupDocs.Conversion إلى أحدث إصدار بانتظام للحصول على تحسينات الأداء.

المشكلات الشائعة والحلول

المشكلة السبب الحل
OutOfMemoryError على ملفات .msg الكبيرة تم تحميل الملف بالكامل في الذاكرة قم ببث محتوى البريد الإلكتروني أو زيادة حجم ذاكرة JVM (-Xmx2g).
فقدان جسم البريد الإلكتروني في PDF displayHeader تم تعيينه إلى true بينما تم إخفاء الجسم تأكد من أن setDisplayHeader(false) يخفي الرؤوس فقط؛ يبقى الجسم مرئيًا.
الترخيص غير معترف به استخدام مفتاح تجريبي في بيئة الإنتاج استبدله بملف ترخيص إنتاج صالح أو سلسلة ترخيص.

الأسئلة المتكررة

س: ما هو GroupDocs.Conversion لجافا؟
ج: إنها مكتبة جافا تمكّن من التحويل بين أكثر من 100 صيغة ملف، بما في ذلك تحويل البريد الإلكتروني إلى PDF.

س: كيف أضمن خصوصية البريد الإلكتروني أثناء التحويل؟
ج: استخدم EmailLoadOptions لإيقاف الحقول مثل المرسل، المستلم، وعناوين CC/BCC قبل التحويل.

س: هل يمكنني تحويل أنواع مستندات أخرى غير البريد الإلكتروني؟
ج: نعم، تدعم المكتبة Word وExcel وPowerPoint والصور والعديد من الصيغ الأخرى.

س: ما هي متطلبات الذاكرة لتحويل رسائل بريد إلكتروني كبيرة؟
ج: خصص مساحة كافية للذاكرة (مثلاً -Xmx2g) وفكّر في معالجة الملفات على دفعات.

س: أين يمكنني العثور على مزيد من المعلومات حول GroupDocs.Conversion؟
ج: زر الوثائق الرسمية ومرجع API.

الموارد

Last Updated: 2026-01-18
Tested With: GroupDocs.Conversion 25.2
Author: GroupDocs