دمج المستندات

دمج مستندات Word عبر الإنترنت في Java

يتوفر برنامج Microsoft Word عمليًا في كل مكان، بما في ذلك أجهزة الكمبيوتر في العمل، وأجهزة الكمبيوتر في المدرسة، وأجهزة الكمبيوتر المنزلية. فنحن ننشئ الرسائل والتقارير وما إلى ذلك بتنسيق word ونستخدم قصاصات فنية، ونكتب بخطوط وأحجام مختلفة. وعلى مدار فترة زمنية، ننشئ عددًا هائلاً من المستندات، ومن أجل أرشفتها على المدى الطويل، نحتاج إلى دمج هذه المستندات. لذا، في هذه المقالة، سنتعلم تقنية دمج المستندات في Java.

دمج المستندات API

توفر Aspose.Words Cloud الميزات اللازمة لإنشاء وتحرير وعرض مستندات MS Word وOpenOffice وحفظها في مجموعة متنوعة من التنسيقات المدعومة. كما تدعم الميزة الخاصة بتحميل مستندات Word ودمجها في مستند واحد موحد. لذا، دعنا نضيف التفاصيل التالية إلى ملف pom.xml الخاص بنوع البناء maven حتى تتم إضافة Aspose.Words Cloud SDK for Java إلى المشروع.

<repositories>
    <repository>
        <id>AsposeJavaAPI</id>
        <name>Aspose Java API</name>
        <url>https://repository.aspose.cloud/repo/</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.aspose</groupId>
         <artifactId>aspose-words-cloud</artifactId>
        <version>22.5.0</version>
</dependency>

إذا لم تكن قد قمت بذلك بالفعل، قم بتسجيل حساب مجاني على لوحة معلومات Aspose.Cloud باستخدام حساب GitHub أو Google أو ببساطة قم بالتسجيل واحصل على بيانات اعتماد العميل الخاصة بك.

دمج مستندات Word في Java

يرجى اتباع التعليمات الموضحة أدناه لدمج المستندات:

  • أولاً، قم بتحديد معلومات معرف العميل والسر الخاص بالعميل.
  • ثانيًا، قم بإنشاء كائن من فئة ApiClient حيث نمرر ClientID وClientSecret كوسيطتين إلى المنشئ. الوسيطة الثالثة هي baseUrl وبشكل افتراضي، تشير إلى https://api.aspose.cloud/.
  • ثالثًا، قم بإنشاء كائن من فئة WordsApi الذي يقبل كائن ApiClient كوسيطة للمنشئ.
  • الآن قم بإنشاء مثيل لفئة DocumentEntry وحدد href للمستند المصدر Word وقم بتعيين تنسيق استيراد المستند على KeepSourceFormatting.
  • قم بإنشاء مثيل لفئة DocumentEntryList ومرر كائن DocumentEntry (الذي تم إنشاؤه في الخطوة السابقة) إلى طريقة addDocumentEntriesItem(…).
  • الخطوة التالية هي إنشاء مثيل لفئة AppendDocumentRequest حيث نقوم بتمرير مستند Word المدخل، وكائن DocumentEntryList، واسم الملف المدمج الناتج كوسائط إلى المنشئ الخاص به.
  • أخيرًا، قم باستدعاء طريقة appendDocument(…) من فئة WordsApi لإجراء عملية التحويل.
// احصل على clientId و clientSecret من https://dashboard.aspose.cloud/
String clientId = "c235e685-1aab-4cda-a95b-54afd63eb87f";
String clientSecret = "b8da4ee37494f2ef8da3c727f3a0acb9";

// إذا كان baseUrl فارغًا، يستخدم WordsApi https://api.aspose.cloud الافتراضي 
// إنشاء كائن ApiClient من خلال توفير معرف العميل وسر العميل الخاصين بالمستخدم
ApiClient apiClient = new ApiClient(clientId,clientSecret,null);

// إنشاء كائن WordsApi عن طريق توفير ApiClient كحجة
WordsApi wordsApi = new WordsApi(apiClient);

// إدخال مستند PDF
String inputFile = "file-sample.docx";
String firstFileToAppend = "test_multi_pages.docx";				
String resultantFile = "Resultant.docx";
				
// حدد المستند الأول الذي سيتم إلحاقه
DocumentEntry docEntry = new DocumentEntry().href(firstFileToAppend).importFormatMode("KeepSourceFormatting");

// تحديد قائمة المستندات المراد إرفاقها
DocumentEntryList documentList = new DocumentEntryList().addDocumentEntriesItem(docEntry);
								
// حدد معلمات التحويل
AppendDocumentRequest request = new AppendDocumentRequest(inputFile, documentList, null, null, null, null, resultantFile, null, null);

// احفظ ملف DOCX المدمج الناتج
DocumentResponse result = wordsApi.appendDocument(request);

دمج مستندات Word باستخدام أوامر cURL

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

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=c235e685-1aab-4cda-a95b-54afd63eb87f&client_secret=b8da4ee37494f2ef8da3c727f3a0acb9" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

لمزيد من المعلومات، يرجى زيارة كيفية الحصول على رمز JWT باستخدام معرف العميل ومفتاح العميل السري.

بمجرد إنشاء JWT، يرجى تنفيذ الأمر التالي لدمج الملفين file-sample.docx وtestmultipages.docx. ونتيجة لذلك، سيتم إنشاء ملف مدمج نهائي باسم Resultant.docx.

curl -v "https://api.aspose.cloud/v4.0/words/test_doc.docx/appendDocument?destFileName=Resultant.docx" \
-X PUT \
-d "{'DocumentEntries':[{'Href':'test_multi_pages.docx', 'ImportFormatMode':'KeepSourceFormatting'}]}" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <JWT Token>"

خاتمة

لقد تعلمنا الخطوات اللازمة لدمج مستندات Word باستخدام مقتطفات التعليمات البرمجية بلغة Java. وفي الوقت نفسه، تعلمنا أيضًا التفاصيل حول كيفية دمج مستندات Word باستخدام أوامر cURL. يمكنك أيضًا التفكير في استكشاف الميزات المثيرة لواجهة برمجة التطبيقات من خلال واجهة Swagger في متصفح الويب.

علاوة على ذلك، فإن مجموعات SDK السحابية الخاصة بنا مفتوحة المصدر ويمكن تنزيل الكود المصدر الكامل من GitHub. نوصي أيضًا بزيارة Documentation المنتج للحصول على تفاصيل حول الميزات المثيرة الأخرى التي تقدمها واجهة برمجة التطبيقات. ملاحظاتك مهمة جدًا بالنسبة لنا. لذا، لا تتردد في الاتصال بنا باستخدام منتديات الدعم.

مقالات ذات صلة

ننصحك بشدة بزيارة الروابط التالية للتعرف على: