چگونه چندین سند Word را در Node.JS ترکیب کنیم

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

ترکیب چندین سند 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 فرآیند ادغام را به چند گام منطقی انتزاع می‌کند:

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

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

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

const mergeApi = new GroupDocsMergerCloud.MergeApi(config);

Document Entries - هر فایل منبع در یک DocumentEntry بسته می‌شود که شامل یک FileInfo با مسیر فایل است.

const documentEntries = inputFiles.map(path => {
    return new GroupDocsMergerCloud.Models.DocumentEntry({
        fileInfo: new GroupDocsMergerCloud.Models.FileInfo({ filePath: path })
    });
});

درخواست ادغام - MergeDocumentsRequest ورودی‌ها و مسیر خروجی مورد نظر را بسته‌بندی می‌کند.

const mergeRequest = new GroupDocsMergerCloud.Models.MergeDocumentsRequest({
    documents: documentEntries,
    outputPath: outputFile
});

اجرا - mergeApi.mergeDocuments(mergeRequest) درخواست را به سرویس ابری ارسال می‌کند. پرومیس با یک شیء نتیجه که مسیر فایل خروجی را شامل می‌شود، حل می‌شود.
```
const result = await mergeApi.mergeDocuments(mergeRequest);
console.log(`Merge completed successfully. Output file: ${result.path}`);
```

این مراحل به‌طور مشترک به شما امکان می‌دهند تا چندین سند Word را به‌صورت کارآمد ترکیب کنید بدون اینکه نیاز به مدیریت جریان‌های فایل سطح پایین داشته باشید.

آماده‌سازی محیط برای GroupDocs.Merger

نصب SDK

npm install groupdocs-merger-cloud

این بسته از صفحه دانلود رسمی در دسترس است.

نسخه Node.js - اطمینان حاصل کنید که Node.js 12 یا نسخه بالاتر را اجرا می‌کنید.
Configure Credentials - در کد، YOUR_CLIENT_ID و YOUR_CLIENT_SECRET را با مقادیر حساب GroupDocs Cloud خود جایگزین کنید.
ایجاد پوشه پروژه - فایل‌های 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 انجام داده و سپس با استفاده از شناسه آن‌ها ارجاع دهید.
آیا برای توسعه در مقابل تولید نیاز به نگرانی درباره مجوز دارم؟
توسعه و تست می‌توانند از یک مجوز موقت که از صفحه مجوز موقت دریافت می‌شود، استفاده کنند. برای استقرارهای تولید، یک مجوز کامل خریداری کنید تا ادغام‌های نامحدود و پشتیبانی اولویت‌دار را باز کنید.

ترکیب چندین سند Word در Node.JS - مثال کامل کد#

ادغام اسناد Word از طریق REST API با استفاده از cURL#

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

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

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

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

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

آماده‌سازی محیط برای GroupDocs.Merger#

نتیجه‌گیری#

FAQs#

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