Skip to content

_index.md

Latest commit

 

History

History
185 lines (141 loc) · 10.5 KB

_index.md

File metadata and controls

185 lines (141 loc) · 10.5 KB
date 2026-04-10
description تعلم كيفية تحويل ملفات Excel إلى PDF بصفحة واحدة لكل ورقة باستخدام GroupDocs.Conversion للغة Java، بما في ذلك خيارات إظهار خطوط الشبكة وتوليد PDF من جدول البيانات.
keywords
one page per sheet
generate pdf from spreadsheet
convert excel pdf java
show grid lines pdf
excel pdf conversion java
title تحويل Excel إلى PDF – صفحة واحدة لكل ورقة باستخدام GroupDocs Java
type docs
url /ar/java/pdf-conversion/excel-to-pdf-groupdocs-java-tutorial/
weight 1

تحويل Excel إلى PDF – صفحة واحدة لكل ورقة باستخدام GroupDocs Java

في بيئة اليوم المعتمدة على البيانات، تحويل دفاتر عمل Excel إلى ملفات PDF مع الحفاظ على كل ورقة عمل في صفحة منفصلة — one page per sheet — هو مطلب شائع. سواء كنت بحاجة إلى إنشاء PDF من تقارير الجداول، أو مشاركة نسخ للقراءة فقط، أو أرشفة البيانات، فإن الحفاظ على التخطيط وخطوط الشبكة أمر مهم. يوضح هذا الدليل كيفية استخدام GroupDocs.Conversion for Java لتحويل ملفات Excel إلى PDF مع خيار one page per sheet، بالإضافة إلى كيفية show grid lines وإعدادات مفيدة أخرى.

إجابات سريعة

  • ما معنى “one page per sheet”؟ يتم عرض كل ورقة عمل على صفحة PDF منفصلة.
  • هل يمكنني إظهار خطوط الشبكة في ملف PDF؟ نعم، قم بتمكين setShowGridLines(true) في خيارات التحميل.
  • ما المكتبة التي تتعامل مع التحويل؟ GroupDocs.Conversion for Java.
  • هل أحتاج إلى ترخيص؟ نسخة تجريبية مجانية تعمل للاختبار؛ يلزم ترخيص مدفوع للإنتاج.
  • هل التحويل الجماعي ممكن؟ نعم، يمكنك التكرار عبر ملفات متعددة باستخدام نفس API.

ما هو تحويل “one page per sheet”؟

إعداد one page per sheet يخبر المحول بأن يتعامل مع كل ورقة عمل في دفتر Excel كصفحة منفصلة في ملف PDF الناتج. هذا يحافظ على بنية دفتر العمل الأصلي ويجعل التنقل أسهل للقراء.

لماذا تستخدم GroupDocs.Conversion for Java لإنشاء PDF من جدول بيانات؟

  • دقة عالية – يحتفظ بالتنسيق والصيغ والتصميم.
  • الأداء – مُحسّن للدفاتر الكبيرة ومعالجة الدفعات.
  • المرونة – يدعم خيارات مثل إظهار خطوط الشبكة، ضبط اتجاه الصفحة، وأكثر.
  • متعدد المنصات – يعمل على أي بيئة متوافقة مع Java.

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

  • Java Development Kit (JDK) 8 أو أعلى.
  • مكتبة GroupDocs.Conversion for Java (سنضيفها عبر Maven).
  • بيئة تطوير متكاملة مثل IntelliJ IDEA أو Eclipse.
  • إلمام أساسي بإدارة تبعيات Maven (مفيد لكن ليس ضرورياً).

إعداد GroupDocs.Conversion for Java

أضف مستودع GroupDocs والاعتماد إلى ملف pom.xml الخاص بك:

<repositories>
   <repository>
      <id>groupdocs-repo</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>

الترخيص

توفر GroupDocs نسخة تجريبية مجانية وعدة مستويات ترخيص. احصل على ترخيص مؤقت للتقييم أو اشترِ ترخيصًا كاملاً للاستخدام في الإنتاج.

التهيئة والإعداد

بعد إضافة الاعتماد، يمكنك التحقق من تحميل المكتبة بشكل صحيح:

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.load.SpreadsheetLoadOptions;

public class InitializeGroupDocs {
    public static void main(String[] args) {
        System.out.println("GroupDocs Conversion for Java Initialized.");
    }
}

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

كيفية تكوين “one page per sheet” وإظهار خطوط الشبكة

تتيح لك فئة SpreadsheetLoadOptions ضبط كيفية تفسير دفتر العمل قبل التحويل بدقة.

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

