Skip to content

Latest commit

 

History

History
314 lines (245 loc) · 19.4 KB

File metadata and controls

314 lines (245 loc) · 19.4 KB
date 2026-07-06
description تعلم كيفية استخدام GroupDocs.Conversion لإنشاء PDF من Excel في Java مع تحويل Excel PDF صفحة واحدة واستبدال الخط لضمان طباعة متسقة.
keywords
excel pdf one page
generate pdf from excel
convert excel to pdf java
schemas
author dateModified description headline type
GroupDocs
2026-07-06
Learn how to use GroupDocs.Conversion to generate pdf from excel in Java with excel pdf one page conversion and font substitution for consistent typography.
Excel PDF One Page – Java Conversion with Font Substitution
TechArticle
description name steps type
Learn how to use GroupDocs.Conversion to generate pdf from excel in Java with excel pdf one page conversion and font substitution for consistent typography.
Excel PDF One Page – Java Conversion with Font Substitution
name text
Define Input and Output Paths
Set the source Excel file and the destination PDF file. Use absolute paths for production environments to avoid classpath ambiguities.
name text
Create Load Options with Font Substitutes
The `SpreadsheetLoadOptions` class lets you specify how the source workbook should be interpreted. `SpreadsheetLoadOptions` is the configuration object that controls how Excel files are loaded into GroupDocs.Conversion. `FontSubstitute` defines a mapping from a missing font to an available replaceme
name text
Enable One Page per Sheet and Set a Default Font
You can enforce a single‑page layout and provide a fallback font for any characters that lack a direct match: > **Direct answer:** `setOnePagePerSheet(true)` forces each worksheet onto its own PDF page, while `setDefaultFont` supplies a universal fallback, eliminating missing‑glyph issues.
name text
Initialize the Converter with Load Options
`Converter` is the main class that performs document conversion using the provided load options. Pass the load options to the `Converter` constructor. This creates a ready‑to‑use conversion engine: > **Direct answer:** Instantiating `Converter` with the configured `loadOptions` prepares the engine t
name text
Define PDF Conversion Options and Execute
`PdfConvertOptions` configures PDF‑specific output parameters such as page size and compression. Specify the output format and any PDF‑specific settings, then run the conversion: > **Direct answer:** Calling `converter.convert` with `PdfConvertOptions` writes a PDF that honors the one‑page‑per‑sheet
HowTo
questions type
answer question
It is a Java library that converts over 50 document formats—including Excel to PDF—while offering advanced options like font substitution and one page per sheet.
What is GroupDocs.Conversion Java used for?
answer question
Yes, a free trial or temporary license provides full feature access for evaluation purposes.
Can I use GroupDocs.Conversion without purchasing a license?
answer question
Define `FontSubstitute` objects inside `SpreadsheetLoadOptions`; the engine swaps unavailable fonts with the ones you specify automatically.
How do I handle missing fonts during conversion?
answer question
Use streaming I/O, configure appropriate JVM heap sizes, and reuse a single `Converter` instance for multiple files.
What are best practices for optimizing Java performance with GroupDocs.Conversion?
answer question
No, charts are automatically scaled to fit the single page while preserving visual fidelity.
Does the “one page per sheet” option affect chart rendering?
FAQPage
title Excel PDF صفحة واحدة – تحويل Java مع استبدال الخط
type docs
url /ar/java/pdf-conversion/excel-to-pdf-conversion-font-substitution-java/
weight 1

Excel PDF صفحة واحدة – تحويل Java مع استبدال الخط

تحويل مصنف Excel إلى PDF مع ضمان صفحة واحدة لكل ورقة والحفاظ على الخط الأصلي يمكن أن يكون صعبًا. في هذا البرنامج التعليمي ستتعلم كيفية تحقيق تحويل excel pdf one page موثوق في Java باستخدام GroupDocs.Conversion. سنستعرض إعداد Maven، استبدال الخطوط، واستدعاءات API الدقيقة التي تحتاجها، حتى تتمكن من دمج الحل في أي خط أنابيب مستندات مؤتمت بثقة.

