ادغام اسناد Word

اسناد Word را به صورت آنلاین در جاوا ادغام کنید

در یک محیط تیمی توزیع شده، اعضای مختلف تیم ممکن است روی ماژول‌های خاصی از سند کار کنند، که باید برای تولید یک نسخه تلفیقی ترکیب شوند. این عملیات را می توان با استفاده از برنامه های مختلف انجام داد، اما مراحل دستی برای ادغام اسناد word می تواند یک فعالیت خسته کننده باشد. بنابراین برای اینکه راه حلی مناسب تر داشته باشیم، می خواهیم جزئیات نحوه ترکیب اسناد word با استفاده از Java SDK را مورد بحث قرار دهیم.

API اسناد ادغام

Aspose.Words Cloud SDK for Java شما را قادر می سازد قابلیت های ایجاد، دستکاری و تبدیل سند Word را در برنامه های جاوا معرفی کنید. همچنین ویژگی ترکیب اسناد word برای تولید یک خروجی واحد را فراهم می کند. اکنون برای استفاده از SDK، لطفا جزئیات زیر را در فایل pom.xml خود از نوع ساخت Maven اضافه کنید.

<repositories>
    <repository>
        <id>AsposeJavaAPI</id>
        <name>Aspose Java API</name>
        <url>https://repository.aspose.cloud/repo/</url>
    </repository>
</repositories>
<dependencies>
    <dependency>
        <groupId>com.aspose</groupId>
        <artifactId>aspose-words-cloud</artifactId>
        <version>22.5.0</version>
    </dependency>
</dependencies>

پس از نصب، باید یک حساب رایگان در Aspose.Cloud dashboard با استفاده از GitHub یا حساب Google ثبت کنیم یا به سادگی ثبت نام کنید و اعتبار مشتری خود را دریافت کنید.

ترکیب اسناد Word در جاوا

لطفاً دستورالعمل‌های زیر را برای ترکیب اسناد Word با استفاده از یک قطعه کد جاوا دنبال کنید.

  • اولین مرحله ایجاد یک شی از کلاس WordsApi در حالی که شناسه مشتری و جزئیات Client Secret به عنوان آرگومان ارسال می شود.
  • در مرحله دوم، یک شی از DocumentEntry ایجاد کنید که سند را باید ادغام کند و سپس مقدار متد setImportFormatMode(..) را به عنوان KeepSourceFormatting تنظیم کنید.
  • حالا یک شی از ArrayList ایجاد کنید و شی DocumentEntry را داخل آن اضافه کنید
  • سپس یک شی از DocumentEntryList ایجاد کنید که شی ArrayList را به عنوان آرگومان می گیرد
  • آخرین اما نه کم اهمیت ترین، ایجاد یک شی از AppendDocumentOnlineRequest که فایل Word منبع و شی DocumentEntryList را به عنوان آرگومان می گیرد.
  • در نهایت، متد appendDocumentOnline(..) API را برای ادغام اسناد و ذخیره خروجی در فضای ذخیره سازی ابری فراخوانی کنید.
For more examples, please visit https://github.com/aspose-words-cloud/aspose-words-cloud-java

try
    {
    // ClientID و ClientSecret را از https://dashboard.aspose.cloud/ دریافت کنید
    String clientId = "bbf94a2c-6d7e-4020-b4d2-b9809741374e";
    String clientSecret = "1c9379bb7d701c26cc87e741a29987bb";
  
    // اگر baseUrl null باشد، WordsApi از https://api.aspose.cloud پیش فرض استفاده می کند
    WordsApi wordsApi = new WordsApi(clientId, clientSecret, null);

    String firstFile = "Resultant.docx";
    String documentToAppend = "TableDocument.doc";
    String resultantFile = "MergedFile.docx";
    
    // خواندن تمام بایت های ورودی سند Word
    byte[] requestDocument = Files.readAllBytes(Paths.get("c://Downloads/"+firstFile).toAbsolutePath());
    
    DocumentEntry requestDocumentListDocumentEntries0 = new DocumentEntry();
    requestDocumentListDocumentEntries0.setHref("c://Downloads/"+documentToAppend);
    requestDocumentListDocumentEntries0.setImportFormatMode("KeepSourceFormatting");
     
    ArrayList<DocumentEntry> requestDocumentListDocumentEntries = new ArrayList<DocumentEntry>();
    requestDocumentListDocumentEntries.add(requestDocumentListDocumentEntries0);

    DocumentEntryList requestDocumentList = new DocumentEntryList();
    requestDocumentList.setDocumentEntries(requestDocumentListDocumentEntries);

    AppendDocumentOnlineRequest appendRequest = new AppendDocumentOnlineRequest(requestDocument, requestDocumentList, null, null, null, resultantFile, null, null);
    wordsApi.appendDocumentOnline(appendRequest);
    
    System.out.println("Combine Word Documents in Java sucessfull !");
    }catch(Exception ex)
    {
        System.out.println(ex);
    }

ادغام اسناد Word با استفاده از دستورات cURL

دستورات cURL همچنین می توانند برای دسترسی به API های REST در هر پلتفرمی استفاده شوند. بنابراین در این بخش، ما قصد داریم جزئیات مربوط به نحوه ادغام اسناد word با استفاده از دستورات cURL را مورد بحث قرار دهیم. اکنون اولین مرحله تولید JSON Web Token (JWT) است، بنابراین لطفاً دستور زیر را در برنامه ترمینال اجرا کنید.

 curl -v "https://api.aspose.cloud/connect/token" \
 -X POST \
 -d "grant_type=client_credentials&client_id=a41d01ef-dfd5-4e02-ad29-bd85fe41e3e4&client_secret=d87269aade6a46cdc295b711e26809af" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Accept: application/json"

هنگامی که رمز JWT را دریافت کردیم، لطفاً دستور زیر را برای ادغام اسناد word از قبل موجود در فضای ذخیره سازی ابری اجرا کنید.

curl -v -X PUT "https://api.aspose.cloud/v4.0/words/ComparisonResult.docx/appendDocument?destFileName=MergedFile.docx" \
-H  "accept: application/json" \
-H  "Authorization: Bearer <JWT Token>" \
-H  "Content-Type: application/json" \
-d "{\"DocumentEntries\":[{\"Href\":\"SampleMailMergeTemplate.docx\",\"ImportFormatMode\":\"KeepSourceFormatting\"}],\"ApplyBaseDocumentHeadersAndFootersToAppendingDocuments\":true}"

نتیجه

ما در مورد جزئیات نحوه ترکیب اسناد word در جاوا و همچنین استفاده از دستورات cURL بحث کرده ایم. لطفاً توجه داشته باشید که کد منبع کامل SDK را می‌توانید از GitHub دانلود کنید. علاوه بر این، برای کشف قابلیت‌های API، ممکن است دسترسی به آن را از طریق اینترفیس Swagger در نظر بگیرید.

در صورتی که سؤالات بیشتری دارید یا با مشکلی روبرو هستید، لطفاً از [تالار گفتمان پشتیبانی رایگان6 دیدن کنید.

مقالات مرتبط

توصیه می کنیم از وبلاگ های زیر سر بزنید