public class LoadSpreadsheetWithOptions {
    public static void run() {
        SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
        
        // Show grid lines in the converted document
        loadOptions.setShowGridLines(true);
        
        // Ensure each sheet is on a separate page
        loadOptions.setOnePagePerSheet(true);
    }
}
  • setShowGridLines(true) – يحافظ على نمط خطوط الشبكة في ملف PDF.
  • setOnePagePerSheet(true) – يفعّل السلوك الأساسي one page per sheet.

تحويل جدول البيانات إلى PDF

كود التحويل خطوة بخطوة

مع تكوين خيارات التحميل، يكون التحويل نفسه بسيطًا:

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

public class ConvertSpreadsheetToPdf {
    public static void run(String inputFilePath, String outputFilePath) {
        SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
        loadOptions.setShowGridLines(true);
        loadOptions.setOnePagePerSheet(true);
        
        Converter converter = new Converter(inputFilePath, () -> loadOptions);
        PdfConvertOptions options = new PdfConvertOptions();
        
        converter.convert(outputFilePath, options);
    }
}
  • Converter يتعامل مع كامل خط أنابيب التحويل.
  • PdfConvertOptions يتيح لك تحديد إعدادات خاصة بـ PDF (الضغط، جودة الصورة، إلخ).

تحويل دفعات Excel إلى PDF باستخدام Java

لمعالجة دفاتر عمل متعددة، قم ببساطة بالتكرار عبر مجموعة من مسارات الملفات واستدعِ ConvertSpreadsheetToPdf.run() لكل ملف. يتيح هذا النهج سيناريوهات batch convert excel pdf مع أقل تغييرات في الكود.

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

  1. إنشاء تقارير تلقائي – تحويل ملفات Excel المالية الشهرية إلى PDF للتوزيع.
  2. تعاون الفريق – مشاركة ملفات PDF للقراءة فقط تحتفظ بخطوط الشبكة، مما يضمن أن يرى الجميع نفس التخطيط.
  3. أرشفة طويلة الأمد – تخزين جداول البيانات كملفات PDF لمنع التعديلات العرضية مع الحفاظ على الدقة البصرية.

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

  • إدارة الذاكرة – خصص مساحة كافية للـ heap عند تحويل دفاتر عمل كبيرة.
  • معالجة الدفعات – يمكن لـ GroupDocs.Conversion التعامل مع ملفات متعددة بشكل متوازي؛ راقب استخدام وحدة المعالجة المركزية.
  • ضبط خيارات التحميل – تعطيل الميزات غير الضرورية (مثل الصيغ) يمكن أن يقلل من وقت المعالجة.

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

المشكلة الحل
Out‑OfMemoryError على ملفات كبيرة Increase JVM heap (-Xmx2g أو أعلى) وفكر في تحويل الأوراق بشكل فردي.
خطوط الشبكة لا تظهر تأكد من استدعاء loadOptions.setShowGridLines(true) قبل إنشاء الـ Converter.
جميع الأوراق مدمجة في صفحة واحدة تحقق من ضبط loadOptions.setOnePagePerSheet(true)؛ قد تتطلب إصدارات المكتبة القديمة خاصية مختلفة.

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

س: ما الفرق بين convert excel pdf java و excel pdf conversion java؟
ج: كلاهما يشير إلى نفس العملية — استخدام Java لتحويل دفاتر Excel إلى ملفات PDF. تختلف الصياغة لكن استدعاءات API الأساسية تظل متطابقة.

س: هل يمكنني تخصيص حجم صفحة PDF أو اتجاهها؟
ج: نعم، توفر PdfConvertOptions طرقًا مثل setPageSize() و setPageOrientation() لتخصيص المخرجات.

س: هل من الممكن إخفاء خطوط الشبكة مع الحفاظ على تخطيط صفحة واحدة لكل ورقة؟
ج: بالتأكيد. اضبط loadOptions.setShowGridLines(false) واحتفظ بـ setOnePagePerSheet(true).

س: كيف أتعامل مع ملفات Excel المحمية بكلمة مرور؟
ج: قدم كلمة المرور عند إنشاء مثيل Converter عبر نسخة overload تقبل LoadOptions مع بيانات الاعتماد.

س: هل تدعم GroupDocs صيغ جداول بيانات أخرى (مثل CSV، ODS)؟
ج: نعم، يمكن للمكتبة تحميل وتحويل مجموعة متنوعة من صيغ جداول البيانات إلى PDF.

الموارد

آخر تحديث: 2026-04-10
تم الاختبار مع: GroupDocs.Conversion 25.2 for Java
المؤلف: GroupDocs