ترکیب چندین مجموعه PowerPoint در یک ارائهٔ واحد یک نیاز مکرر هنگام تجمیع گزارش‌ها یا مواد آموزشی است. GroupDocs.Merger Cloud SDK for Java به توسعه‌دهندگان Java امکان ترکیب و ادغام Powerpoint PPT PPTX در Java را با تنها چند خط کد می‌دهد. در این راهنما ما به تنظیمات مورد نیاز، پیاده‌سازی گام‌به‌گام دقیق، یک مثال کامل قابل اجرا، و نحوه انجام همان عملیات از طریق REST API با استفاده از cURL می‌پردازیم.

راه‌اندازی GroupDocs.Merger Cloud SDK for Java

قبل از شروع کدنویسی، مطمئن شوید که موارد زیر را دارید:

  • کیت توسعه جاوا (JDK) نسخه 8 یا بالاتر.
  • یک IDE مانند IntelliJ IDEA یا Eclipse.
  • یک حساب GroupDocs Cloud با client ID و client secret.

وابستگی Maven را به pom.xml خود اضافه کنید:

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

آخرین کتابخانه را از صفحه رسمی انتشار دانلود کنید: GroupDocs.Merger Cloud SDK for Java Download. پس از حل وابستگی، آماده‌اید تا کدی بنویسید که فایل‌های PowerPoint را ترکیب می‌کند.

ساخت آن گام به گام: ترکیب و ادغام Powerpoint PPT PPTX در Java

مرحله 1: مقداردهی اولیه کلاینت API

یک ApiClient را با اعتبارهای خود ایجاد کنید و MergerApi را نمونه‌سازی کنید.

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

مرحله ۲: تعریف فایل‌های منبع PowerPoint

برای هر ارائه‌ای که می‌خواهید ترکیب کنید، اشیاء FileInfo را ایجاد کنید.

FileInfo sourceFile1 = new FileInfo();
sourceFile1.setFilePath("input1.pptx"); // first PPTX file

FileInfo sourceFile2 = new FileInfo();
sourceFile2.setFilePath("input2.ppt"); // second PPT file

مرحله 3: تنظیم گزینه‌های ادغام

فایل‌های منبع را به یک لیست اضافه کنید و مسیر خروجی را مشخص کنید.

List<FileInfo> sourceFiles = new ArrayList<>();
sourceFiles.add(sourceFile1);
sourceFiles.add(sourceFile2);

MergeOptions mergeOptions = new MergeOptions();
mergeOptions.setFileInfos(sourceFiles);          // files to be merged
mergeOptions.setOutputPath("merged_output.pptx"); // result file

مرحله 4: اجرای درخواست ادغام

یک MergeRequest ایجاد کنید و متد merge را فراخوانی کنید.

MergeRequest mergeRequest = new MergeRequest(mergeOptions);
try {
    MergeResult mergeResult = mergerApi.merge(mergeRequest);
    System.out.println("Merge successful. Output file stored at: " + mergeResult.getPath());
} catch (Exception e) {
    System.err.println("An error occurred during merging: " + e.getMessage());
    e.printStackTrace();
}

کد بالا جریان کاری کامل برای ترکیب و ادغام Powerpoint PPT PPTX در Java را با استفاده از SDK نشان می‌دهد.

مثال کامل کد: ترکیب و ادغام فایل‌های پاورپوینت در جاوا

مثال زیر تمام قطعات را در یک برنامهٔ آماده‑به‑اجرا ترکیب می‌کند.

import com.groupdocs.merger.cloud.ApiClient;
import com.groupdocs.merger.cloud.api.MergerApi;
import com.groupdocs.merger.cloud.model.FileInfo;
import com.groupdocs.merger.cloud.model.MergeOptions;
import com.groupdocs.merger.cloud.model.requests.MergeRequest;
import com.groupdocs.merger.cloud.model.responses.MergeResult;

import java.util.ArrayList;
import java.util.List;

public class PowerPointMergeExample {
    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);

// Define the source PowerPoint files
        FileInfo sourceFile1 = new FileInfo();
        sourceFile1.setFilePath("input1.pptx"); // first PPTX file

FileInfo sourceFile2 = new FileInfo();
        sourceFile2.setFilePath("input2.ppt"); // second PPT file

List<FileInfo> sourceFiles = new ArrayList<>();
        sourceFiles.add(sourceFile1);
        sourceFiles.add(sourceFile2);

// Set merge options
        MergeOptions mergeOptions = new MergeOptions();
        mergeOptions.setFileInfos(sourceFiles);          // files to be merged
        mergeOptions.setOutputPath("merged_output.pptx"); // result file

