ادغام اسناد Word در Java

مایکروسافت ورد عملاً در همه جا از جمله رایانه های محل کار، رایانه های مدرسه و رایانه خانگی شما در دسترس است. ما نامه ها، گزارش ها و غیره را در قالب word ایجاد می کنیم و از کلیپ آرت استفاده می کنیم، در فونت ها و اندازه های مختلف می نویسیم. در طول مدت زمان، ما تعداد زیادی اسناد تولید می کنیم و برای آرشیو طولانی مدت، این اسناد باید با هم ترکیب شوند. بنابراین در این مقاله قصد داریم تکنیک ادغام اسناد در Java را بیاموزیم.

API اسناد ادغام
ادغام اسناد Word در جاوا
اسناد Word را با استفاده از دستورات cURL ترکیب کنید

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>

اگر قبلاً این کار را نکرده‌اید، با استفاده از GitHub یا حساب Google یک حساب رایگان از طریق Aspose.Cloud داشبورد ثبت کنید یا به سادگی ثبت‌نام کنید و اعتبار مشتری خود را دریافت کنید.

لطفاً دستورالعمل های زیر را برای ادغام اسناد دنبال کنید:

اول از همه، Client ID و Client Secret اطلاعات را مشخص کنید.
در مرحله دوم، یک شی از کلاس 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 null باشد، WordsApi از https://api.aspose.cloud پیش فرض استفاده می کند 
// با ارائه ClientID و Client Secret یک شی از ApiClient ایجاد کنید
ApiClient apiClient = new ApiClient(clientId,clientSecret,null);

// با ارائه ApiClient به عنوان آرگومان، یک شی از WordsApi ایجاد کنید
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 ایجاد کنیم زیرا API های 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 با استفاده از شناسه مشتری و کلید مخفی مشتری5 مراجعه کنید.

پس از ایجاد 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 را یاد گرفتیم. همچنین می‌توانید ویژگی‌های هیجان‌انگیز API را از طریق اینترفیس Swagger در یک مرورگر وب بررسی کنید.

علاوه بر این، Cloud SDK های ما منبع باز هستند و کد منبع کامل را می توان از GitHub دانلود کرد. همچنین توصیه می کنیم برای جزئیات در مورد سایر ویژگی های هیجان انگیز ارائه شده توسط API از محصول Documentation دیدن کنید. نظرات شما برای ما بسیار مهم است. بنابراین، لطفاً با استفاده از [تالارهای پشتیبانی 12 با ما تماس بگیرید.

مقالات مرتبط

توصیه می کنیم برای کسب اطلاعات بیشتر به لینک های زیر مراجعه کنید:

API اسناد ادغام#