مثال عملي كامل لدمج مستندات Word متعددة في Java

يوضح هذا المثال كيفية دمج مستندات Word متعددة في Java باستخدام Merger API.

import com.groupdocs.merger.cloud.client.ApiClient;
import com.groupdocs.merger.cloud.client.ApiException;
import com.groupdocs.merger.cloud.api.MergerApi;
import com.groupdocs.merger.cloud.model.FileInfo;
import com.groupdocs.merger.cloud.model.MergeOptions;
import java.util.ArrayList;
import java.util.List;

public class CombineWordDocuments {
    public static void main(String[] args) {
        // Initialize the API client with your credentials
        ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
        MergerApi mergerApi = new MergerApi(apiClient);

try {
            // List of Word documents to combine
            List<FileInfo> sourceFiles = new ArrayList<>();
            sourceFiles.add(new FileInfo().setFilePath("input1.docx"));
            sourceFiles.add(new FileInfo().setFilePath("input2.docx"));
            sourceFiles.add(new FileInfo().setFilePath("input3.docx"));

// Configure merge options
            MergeOptions mergeOptions = new MergeOptions();
            mergeOptions.setOutputPath("merged_output.docx");
            mergeOptions.setFileInfos(sourceFiles);

// Execute the merge operation
            FileInfo result = mergerApi.merge(mergeOptions);

System.out.println("Merge completed successfully. Output file: " + result.getFilePath());
        } catch (ApiException e) {
            System.err.println("An error occurred while merging documents: " + e.getMessage());
        }
    }
}

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

دمج ملفات Word عبر REST API باستخدام cURL

إذا كنت تفضل نهج REST النقي، يمكن تنفيذ عملية الدمج نفسها باستخدام استدعاءات cURL. توضح الخطوات أدناه كيفية الحصول على رمز الوصول، تحميل الملفات المصدرية، طلب الدمج، وتنزيل النتيجة.

المصادقة والحصول على رمز الوصول:

curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

حمّل كل ملف DOCX إلى التخزين السحابي الخاص بك (استبدل YOUR_ACCESS_TOKEN بالرمز من الخطوة السابقة):

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input1.docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document" \
     --data-binary @input1.docx

كرر أمر التحميل للملفات input2.docx و input3.docx.

إنشاء طلب الدمج:

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/merge" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "outputPath":"merged_output.docx",
           "fileInfos":[
               {"filePath":"input1.docx"},
               {"filePath":"input2.docx"},
               {"filePath":"input3.docx"}
           ]
         }'

قم بتنزيل المستند المدمج:

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/merged_output.docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o merged_output.docx

لمزيد من التفاصيل حول معلمات الطلب، راجع وثائق API الرسمية.

فهم عملية دمج مستندات Word في Java

فيما يلي تفصيل خطوة بخطوة للكود المعروض سابقًا.

1. إنشاء ApiClient - new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") يُنشئ اتصالًا بخدمة GroupDocs السحابية.

   ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
   

2. إنشاء كائن MergerApi - new MergerApi(apiClient) يمنح الوصول إلى نقاط النهاية المتعلقة بالدمج.

   MergerApi mergerApi = new MergerApi(apiClient);
   

3. تحضير قائمة ملفات المصدر - كل كائن FileInfo يشير إلى ملف DOCX مخزن في السحابة. يتم تمرير القائمة إلى MergeOptions.

   List<FileInfo> sourceFiles = new ArrayList<>();
   sourceFiles.add(new FileInfo().setFilePath("input1.docx"));
   

4. تكوين MergeOptions - حدد مسار الإخراج المطلوب وأرفق قائمة ملفات المصدر.

   MergeOptions mergeOptions = new MergeOptions();
   mergeOptions.setOutputPath("merged_output.docx");
   mergeOptions.setFileInfos(sourceFiles);
   

5. تنفيذ الدمج - mergerApi.merge(mergeOptions) يرسل الطلب ويعيد كائن FileInfo للمستند المدمج.

   FileInfo result = mergerApi.merge(mergeOptions);
   

