Optimize 115 Merger Java pages

content/arabic/java/document-extraction/extract-pages-groupdocs-merger-java/_index.md

@@ -0,0 +1,157 @@
+---
+date: '2025-12-19'
+description: تعلم كيفية استخراج صفحات PDF على دفعات واستخراج الصفحات حسب الرقم باستخدام
+  GroupDocs.Merger للغة Java. يغطي هذا الدليل الإعداد والتنفيذ وحالات الاستخدام العملية.
+keywords:
+- extract specific pages from documents
+- GroupDocs.Merger for Java setup
+- Java document extraction
+title: استخراج دفعي لصفحات PDF باستخدام GroupDocs.Merger للغة Java
+type: docs
+url: /ar/java/document-extraction/extract-pages-groupdocs-merger-java/
+weight: 1
+---
+
+# استخراج دفعة من صفحات PDF باستخدام GroupDocs.Merger للـ Java
+
+استخراج صفحات محددة من مستند هو تحدٍ شائع للمطورين الذين يحتاجون إلى **batch extract PDF pages** أو مشاركة الأقسام ذات الصلة فقط من ملف أكبر. باستخدام **GroupDocs.Merger for Java**، يمكنك تنفيذ هذه المهمة بسرعة، وبشكل موثوق، وباستخدام بضع أسطر من الشيفرة فقط.
+
+في هذا الدرس ستتعلم كيفية إعداد GroupDocs.Merger، استخراج الصفحات حسب الرقم، وحفظ النتيجة كمستند جديد—مع الحفاظ على بساطة العملية لتتمكن من دمجها في أي تطبيق Java.
+
+## إجابات سريعة
+- **ما معنى “batch extract PDF pages”؟** يشير إلى استخراج عدة صفحات محددة من ملف PDF واحد أو أكثر في عملية واحدة.  
+- **ما الطريقة التي تستخرج الصفحات حسب الرقم؟** استخدم `ExtractOptions` مع مصفوفة من مؤشرات الصفحات.  
+- **هل أحتاج إلى ترخيص؟** النسخة التجريبية المجانية تكفي للتطوير؛ يتطلب الإنتاج ترخيصًا مدفوعًا.  
+- **هل يمكنني استخراج صفحات غير متتالية؟** نعم—قائمة بأي أرقام صفحات تحتاجها.  
+- **هل هذا مناسب للملفات الكبيرة؟** مع إعدادات الذاكرة المناسبة، يتعامل GroupDocs.Merger مع المستندات الكبيرة بكفاءة.
+
+## ما هو استخراج دفعة من صفحات PDF؟
+يعني استخراج دفعة من صفحات PDF اختيار مجموعة من الصفحات الفردية—سواء كانت متتالية أم لا— وإنشاء ملف PDF جديد يحتوي فقط على تلك الصفحات. هذا مفيد بشكل خاص لإنشاء تقارير، مقتطفات من المستندات القانونية، أو أدلة دراسية مخصصة دون إرسال الملف بالكامل.
+
+## لماذا نستخدم GroupDocs.Merger للـ Java؟
+- **أداء عالي** على المستندات الكبيرة.  
+- **يدعم صيغًا متعددة** (PDF, DOCX, PPTX، إلخ).  
+- **API بسيط** يتيح لك التركيز على منطق الأعمال بدلاً من التعامل منخفض المستوى مع الملفات.  
+- **توافق متعدد المنصات** لتطبيقات سطح المكتب، الخادم، والسحابة.
+
+## المتطلبات المسبقة
+- معرفة أساسية ببرمجة Java.  
+- بيئة تطوير متكاملة مثل IntelliJ IDEA أو Eclipse.  
+- Maven أو Gradle لإدارة التبعيات.  
+- ترخيص صالح لـ GroupDocs.Merger (النسخة التجريبية المجانية أو الترخيص المؤقت يكفي للاختبار).
+
+## إعداد GroupDocs.Merger للـ Java
+
+### تعليمات التثبيت
+أضف المكتبة إلى مشروعك باستخدام أداة البناء المفضلة لديك.
+
+**Maven**  
+```xml
+<dependency>
+    <groupId>com.groupdocs</groupId>
+    <artifactId>groupdocs-merger</artifactId>
+    <version>latest-version</version>
+</dependency>
+```
+
+**Gradle**  
+```gradle
+implementation 'com.groupdocs:groupdocs-merger:latest-version'
+```
+
+**Direct Download**  
+للحصول على نسخة يدوية، قم بتحميل أحدث إصدار من [GroupDocs.Merger for Java releases](https://releases.groupdocs.com/merger/java/).
+
+### الحصول على الترخيص
+ابدأ بنسخة تجريبية مجانية لاستكشاف الميزات. إذا كانت المكتبة تلبي احتياجاتك، اشترِ ترخيصًا أو اطلب ترخيصًا مؤقتًا لتقييم موسع.
+
+بعد إضافة التبعية والحصول على الترخيص، أنشئ مثيلًا من `Merger` يشير إلى المستند المصدر الخاص بك:  
+```java
+String filePath = "YOUR_DOCUMENT_DIRECTORY/sample.docx";
+Merger merger = new Merger(filePath);
+```
+
+## دليل التنفيذ
+
+### ميزة استخراج الصفحات حسب الرقم
+تتيح لك قدرة **extract pages by number** تحديد الصفحات التي تريد استخراجها من الملف المصدر بدقة.
+
+#### تهيئة Merger
+أولاً، أنشئ كائن `Merger` مع مسار المستند الذي تريد العمل معه:  
+```java
+String filePath = "YOUR_DOCUMENT_DIRECTORY/sample.docx";
+Merger merger = new Merger(filePath);
+```
+
+#### تحديد أرقام الصفحات للاستخراج
+أنشئ كائن `ExtractOptions` ومرّر مصفوفة بأرقام الصفحات التي ترغب في استخراجها. في هذا المثال نستخرج الصفحات 1 و 4:  
+```java
+ExtractOptions extractOptions = new ExtractOptions(new int[] { 1, 4 });
+```
+
+#### تنفيذ عملية الاستخراج
+استدعِ طريقة `extractPages`، مع تمرير الخيارات التي حددتها للتو:  
+```java
+merger.extractPages(extractOptions);
+```
+
+#### حفظ الصفحات المستخرجة
+أخيرًا، احفظ المستند الجديد على القرص:  
+```java
+String filePathOut = "YOUR_OUTPUT_DIRECTORY/ExtractPagesByNumbers-output.pdf";
+merger.save(filePathOut);
+```
+
+### نصائح استكشاف الأخطاء وإصلاحها
+- تأكد من أن مسارات الإدخال والإخراج صحيحة ويمكن الوصول إليها.  
+- تحقق من أن أرقام الصفحات التي تحددها موجودة فعليًا في الملف المصدر.  
+- بالنسبة للمستندات الكبيرة جدًا، زد حجم الذاكرة المخصصة للـ JVM (`-Xmx`) لتجنب حدوث `OutOfMemoryError`.
+
+## تطبيقات عملية
+1. **أنظمة إدارة المستندات** – إنشاء تقارير مخصصة عن طريق استخراج الأقسام المطلوبة فقط من ملفات PDF الضخمة.  
+2. **الخدمات القانونية والمالية** – مشاركة بنود عقد محددة أو بيانات مالية دون كشف المستند بالكامل.  
+3. **منصات التعليم** – تزويد الطلاب بالفصول ذات الصلة فقط بالمهمة المطلوبة.
+
+## اعتبارات الأداء
+- **إدارة الذاكرة:** راقب استهلاك الـ heap؛ عدّل `-Xmx` حسب الحاجة للملفات الكبيرة.  
+- **المعالجة الدفعية:** عند استخراج الصفحات من العديد من المستندات، قم بمعالجتها على دفعات للحفاظ على استهلاك الموارد تحت السيطرة.  
+- **إدخال/إخراج فعال:** استخدم تدفقات مؤقتة (buffered streams) أو I/O غير متزامن لتسريع عمليات القراءة/الكتابة.
+
+## الخلاصة
+أصبح لديك الآن طريقة كاملة وجاهزة للإنتاج لـ **batch extracting PDF pages** و **extracting pages by number** باستخدام GroupDocs.Merger للـ Java. يمكن لهذه الوظيفة تبسيط سير العمل بشكل كبير عندما يتعلق الأمر بمشاركة مستندات مختارة أو إنشاء تقارير مخصصة.
+
+استكشف ميزات إضافية مثل دمج المستندات، تدوير الصفحات، أو إضافة العلامات المائية لتوسيع قدرات تطبيقك في معالجة المستندات.
+
+## قسم الأسئلة المتكررة
+
+1. **ما الصيغ التي يدعمها GroupDocs.Merger؟**  
+   يتعامل مع PDF، Word، Excel، PowerPoint، والعديد من الصيغ الشائعة الأخرى.  
+
+2. **هل يمكنني استخراج صفحات غير متتالية؟**  
+   نعم—فقط قم بإدراج أي أرقام صفحات تحتاجها في مصفوفة `ExtractOptions`.  
+
+3. **هل هناك حد لعدد الصفحات التي يمكن استخراجها؟**  
+   لا يوجد حد ثابت، رغم أن الاستخراجات الضخمة قد تتطلب المزيد من الذاكرة.  
+
+4. **كيف يجب التعامل مع الاستثناءات أثناء الاستخراج؟**  
+   ضع منطق الاستخراج داخل كتلة try‑catch وسجّل رسالة الاستثناء لتسهيل استكشاف الأخطاء.  
+
+5. **هل يمكن استخدام GroupDocs.Merger في تطبيقات Java السحابية؟**  
+   بالتأكيد—API الخفيف الوزن يعمل بنفس الكفاءة على الخوادم المحلية أو منصات السحابة.  
+
+## الموارد
+- [التوثيق](https://docs.groupdocs.com/merger/java/)  
+- [مرجع API](https://reference.groupdocs.com/merger/java/)  
+- [تحميل](https://releases.groupdocs.com/merger/java/)  
+- [شراء](https://purchase.groupdocs.com/buy)  
+- [نسخة تجريبية مجانية](https://releases.groupdocs.com/merger/java/)  
+- [ترخيص مؤقت](https://purchase.groupdocs.com/temporary-license/)  
+- [منتدى الدعم](https://forum.groupdocs.com/c/merger/)
+
+---
+
+**آخر تحديث:** 2025-12-19  
+**تم الاختبار مع:** GroupDocs.Merger 23.11 (latest at time of writing)  
+**المؤلف:** GroupDocs  
+
+---

content/arabic/java/document-import/embed-ole-object-ppt-java-groupdocs-merger/_index.md

@@ -0,0 +1,181 @@
+---
+date: '2025-12-19'
+description: تعلم كيفية تضمين كائنات OLE في شرائح PowerPoint باستخدام Java وGroupDocs.Merger.
+  يوضح لك هذا الدليل خطوة بخطوة كيفية تضمين ملفات PDF وجداول البيانات والمزيد.
+keywords:
+- embed OLE objects in PowerPoint
+- Java GroupDocs.Merger library
+- OLE embedding in Java
+title: كيفية تضمين كائنات OLE في PowerPoint باستخدام Java
+type: docs
+url: /ar/java/document-import/embed-ole-object-ppt-java-groupdocs-merger/
+weight: 1
+---
+
+# كيفية تضمين كائنات OLE في PowerPoint باستخدام Java
+
+قم بتحسين عروض PowerPoint الخاصة بك عن طريق تضمين مستندات خارجية مثل ملفات PDF أو جداول البيانات أو الصور مباشرةً على الشرائح. **في هذا الدليل ستتعلم كيفية تضمين كائنات OLE** باستخدام GroupDocs.Merger for Java، وسترى لماذا يمكن لهذه التقنية أن تجعل عروضك أكثر تفاعلية ومهنية.
+
+## إجابات سريعة
+- **ما هو OLE?** Object Linking and Embedding يتيح لك إدراج نوع ملف آخر داخل شريحة PowerPoint.  
+- **أي مكتبة تساعد؟** GroupDocs.Merger for Java توفر API بسيط لإضافة كائنات OLE.  
+- **هل أحتاج إلى ترخيص؟** ترخيص مؤقت يعمل للتقييم؛ يتطلب الترخيص الكامل للإنتاج.  
+- **أنواع الملفات المدعومة؟** ملفات PDF، دفاتر عمل Excel، مستندات Word، والعديد من الصيغ الأخرى.  
+- **كم من الوقت يستغرق؟** مع إعداد Maven/Gradle، يمكن كتابة الكود الأساسي في أقل من 10 دقائق.
+
+## ما هو تضمين OLE في PowerPoint؟
+
+Object Linking and Embedding (OLE) يسمح لشريحة PowerPoint بأن تحتوي على تمثيل حي لمستند آخر. عندما تنقر مزدوجًا على الكائن المضمن أثناء العرض، يفتح الملف الأصلي في تطبيقه الأصلي، مما يمنح المشاهدين وصولًا فوريًا إلى البيانات التفصيلية دون مغادرة مجموعة الشرائح.
+
+## لماذا يتم تضمين كائنات OLE في PowerPoint؟
+
+- **احتفظ بجميع الموارد في ملف واحد** – لا حاجة لإرسال ملفات PDF أو جداول بيانات منفصلة.  
+- **حافظ على دقة البيانات** – الملف المضمن يحتفظ بالتنسيق والوظائف الأصلية.  
+- **تحسين تفاعل الجمهور** – يمكن للمشاهدين استكشاف المخططات والجداول أو العقود مباشرةً.  
+- **تبسيط التحكم في الإصدارات** – ملف PPTX واحد يحتوي على جميع المواد الداعمة، مما يقلل من خطر عدم توافق الملفات.
+
+## المتطلبات المسبقة
+
+- **Java Development Kit (JDK) 8+** – تأكد من أن `java -version` يُظهر 1.8 أو أعلى.  
+- **IDE** – IntelliJ IDEA، Eclipse، أو أي محرر تفضله.  
+- **Maven or Gradle** – لإدارة التبعيات.  
+- **Basic Java knowledge** – يجب أن تكون مرتاحًا مع `try‑with‑resources` والبرمجة الكائنية.
+
+## إعداد GroupDocs.Merger للغة Java
+
+### معلومات التثبيت
+
+أضف مكتبة GroupDocs.Merger إلى مشروعك:
+
+**Maven:**
+```xml
+<dependency>
+    <groupId>com.groupdocs</groupId>
+    <artifactId>groupdocs-merger</artifactId>
+    <version>latest-version</version>
+</dependency>
+```
+
+**Gradle:**
+```gradle
+implementation 'com.groupdocs:groupdocs-merger:latest-version'
+```
+
+**Direct Download:**  
+قم بتنزيل أحدث نسخة من [GroupDocs.Merger for Java releases](https://releases.groupdocs.com/merger/java/).
+
+### الحصول على الترخيص
+
+احصل على ترخيص مؤقت للتقييم غير المحدود من خلال [temporary license page](https://purchase.groupdocs.com/temporary-license/). للإنتاج، اشترِ ترخيصًا من [GroupDocs website](https://purchase.groupdocs.com/buy).
+
+### التهيئة الأساسية
+
+```java
+import com.groupdocs.merger.Merger;
+
+public class PresentationMerger {
+    public static void main(String[] args) {
+        // Initialize Merger with the path to your document
+        try (Merger merger = new Merger("path/to/your/presentation.pptx")) {
+            System.out.println("Merger initialized successfully.");
+        } catch (Exception e) {
+            e.printStackTrace();
+        }
+    }
+}
+```
+
+## كيفية تضمين كائنات OLE في PowerPoint باستخدام Java
+
+### الخطوة 1: تعريف مسارات الملفات
+
+```java
+String filePath = "YOUR_DOCUMENT_DIRECTORY/SAMPLE_PPTX"; // Path to source presentation file
+String embeddedFilePath = "YOUR_DOCUMENT_DIRECTORY/SAMPLE_PDF"; // Path to PDF to be embedded
+```
+
+### الخطوة 2: تكوين `OlePresentationOptions`
+
+```java
+import com.groupdocs.merger.domain.options.OlePresentationOptions;
+
+int pageNumber = 1; // Page number for the OLE object
+int x = 100; // X position on slide
+int y = 200; // Y position on slide
+int width = 300; // Width of embedded object
+int height = 400; // Height of embedded object
+
+OlePresentationOptions oleOptions = new OlePresentationOptions(embeddedFilePath, pageNumber);
+oleOptions.setX(x);
+oleOptions.setY(y);
+oleOptions.setWidth(width);
+oleOptions.setHeight(height);
+```
+
+### الخطوة 3: تضمين كائن OLE
+
+```java
+import com.groupdocs.merger.domain.options.OlePresentationOptions;
+
+try (Merger merger = new Merger(filePath)) {
+    // Add embedded document as an OLE object
+    merger.addOleObject(oleOptions);
+
+    // Save the modified presentation
+    String outputPath = "YOUR_OUTPUT_DIRECTORY/modified_presentation.pptx";
+    merger.save(outputPath);
+    System.out.println("OLE Object added successfully.");
+} catch (Exception e) {
+    e.printStackTrace();
+}
+```
+
+### نصائح استكشاف الأخطاء وإصلاحها
+
+- **دقة مسار الملف:** تحقق مرة أخرى من أن كل مسار يشير إلى ملف موجود وقابل للقراءة.  
+- **الصيغ المدعومة:** PowerPoint يدعم فقط بعض أنواع OLE؛ ملفات PDF، Excel، وWord هي خيارات آمنة.  
+- **استخدام الذاكرة:** استخدم `try‑with‑resources` (كما هو موضح) لضمان إغلاق كائن `Merger` بسرعة.
+
+## تطبيقات عملية
+
+1. **تقارير الأعمال** – تضمين تقرير PDF كامل الطول حتى يتمكن التنفيذيون من فتحه مباشرةً من الشريحة.  
+2. **المواد التعليمية** – إرفاق أوراق عمل أو جداول بيانات يمكن للطلاب استكشافها أثناء المحاضرة.  
+3. **إدارة المشاريع** – وضع ملف Excel يحتوي على مخطط جانت على شريحة تحديث الحالة للرجوع السريع.
+
+## اعتبارات الأداء
+
+- **تحسين حجم الملفات:** ملفات PDF الكبيرة قد تبطئ تحميل الشرائح؛ فكر في ضغطها أولاً.  
+- **إدارة الذاكرة في Java:** نمط `try‑with‑resources` الموضح أعلاه يحرر الموارد الأصلية تلقائيًا.  
+- **المعالجة الدفعية:** عند تضمين كائنات في العديد من العروض، قم بالتكرار على قائمة الملفات وأعد استخدام كائن `Merger` واحد حيثما أمكن لتقليل الحمل.
+
+## الأسئلة المتكررة
+
+**س: ما هي صيغ الملفات التي يمكن تضمينها باستخدام OLE في PowerPoint؟**  
+ج: ملفات PDF، دفاتر عمل Excel، مستندات Word، ملفات PowerPoint، والعديد من صيغ Office الأخرى مدعومة.
+
+**س: كيف أجعل الكائن المضمن يظهر في كل شريحة؟**  
+ج: أدخل كائن OLE في الشريحة الرئيسية (Slide Master)؛ جميع الشرائح التي ترث من تلك الشريحة ستظهره.
+
+**س: هل يمكنني استبدال كائن OLE موجود دون إعادة إنشاء الشريحة بالكامل؟**  
+ج: نعم. استدعِ `addOleObject` مرة أخرى بنفس الإحداثيات؛ الملف الجديد يكتب فوق السابق.
+
+**س: هل GroupDocs.Merger مجاني للاستخدام؟**  
+ج: نسخة تجريبية متاحة للتقييم؛ يتطلب الترخيص التجاري للاستخدام في بيئات الإنتاج.
+
+**س: ما هي الأخطاء الشائعة عند تضمين كائنات OLE؟**  
+ج: مسارات ملفات غير صحيحة، صيغ مستندات غير مدعومة، وملفات مدمجة كبيرة جدًا تؤثر سلبًا على الأداء.
+
+## الموارد
+- [توثيق GroupDocs.Merger](https://docs.groupdocs.com/merger/java/)
+- [مرجع API](https://reference.groupdocs.com/merger/java/)
+- [تحميل GroupDocs.Merger](https://releases.groupdocs.com/merger/java/)
+- [شراء الترخيص](https://purchase.groupdocs.com/buy)
+- [نسخة تجريبية مجانية](https://releases.groupdocs.com/merger/java/)
+- [ترخيص مؤقت](https://purchase.groupdocs.com/temporary-license/)
+- [منتدى الدعم](https://forum.groupdocs.com/c/merger/)
+
+---
+
+**آخر تحديث:** 2025-12-19  
+**تم الاختبار مع:** GroupDocs.Merger أحدث نسخة (Java)  
+**المؤلف:** GroupDocs