مثال کامل کارآمد برای ترکیب چندین سند 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#

چه چیزهایی برای خودکارسازی PowerPoint در C# لازم است

سازمان‌ها اغلب اسلایدهای ارائه را از قالب‌ها تولید می‌کنند که در آن عناوین، زیرعناوین یا فیلدهای داده‌ای باید به‌صورت خودکار به‌روزرسانی شوند. الزامات یک راه‌حل قوی شامل موارد زیر است:

• قابلیت یافتن و جایگزینی رشته‌های متنی خاص در داخل فایل‌های PPTX.
• پشتیبانی از پردازش مبتنی بر ابر به‌طوری‌که کد بر روی هر سروری بدون نصب Office اجرا شود.
• مدیریت خطا به‌صورت واضح و پیکربندی آسان مسیرهای ورودی و خروجی.

ویرایش دستی یا استفاده از اسکریپت‌های عمومی سیستم‌فایل نمی‌تواند سازگاری را در میان ده‌ها ارائه تضمین کند، به‌ویژه زمانی که محتوا به‌طور مکرر تغییر می‌کند.

رویکرد: ویرایش پاورپوینت مبتنی بر ابر

GroupDocs.Editor Cloud SDK for .NET این نیازها را با یک API مبتنی بر REST که کاملاً در ابر کار می‌کند، برآورده می‌کند. قابلیت‌های کلیدی شامل:

• EditDocument - متن، تصاویر یا اشکال را در فایل‌های PPTX بدون دانلود کل سند جایگزین کنید.
• FileInfo - فایل‌های منبع ذخیره‌شده در فضای ذخیره‌سازی GroupDocs Cloud را مشخص کنید.
• EditDocumentOptions - محل خروجی و فهرستی از جایگزینی‌های متن را تعریف کنید.

SDK احراز هویت، پخش فایل و ویرایش‌های حفظ قالب را مدیریت می‌کند و به شما امکان می‌دهد بر منطق کسب‌وکار تمرکز کنید. مستندات دقیق در مستندات رسمی موجود است.

پیاده‌سازی ویرایش ارائه‌های PowerPoint در C# با GroupDocs.Editor Cloud

در ادامه یک راهنمای گام‌به‌گام آورده شده است. هر گام شامل یک قطعه کد کوتاه است که مستقیماً از مثال کامل گرفته شده است.

نصب SDK و افزودن بسته NuGet

اول، کتابخانه را به پروژه خود اضافه کنید.

dotnet add package GroupDocs.editor-Cloud

همچنین می‌توانید آخرین نسخه را از صفحهٔ دانلود دریافت کنید.

پیکربندی اعتبارنامه‌های API

یک شیء Configuration را با شناسهٔ مشتری و رمز عبور خود ایجاد کنید.

var config = new Configuration
{
    ClientId = "YOUR_CLIENT_ID",
    ClientSecret = "YOUR_CLIENT_SECRET"
};

کلاس Configuration در مرجع API توصیف شده است.

راه‌اندازی Editor API

یک نمونه از EditorApi را با استفاده از پیکربندی ایجاد کنید.

var editorApi = new EditorApi(config);

این شیء تمام عملیات ویرایشی را فراهم می‌کند.

تعریف گزینه‌های ویرایش (جایگزینی متن‌های پیش‌فرض)

فایل منبع، مسیر خروجی و جایگزینی‌های متنی مورد نیاز خود را تنظیم کنید.

var editOptions = new EditDocumentOptions
{
    FileInfo = new FileInfo { FilePath = "sample.pptx" },
    OutputPath = "sample_edited.pptx",
    EditTexts = new List<EditText>
    {
        new EditText { Text = "OldTitle", NewText = "New Title" },
        new EditText { Text = "OldSubtitle", NewText = "Updated Subtitle" }
    }
};

مجموعه EditTexts به شما امکان می‌دهد تا در یک فراخوانی، هر تعداد جای‌گیر را جایگزین کنید.

اجرای عملیات ویرایش و مدیریت پاسخ

درخواست را ایجاد کنید و EditDocument را فراخوانی کنید.

var request = new EditDocumentRequest(editOptions);
var response = editorApi.EditDocument(request);
Console.WriteLine($"Edited PowerPoint saved to: {response.Path}");

پاسخ شامل مسیر فایل ویرایش‌شده در ذخیره‌سازی ابری است.

مثال کامل کد: ویرایش ارائه‌های PowerPoint در C# - جریان کاری کامل

کد زیر کل فرآیند را از ابتدا تا انتها نشان می‌دهد.