إجابات سريعة

  • ماذا يعني “صفحة واحدة لكل ورقة”؟ يتم عرض كل ورقة عمل على صفحة PDF واحدة، مما يمنع فواصل الصفحات غير المتوقعة.
  • أي مكتبة تتعامل مع التحويل؟ GroupDocs.Conversion for Java توفر مجموعة الميزات الكاملة.
  • هل يمكنني استبدال الخطوط المفقودة تلقائيًا؟ نعم—استخدم ميزة FontSubstitute داخل SpreadsheetLoadOptions.
  • هل أحتاج إلى ترخيص؟ الترخيص المؤقت يفتح جميع خيارات التحويل أثناء التقييم.
  • هل هذا النهج مناسب لمصنفات Excel الكبيرة؟ بالتأكيد، عندما تقوم بضبط ذاكرة JVM وإعادة استخدام كائن Converter.

ما هو تحويل excel pdf صفحة واحدة؟

excel pdf one page conversion هو عملية تحويل كل ورقة عمل Excel إلى مستند PDF منفصل بصفحة واحدة. هذا يضمن ترقيم صفحات متوقع، وهو أمر أساسي للتقارير والفواتير والملفات التنظيمية حيث يجب أن يبقى تخطيط الصفحة ثابتًا. كما أنه يبسط المعالجة اللاحقة ويضمن بدء كل ورقة على صفحة جديدة دون تعديلات يدوية.

لماذا تستخدم GroupDocs.Conversion Java لتحويل Excel إلى PDF؟

GroupDocs.Conversion يدعم أكثر من 50 تنسيقًا للإدخال والإخراج ويمكنه معالجة مصنفات تحتوي على مئات الأوراق دون تحميل الملف بالكامل في الذاكرة. المكتبة تقدم أيضًا استبدال الخطوط مدمجًا، مما يضمن أن تبدو ملفات PDF متطابقة على أي جهاز—even عندما تكون الخطوط الأصلية غير متوفرة. هذه القدرات الكمية تجعلها خيارًا جاهزًا للإنتاج لأتمتة المستندات على مستوى المؤسسات.

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

قبل البدء، تأكد من وجود ما يلي:

  • Java Development Kit (JDK) 11+ مثبت.
  • بيئة تطوير متكاملة مثل IntelliJ IDEA أو Eclipse لتحرير وتشغيل كود Java.
  • Maven لإدارة الاعتمادات.
  • ترخيص GroupDocs مؤقت (يمكنك الحصول عليه من الموقع الرسمي).

فهم أساسي لبنية Java وإحداثيات Maven سيساعد، لكن الخطوات أدناه مفصلة بما يكفي للمطورين من جميع المستويات.

كيف تقوم بإعداد Maven لـ GroupDocs.Conversion؟

أضف مستودع GroupDocs واعتماد التحويل إلى ملف pom.xml الخاص بك. المقتطف التالي يوضح XML الدقيق الذي تحتاجه—استبدل رقم الإصدار بأحدث إصدار ثابت إذا كان هناك إصدار أحدث. بعد تحديث pom.xml، نفّذ mvn clean install لتنزيل المكتبة والتحقق من حل الاعتمادات بشكل صحيح.

<repositories>
    <repository>
        <id>groupdocs-repo</id>
        <url>https://repo.groupdocs.com/maven2</url>
    </repository>
</repositories>

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

Direct answer: أضف XML المستودع والاعتماد أعلاه إلى pom.xml، ثم نفّذ mvn clean install لتنزيل المكتبة. هذا يجهّز مشروعك لاستدعاءات API التحويل.

كيف تحصل على وتركيب ترخيص GroupDocs مؤقت؟

قم بزيارة صفحة الترخيص المؤقت لـ GroupDocs، اطلب مفتاحًا، وضع ملف GroupDocs.Conversion.lic في مجلد الموارد (resources) الخاص بالمشروع. ثم قم بتحميله أثناء وقت التشغيل. تحميل الترخيص يضمن أن جميع الميزات المتميزة، مثل استبدال الخطوط وعرض صفحة واحدة لكل ورقة، مفتوحة وأن عملية التحويل تعمل دون قيود التقييم.

License license = new License();
license.setLicense("path/to/GroupDocs.Conversion.lic");

Direct answer: حمّل ملف الترخيص باستخدام License#setLicense قبل أي عملية تحويل؛ هذا يفتح جميع الميزات المتميزة، بما في ذلك استبدال الخطوط وعرض صفحة واحدة لكل ورقة.

دليل التنفيذ – استبدال الخط مع صفحة واحدة لكل ورقة

فيما يلي نستعرض كل خطوة مطلوبة لتحويل ملف Excel إلى PDF مع استبدال الخطوط المفقودة وإجبار كل ورقة عمل على صفحة واحدة.

الخطوة 1: تحديد مسارات الإدخال والإخراج

حدد ملف Excel المصدر وملف PDF الوجهة. استخدم مسارات مطلقة لبيئات الإنتاج لتجنب الغموض في classpath.

String inputPath = "C:/documents/input.xlsx";
String outputPath = "C:/documents/output.pdf";

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

فئة SpreadsheetLoadOptions تسمح لك بتحديد كيفية تفسير مصنف المصدر.
SpreadsheetLoadOptions هو كائن التكوين الذي يتحكم في كيفية تحميل ملفات Excel إلى GroupDocs.Conversion.

FontSubstitute يعرّف خريطة من خط مفقود إلى بديل متاح.

الآن أضف بدائل الخطوط:

SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
loadOptions.getFontSubstitutes().add(new FontSubstitute("Calibri", "Arial"));
loadOptions.getFontSubstitutes().add(new FontSubstitute("Times New Roman", "Liberation Serif"));

Direct answer: بإضافة إدخالات FontSubstitute، يقوم المحول تلقائيًا بتبديل الخطوط المفقودة بالبدائل المحددة، مما يضمن اتساقًا بصريًا عبر المنصات.

الخطوة 3: تمكين صفحة واحدة لكل ورقة وتعيين خط افتراضي

يمكنك فرض تخطيط صفحة واحدة وتوفير خط احتياطي لأي أحرف لا توجد لها مطابقة مباشرة:

loadOptions.setOnePagePerSheet(true);
loadOptions.setDefaultFont("Arial");

Direct answer: setOnePagePerSheet(true) يجبر كل ورقة عمل على صفحة PDF خاصة بها، بينما setDefaultFont يوفر خطًا عالميًا احتياطيًا، مما يلغي مشاكل الحروف المفقودة.

الخطوة 4: تهيئة Converter مع خيارات التحميل

Converter هو الفئة الرئيسية التي تنفّذ تحويل المستند باستخدام خيارات التحميل المقدمة.
مرّر خيارات التحميل إلى مُنشئ Converter. هذا ينشئ محرك تحويل جاهز للاستخدام:

Converter converter = new Converter(new File(inputPath), loadOptions);

Direct answer: إنشاء كائن Converter باستخدام loadOptions المكوّن يجهّز المحرك لاحترام كل من استبدال الخطوط وقواعد الترقيم أثناء التحويل.

الخطوة 5: تعريف خيارات تحويل PDF وتنفيذها

PdfConvertOptions يكوّن معلمات الإخراج الخاصة بـ PDF مثل حجم الصفحة والضغط.
حدد تنسيق الإخراج وأي إعدادات خاصة بـ PDF، ثم نفّذ التحويل:

PdfConvertOptions pdfOptions = new PdfConvertOptions();
converter.convert(outputPath, pdfOptions);

Direct answer: استدعاء converter.convert مع PdfConvertOptions يولّد PDF يطبق إعداد صفحة واحدة لكل ورقة ويضم جميع بدائل الخطوط التي عرّفتها مسبقًا.

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

  • Missing Fonts: تحقق من تثبيت الخطوط البديلة على الجهاز المضيف أو تضمينها داخل ملف JAR الخاص بتطبيقك.
  • Path Errors: استخدم Paths.get(...) للتعامل مع المسارات بشكل مستقل عن النظام الأساسي، خاصةً عند النشر على خوادم Linux.
  • Out‑of‑Memory for Very Large Workbooks: زد حجم heap الخاص بـ JVM (-Xmx4g) أو عالج الأوراق على دفعات بإعادة إنشاء كائن Converter لكل ورقة عمل.

التطبيقات العملية لتحويل excel pdf صفحة واحدة

  1. Financial Reporting: يضمن أن كل ورقة (الميزانية، بيان الدخل، التدفق النقدي) تبدأ على صفحة جديدة، مما يبسط مراجعات التدقيق.
  2. Legal Contracts: يحافظ على التخطيط الدقيق وتطابق الخطوط، وهو أمر حاسم للاتفاقيات القابلة للتنفيذ.
  3. Academic Publishing: يضمن أن جداول البيانات البحثية تحتفظ بتنسيقها عند مشاركتها كملفات PDF.
  4. Marketing Collateral: يولّد كتيبات جاهزة للطباعة من قوالب تصميم مبنية على Excel دون تعديل يدوي.
  5. Document Management Systems: يوفر معاينات PDF موثوقة لملفات Excel المرفوعة، مما يحسن تجربة المستخدم.

نصائح الأداء لمصنفات Excel الكبيرة

  • Stream I/O: استخدم InputStream/OutputStream لتجنب تحميل الملف بالكامل في الذاكرة.
  • Reuse Converter: للوظائف الدفعية، احتفظ بكائن Converter واحد فعال فقط وغيّر مرجع ملف الإدخال حسب الحاجة.
  • JVM Tuning: اضبط -Xms و -Xmx بناءً على حجم المصنف المتوقع؛ مصنف بصفحات 500 عادةً يحتاج إلى heap بحجم 2‑3 GB.

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

Q: What is GroupDocs.Conversion Java used for?
A: It is a Java library that converts over 50 document formats—including Excel to PDF—while offering advanced options like font substitution and one page per sheet.

Q: Can I use GroupDocs.Conversion without purchasing a license?
A: Yes, a free trial or temporary license provides full feature access for evaluation purposes.

Q: How do I handle missing fonts during conversion?
A: Define FontSubstitute objects inside SpreadsheetLoadOptions; the engine swaps unavailable fonts with the ones you specify automatically.

Q: What are best practices for optimizing Java performance with GroupDocs.Conversion?
A: Use streaming I/O, configure appropriate JVM heap sizes, and reuse a single Converter instance for multiple files.

Q: Does the “one page per sheet” option affect chart rendering?
A: No, charts are automatically scaled to fit the single page while preserving visual fidelity.

الخلاصة

أنت الآن تمتلك طريقة كاملة وجاهزة للإنتاج لتحويل Excel إلى PDF في Java مع ترقيم صفحة واحدة لكل ورقة واستبدال الخطوط تلقائيًا باستخدام GroupDocs.Conversion. هذا الحل يقدّم طباعة ثابتة، ترقيمًا متوقعًا، ويتعامل بكفاءة مع المصنفات الكبيرة—مما يجعله مثاليًا للتقارير الآلية، إنشاء المستندات القانونية، وأي سيناريو يتطلب دقة PDF.

الخطوات التالية

  • جرّب PdfConvertOptions لتمكين التوافق مع PDF/A لأغراض الأرشفة.
  • دمج خط أنابيب التحويل هذا مع GroupDocs.Annotation لإضافة علامات مائية أو توقيعات رقمية بعد إنشاء PDF.
  • استكشف تحويل صيغ أخرى (Word، PowerPoint) باستخدام نفس النمط لإنشاء خدمة معالجة مستندات موحدة.

Last Updated: 2026-07-06
Tested With: GroupDocs.Conversion 25.2
Author: GroupDocs

<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>
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;

public class ConvertExcelToPDF {
    public static void main(String[] args) {
        String inputDocument = "sample.xlsx";
        String convertedFile = "output.pdf";

        // Initialize the Converter object with your document path
        Converter converter = new Converter(inputDocument);

        PdfConvertOptions options = new PdfConvertOptions();
        
        // Perform the conversion
        converter.convert(convertedFile, options);
    }
}
String inputDocument = "YOUR_DOCUMENT_DIRECTORY/sample.xlsx";
String convertedFile = "YOUR_OUTPUT_DIRECTORY/ConvertSpreadsheetBySpecifyingFontsubstitution.pdf";
import com.groupdocs.conversion.options.load.SpreadsheetLoadOptions;
import com.groupdocs.conversion.contracts.FontSubstitute;

List<FontSubstitute> fontSubstitutes = new ArrayList<>();
fontSubstitutes.add(FontSubstitute.create("Tahoma", "Arial")); // Substitute Tahoma with Arial
fontSubstitutes.add(FontSubstitute.create("Times New Roman", "Arial")); // Substitute Times New Roman with Arial

SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
loadOptions.setFontSubstitutes(fontSubstitutes);
loadOptions.setDefaultFont("resources/fonts/Helvetica.ttf");
loadOptions.setOnePagePerSheet(true);
Converter converter = new Converter(inputDocument, () -> loadOptions);
PdfConvertOptions options = new PdfConvertOptions();
converter.convert(convertedFile, options);

دروس ذات صلة