// Create and execute the merge request
        MergeRequest mergeRequest = new MergeRequest(mergeOptions);
        try {
            MergeResult mergeResult = mergerApi.merge(mergeRequest);
            System.out.println("Merge successful. Output file stored at: " + mergeResult.getPath());
        } catch (Exception e) {
            System.err.println("An error occurred during merging: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

توجه: این مثال کد عملکرد اصلی را نشان می‌دهد. قبل از استفاده از آن در پروژه خود، مطمئن شوید مسیرهای فایل (input1.pptx, input2.ppt, merged_output.pptx) را به مکان‌های واقعی خود به‌روز کنید، اطمینان حاصل کنید که تمام وابستگی‌های مورد نیاز به‌درستی نصب شده‌اند و به‌طور کامل در محیط توسعه خود تست کنید. اگر با مشکلی مواجه شدید، لطفاً به مستندات رسمی مراجعه کنید یا برای دریافت کمک به تیم پشتیبانی مراجعه نمایید.

ادغام ارائه‌های پاورپوینت با cURL و REST API

می‌توانید همان عملیات ادغام را بدون نوشتن کد Java با فراخوانی نقاط انتهایی REST GroupDocs Merger انجام دهید. در زیر یک جریان کاری معمولی cURL آورده شده است.

1. احراز هویت و دریافت توکن دسترسی

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

پاسخ شامل یک access_token است که در تماس‌های بعدی از آن استفاده خواهید کرد.

2. بارگذاری فایل‌های منبع

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file/upload?path=input1.pptx" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@/local/path/input1.pptx"

دستور را برای input2.ppt تکرار کنید.

3. اجرای عملیات ادغام

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

API یک شیء JSON را با مسیر فایل ادغام‌شده برمی‌گرداند.

4. دانلود فایل ترکیب‌شده

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

برای جزئیات بیشتر، به مرجع رسمی API مراجعه کنید.

گزینه‌های ادغام: پیکربندی و تنظیمات

در حالی که مثال پایه برای اکثر سناریوها کار می‌کند، SDK گزینه‌های اضافی‌ای را ارائه می‌دهد که می‌توانید تنظیم کنید.

مسیر خروجی

یک پوشه یا نام فایل سفارشی را مشخص کنید.

mergeOptions.setOutputPath("reports/combined_presentation.pptx");

حفاظت با رمز عبور (در صورت نیاز)

mergeOptions.setPassword("StrongPassword123");

حفظ طرح اصلی

mergeOptions.setPreserveLayout(true);

این ویژگی‌ها بخشی از کلاس MergeOptions هستند؛ برای دریافت فهرست کامل به مرجع API مراجعه کنید.

نتیجه‌گیری

با استفاده از GroupDocs.Merger Cloud SDK for Java، می‌توانید به راحتی ترکیب و ادغام Powerpoint PPT PPTX در Java را انجام دهید، چه کتابخانه بومی Java را ترجیح دهید و چه رویکرد RESTful cURL. SDK مدیریت ذخیره‌سازی فایل، منطق ادغام و تولید خروجی را بر عهده می‌گیرد و به شما امکان می‌دهد بر ویژگی‌های اصلی برنامه‌تان تمرکز کنید. به یاد داشته باشید برای استفاده در تولید، یک لایسنس مناسب دریافت کنید؛ جزئیات قیمت‌گذاری در صفحه محصول موجود است و می‌توانید برای ارزیابی یک لایسنس موقت درخواست کنید در صفحه لایسنس موقت. امروز ادغام PowerPoint را شروع کنید و جریان کار اسناد خود را بهینه کنید.

سوالات متداول

  • چه فرمت‌هایی را می‌توانم با SDK ترکیب کنم؟
    SDK هم فایل‌های PPT و PPTX را پشتیبانی می‌کند، همچنین بسیاری از انواع دیگر اسناد که در مرجع API فهرست شده‌اند.

  • آیا قبل از ادغام نیاز به تبدیل فایل‌های PPT قدیمی دارم؟
    نیازی به تبدیل نیست. SDK به‌صورت خودکار ترکیب منابع PPT و PPTX را در فرآیند ادغام مدیریت می‌کند.

  • چگونه SDK ارائه‌های بزرگ را مدیریت می‌کند؟
    ادغام در سمت سرور انجام می‌شود، بنابراین مصرف حافظه در ماشین کلاینت شما کم می‌ماند. همچنین می‌توانید گزینه PreserveLayout را برای بهینه‌سازی عملکرد تنظیم کنید.

  • آیا می‌توانم ارائه‌ها را بدون نوشتن کد جاوا ترکیب کنم؟
    بله. از REST API با دستورات cURL همان‌طور که قبلاً نشان داده شد استفاده کنید، یا فراخوانی‌ها را در هر زبانی که می‌تواند درخواست‌های HTTP ارسال کند، ادغام کنید.

بیشتر بخوانید