للحصول على قائمة كاملة بالخصائص المتاحة، راجع مرجع API.

المتطلبات الأولية وإعداد GroupDocs.Merger Cloud SDK

قبل أن تتمكن من تشغيل الكود، أضف تبعية Maven إلى مشروعك وتأكد من أن لديك حساب GroupDocs صالح.

أضف SDK إلى ملف pom.xml الخاص بك:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-merger-cloud</artifactId>
    <version>25.11</version>
</dependency>

قم بتنزيل أحدث ملفات JAR ومصدرها من صفحة التنزيل.
ستحتاج أيضًا إلى Java 8 أو أعلى وإلى اتصال بالإنترنت لاستدعاءات السحابة.
أنشئ حساب GroupDocs، واحصل على Client ID و Client Secret، واحفظهما بأمان.

الخاتمة

دمج ملفات DOCX برمجيًا أصبح الآن بسيطًا مع GroupDocs.Merger Cloud SDK for Java. يوضح مثال الشيفرة ومقاطع cURL طريقتين مرنتين لدمج مستندات Word متعددة في Java، سواء كنت تفضل مكتبة أصلية أو استدعاءات REST مباشرة. تذكر ضبط بيانات الاعتماد الخاصة بك، ومعالجة الملفات الكبيرة عن طريق البث إذا لزم الأمر، واختبار عملية الدمج باستخدام مستندات تمثيلية. بالنسبة للنشر في بيئات الإنتاج ستحتاج إلى ترخيص مدفوع؛ تفاصيل التسعير متوفرة على صفحة المنتج ويمكنك طلب ترخيص مؤقت للتقييم من صفحة الترخيص المؤقت.

الأسئلة الشائعة

• كيف يمكنني دمج مستندات Word متعددة في Java دون كتابة كود مخصص لمعالجة الملفات؟
  استخدم GroupDocs.Merger Cloud SDK for Java. يقوم SDK بتجريد جميع العمليات منخفضة المستوى ويسمح لك بدمج ملفات DOCX ببضع استدعاءات API.

• هل من الممكن دمج المستندات المخزنة في مجلدات سحابية مختلفة؟
  نعم. قدم مسارات الملفات السحابية الكاملة في كائنات FileInfo، وستقوم عملية الدمج بجلب كل ملف من موقعه قبل دمجهما.

• ماذا يجب أن أفعل إذا فشل الدمج مع ApiException؟
  تحقق من رسالة الاستثناء للحصول على تفاصيل مثل الملفات المفقودة أو مشاكل الأذونات. تأكد من صحة مسارات الملفات وأن حسابك يمتلك صلاحية القراءة/الكتابة على التخزين. راجع الوثائق الرسمية للحصول على رموز الأخطاء.

• هل أحتاج إلى ترخيص منفصل لكل بيئة (التطوير، الاختبار، الإنتاج)؟
  يغطي ترخيص واحد جميع البيئات، ولكن يجب عليك الالتزام بحدود الاستخدام المحددة في اتفاقية الترخيص الخاصة بك. للاختبار يمكنك استخدام الترخيص المؤقت المرتبط أعلاه.

المزيد

• حماية ملف ZIP بكلمة مرور باستخدام برنامج حماية كلمة المرور
• حماية ملف Excel بكلمة مرور باستخدام خدمة حماية كلمة المرور
• دمج مستندات Word في C#

دمج مستندات Word متعددة في Node.JS - مثال كامل للشفرة

هذا المثال يوضح كيفية دمج ثلاثة ملفات DOCX في مستند واحد باستخدام GroupDocs.Merger Cloud SDK for Node.js.

const GroupDocsMergerCloud = require("@groupdocs/merger-cloud");

// ==== Configuration ====
// Replace with your actual credentials
const clientId = "YOUR_CLIENT_ID";
const clientSecret = "YOUR_CLIENT_SECRET";

const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);
const mergeApi = new GroupDocsMergerCloud.MergeApi(config);

// ==== Input / Output paths ====
const inputFiles = [
    "documents/input1.docx",
    "documents/input2.docx",
    "documents/input3.docx"
];
const outputFile = "documents/combined_output.docx";

// ==== Build request ====
const documentEntries = inputFiles.map(path => {
    return new GroupDocsMergerCloud.Models.DocumentEntry({
        fileInfo: new GroupDocsMergerCloud.Models.FileInfo({
            filePath: path
        })
    });
});

const mergeRequest = new GroupDocsMergerCloud.Models.MergeDocumentsRequest({
    documents: documentEntries,
    outputPath: outputFile
});

// ==== Execute merge ====
(async () => {
    try {
        const result = await mergeApi.mergeDocuments(mergeRequest);
        console.log(`Merge completed successfully. Output file: ${result.path}`);
    } catch (error) {
        console.error("Error during merging:", error);
    }
})();

ملاحظة: يوضح مثال الشيفرة هذا الوظيفة الأساسية. قبل استخدامه في مشروعك، تأكد من تحديث مسارات الملفات (input1.docx, combined_output.docx, إلخ) لتطابق المواقع الفعلية للملفات لديك، وتحقق من أن جميع الاعتمادات المطلوبة مثبتة بشكل صحيح، واختبر بدقة في بيئة التطوير الخاصة بك. إذا واجهت أي مشكلات، يرجى الرجوع إلى الوثائق الرسمية أو التواصل مع فريق الدعم للحصول على المساعدة.

دمج مستندات Word عبر REST API باستخدام cURL

إذا كنت تفضل نهج REST النقي، يمكن تنفيذ عملية الدمج نفسها باستخدام أوامر cURL. أدناه سير عمل مختصر يقوم بالمصادقة، رفع ملفات المصدر، تشغيل الدمج، وتنزيل النتيجة.

1. المصادقة والحصول على رمز الوصول

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/authenticate" \
-H "Content-Type: application/json" \
-d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

تحتوي الاستجابة على access_token يُستخدم في المكالمات اللاحقة.

2. تحميل ملفات المصدر

كرر هذه الخطوة لكل ملف DOCX تريد دمجه.

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file/upload?path=documents/input1.docx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/octet-stream" \
--data-binary "@path/to/input1.docx"

3. تنفيذ عملية الدمج

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/merge" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
    "documents": [
        {"fileInfo": {"filePath": "documents/input1.docx"}},
        {"fileInfo": {"filePath": "documents/input2.docx"}},
        {"fileInfo": {"filePath": "documents/input3.docx"}}
    ],
    "outputPath": "documents/combined_output.docx"
}'

تُعيد API مسار الملف المدمج.

4. تنزيل المستند المدمج

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/download?path=documents/combined_output.docx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o combined_output.docx

لمزيد من التفاصيل حول حمولة الطلبات والخيارات، راجع وثائق API الرسمية.

كيف يعمل دمج مستندات Word المتعددة في Node.JS

يقوم SDK بتجريد عملية الدمج إلى بضع خطوات منطقية:

1. إنشاء التكوين - new GroupDocsMergerCloud.Configuration(clientId, clientSecret) يبني سياق المصادقة. راجع مرجع الفئة في مرجع API.

   const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);
   

2. كائن API - new GroupDocsMergerCloud.MergeApi(config) يوفر الوصول إلى عمليات الدمج.

   const mergeApi = new GroupDocsMergerCloud.MergeApi(config);
   

3. إدخالات المستند - يتم تغليف كل ملف مصدر في كائن DocumentEntry يحتوي على FileInfo مع مسار الملف.

   const documentEntries = inputFiles.map(path => {
       return new GroupDocsMergerCloud.Models.DocumentEntry({
           fileInfo: new GroupDocsMergerCloud.Models.FileInfo({ filePath: path })
       });
   });
   

4. طلب الدمج - MergeDocumentsRequest يجمع العناصر ومسار الإخراج المطلوب.

   const mergeRequest = new GroupDocsMergerCloud.Models.MergeDocumentsRequest({
       documents: documentEntries,
       outputPath: outputFile
   });
   

5. التنفيذ - mergeApi.mergeDocuments(mergeRequest) يرسل الطلب إلى خدمة السحابة. الوعد يُحلّ مع كائن نتيجة يحتوي على مسار ملف الإخراج.

   const result = await mergeApi.mergeDocuments(mergeRequest);
   console.log(`Merge completed successfully. Output file: ${result.path}`);
   

تمكنك هذه الخطوات معًا من دمج مستندات Word متعددة بكفاءة دون الحاجة إلى التعامل مع تدفقات الملفات منخفضة المستوى.

تحضير البيئة لـ GroupDocs.Merger

1. تثبيت SDK

npm install groupdocs-merger-cloud

الحزمة متاحة من صفحة صفحة التحميل

2. إصدار Node.js - تأكد من أنك تستخدم Node.js 12 أو أحدث.

3. تكوين بيانات الاعتماد - استبدل YOUR_CLIENT_ID و YOUR_CLIENT_SECRET في الشيفرة بالقيم من حساب GroupDocs Cloud الخاص بك.

4. إنشاء مجلد مشروع - ضع ملفات DOCX المصدرية في مجلد فرعي documents/ كما هو موضح في المثال.

مع إكمال هذه الخطوات، أنت جاهز لتشغيل برنامج الدمج أو استدعاء نقاط النهاية REST.

الخلاصة

دمج مستندات Word متعددة في Node.JS يصبح بسيطًا مع GroupDocs.Merger Cloud SDK for Node.js. يتعامل SDK مع تحميل الملفات، ومنطق الدمج، وتوليد المخرجات، مما يسمح لك بالتركيز على منطق الأعمال بدلاً من معالجة الملفات على مستوى منخفض. تذكر أن تحصل على ترخيص مناسب للاستخدام في الإنتاج؛ يمكنك البدء بـ رخصة مؤقتة والترقية إلى اشتراك كامل كلما زادت احتياجاتك. ابدأ الدمج اليوم وسهّل سير عمل المستندات الخاص بك.

الأسئلة الشائعة

• كيف يمكنني دمج مستندات Word متعددة في Node.JS باستخدام SDK؟
  استخدم الفئة MergeApi لإنشاء طلب MergeDocumentsRequest الذي يسرد كل ملف DOCX كـ DocumentEntry. يقوم SDK بدمجها بالترتيب المحدد ويحفظ النتيجة في مسار الإخراج المحدد.

• هل من الممكن دمج ملفات PDF معًا باستخدام نفس SDK؟
  نعم، يدعم Merger SDK صيغ PDF، DOCX، ODT، والعديد من الصيغ الأخرى. ما عليك سوى تغيير امتدادات الملفات في مصفوفة inputFiles وسيتولى SDK التحويل تلقائيًا. راجع الوثائق الرسمية للحصول على تفاصيل الصيغ.

• ما هي الحدود على عدد المستندات التي يمكنني دمجها في طلب واحد؟
  تفرض خدمة السحابة حدًا للحجم بدلاً من عدد صارم. طالما أن الحجم الإجمالي يبقى ضمن حصة حسابك، يمكنك دمج العشرات من الملفات. بالنسبة للدفعات الكبيرة جدًا، فكر في تحميل الملفات إلى تخزين GroupDocs أولاً والإشارة إليها بواسطة المعرف.

• هل يجب أن أقلق بشأن الترخيص للتطوير مقابل الإنتاج؟
  يمكن استخدام ترخيص مؤقت من خلال صفحة الترخيص المؤقت. بالنسبة لنشر الإنتاج، قم بشراء ترخيص كامل لفتح عمليات الدمج غير المحدودة ودعم الأولوية.

اقرأ المزيد

• حماية ملف ZIP بكلمة مرور باستخدام برنامج حماية كلمة المرور
• حماية ملف Excel بكلمة مرور باستخدام خدمة حماية كلمة المرور
• دمج مستندات Word في C#