using System;
using System.Collections.Generic;
using GroupDocs.Editor.Cloud.Sdk.Api;
using GroupDocs.Editor.Cloud.Sdk.Client;
using GroupDocs.Editor.Cloud.Sdk.Model;
using GroupDocs.Editor.Cloud.Sdk.Model.Requests;

namespace GroupDocsEditorDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // Configure API credentials
            var config = new Configuration
            {
                ClientId = "YOUR_CLIENT_ID",
                ClientSecret = "YOUR_CLIENT_SECRET"
            };

// Initialize the Editor API
            var editorApi = new EditorApi(config);

// Define input and output PowerPoint files
            string inputFilePath = "sample.pptx";
            string outputFilePath = "sample_edited.pptx";

// Set up editing options (replace placeholder texts)
            var editOptions = new EditDocumentOptions
            {
                FileInfo = new FileInfo { FilePath = inputFilePath },
                OutputPath = outputFilePath,
                EditTexts = new List<EditText>
                {
                    new EditText { Text = "OldTitle", NewText = "New Title" },
                    new EditText { Text = "OldSubtitle", NewText = "Updated Subtitle" }
                }
            };

// Create the request
            var request = new EditDocumentRequest(editOptions);

try
            {
                // Perform the edit operation
                var response = editorApi.EditDocument(request);
                Console.WriteLine($"Edited PowerPoint saved to: {response.Path}");
            }
            catch (ApiException apiEx)
            {
                Console.WriteLine($"API error ({apiEx.ErrorCode}): {apiEx.Message}");
            }
            catch (Exception ex)
            {
                Console.WriteLine($"Unexpected error: {ex.Message}");
            }
        }
    }
}

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

ویرایش PowerPoint با cURL و REST API

اگر رویکردی مستقل از زبان را ترجیح می‌دهید، می‌توانید همان عملیات ویرایش را با فراخوانی‌های cURL انجام دهید.

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

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"}'

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

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

3. اجرای عملیات ویرایش

curl -X POST "https://api.groupdocs.cloud/v2.0/editor/edit" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "sample.pptx" },
           "outputPath": "sample_edited.pptx",
           "editTexts": [
               { "text": "OldTitle", "newText": "New Title" },
               { "text": "OldSubtitle", "newText": "Updated Subtitle" }
           ]
         }'

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

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/download/sample_edited.pptx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o sample_edited.pptx

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

تنظیم دقیق گزینه‌های ویرایش PowerPoint

SDK گزینه‌های اضافی را ارائه می‌دهد که می‌توانید تنظیم کنید:

• OutputPath - یک پوشه یا نام فایل متفاوت برای ارائه ویرایش‌شده انتخاب کنید.
• EditTexts - به تعداد مورد نیاز اشیاء EditText اضافه کنید تا چندین جایگزین‌کننده را جایگزین کنید.
• FileInfo.StorageName - اگر از چندین فضای ذخیره‌سازی ابری استفاده می‌کنید، مکان ذخیره‌سازی سفارشی را مشخص کنید.

این گزینه‌ها بخشی از کلاس EditDocumentOptions هستند که در مرجع API ارجاع داده شده‌اند.

نتیجه‌گیری

ویرایش ارائه‌های PowerPoint در C# با GroupDocs.Editor Cloud SDK for .NET به سادگی انجام می‌شود. این کتابخانه احراز هویت، مدیریت فایل و جایگزینی متن را مدیریت می‌کند و به شما امکان می‌دهد بر منطق کسب‌وکار تمرکز کنید. به‌خاطر داشته باشید که برای استفاده در محیط تولید، یک لایسنس مناسب دریافت کنید؛ می‌توانید با یک لایسنس موقت از صفحه صفحه لایسنس موقت شروع کنید. با نمونه کد و جریان کاری cURL ارائه‌شده، آماده‌اید تا ویرایش پویا اسلایدها را در هر برنامه .NET یکپارچه کنید.

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

چگونه می‌توانم ارائه‌های Powerpoint را در C# با استفاده از GroupDocs.Editor Cloud ویرایش کنم؟
پس از پیکربندی EditDocumentOptions با فایل منبع، مسیر خروجی و فهرستی از جایگزینی‌های EditText، از متد EditDocument استفاده کنید. مثال کامل در بخش قبلی این راهنما نشان داده شده است.

آیا می‌توانم چندین جای‌دار را در یک فایل PowerPoint جایگزین کنم؟
بله. مجموعه EditTexts را با هر تعداد شیء EditText که نیاز است پر کنید؛ SDK تمام جایگزینی‌ها را در یک درخواست پردازش خواهد کرد.

اگر فایل ویرایش‌شده تولید نشد چه کار کنم؟
بررسی کنید که OutputPath به‌درستی تنظیم شده باشد و پاسخ API شامل یک Path معتبر باشد. همچنین اعتبارنامه‌ها و مجوزهای ذخیره‌سازی خود را از طریق پورتال GroupDocs تأیید کنید.

آیا برای استقرارهای تولیدی به لایسنس نیاز دارم؟
یک لایسنس معتبر برای تولید لازم است. می‌توانید در حین ارزیابی SDK، یک لایسنس موقت را از صفحه لایسنس موقت دریافت کنید.

ادامه مطلب

• ویرایش ارائه‌های PowerPoint با استفاده از Python
• ویرایش فایل‌های PowerPoint با استفاده از کتابخانه Java
• بهترین شیوه‌ها برای توسعه ویرایشگر CSV در Java

ترکیب چندین سند 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);
    }
})();

Note: این مثال کد عملکرد اصلی را نشان می‌دهد. قبل از استفاده از آن در پروژه خود، مطمئن شوید مسیرهای فایل (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"

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

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

برای جزئیات بیشتر در مورد payloadهای درخواست و گزینه‌ها، به مستندات رسمی API مراجعه کنید.

نحوه کار ادغام چندین سند Word در Node.JS

SDK فرآیند ادغام را به چند گام منطقی انتزاع می‌کند:

1. ایجاد پیکربندی - new GroupDocsMergerCloud.Configuration(clientId, clientSecret) زمینه احراز هویت را می‌سازد. برای مشاهده مرجع کلاس به API Reference مراجعه کنید.

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

2. نمونه API - new GroupDocsMergerCloud.MergeApi(config) دسترسی به عملیات ادغام را فراهم می‌کند.

const mergeApi = new GroupDocsMergerCloud.MergeApi(config);

3. Document Entries - هر فایل منبع در یک 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. Configure Credentials - در کد، YOUR_CLIENT_ID و YOUR_CLIENT_SECRET را با مقادیر حساب GroupDocs Cloud خود جایگزین کنید.

4. ایجاد پوشه پروژه - فایل‌های DOCX منبع را در یک زیرپوشه documents/ همان‌طور که در مثال نشان داده شده است، قرار دهید.

با تکمیل این مراحل، آماده اجرای اسکریپت ادغام یا فراخوانی نقاط انتهایی REST هستید.

نتیجه‌گیری

ترکیب چندین سند Word در Node.JS به‌سادگی انجام می‌شود با GroupDocs.Merger Cloud SDK for Node.js. SDK بارگذاری فایل‌ها، منطق ادغام و تولید خروجی را مدیریت می‌کند، به‌طوری که می‌توانید بر منطق کسب‌وکار تمرکز کنید نه دست‌کاری سطح پایین فایل‌ها. به یاد داشته باشید برای استفاده در محیط تولید یک لایسنس مناسب تهیه کنید؛ می‌توانید با یک لایسنس موقت شروع کنید و با رشد نیازهای خود به اشتراک‌گذاری کامل ارتقا دهید. امروز شروع به ادغام کنید و گردش کار اسناد خود را بهینه کنید.

FAQs

• چگونه می‌توانم چندین سند Word را در Node.JS با استفاده از SDK ترکیب کنم؟
  از کلاس MergeApi برای ایجاد یک MergeDocumentsRequest استفاده کنید که هر فایل DOCX را به عنوان یک DocumentEntry فهرست می‌کند. SDK آنها را به ترتیب ارائه‌شده ترکیب می‌کند و نتیجه را در مسیر خروجی مشخص شده ذخیره می‌نماید.

• آیا امکان ترکیب PDFها با همان SDK وجود دارد؟
  بله، Merger SDK از PDF، DOCX، ODT و چندین فرمت دیگر پشتیبانی می‌کند. به سادگی پسوندهای فایل‌ها را در آرایه inputFiles تغییر دهید و SDK به‌طور خودکار تبدیل را انجام خواهد داد. برای جزئیات فرمت‌ها، مستندات رسمی را ببینید.

• حدود تعداد اسنادی که می‌توانم در یک درخواست ادغام کنم چیست؟
  سرویس ابری محدودیت اندازه را اعمال می‌کند نه تعداد دقیق. تا زمانی که اندازه ترکیبی در سهمیه حساب شما باقی بماند، می‌توانید ده‌ها فایل را ادغام کنید. برای دسته‌های بسیار بزرگ، ابتدا بارگذاری فایل‌ها را در GroupDocs storage انجام داده و سپس با استفاده از شناسه آن‌ها ارجاع دهید.

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

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

• حفاظت از فایل ZIP با استفاده از نرم‌افزار حفاظت از رمز عبور
• حفاظت از Excel با استفاده از سرویس حفاظت از رمز عبور
• ترکیب اسناد Word در C#