หลายนักพัฒนาต้องการรวมหลายเอกสาร 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);
    }
})();

หมายเหตุ: ตัวอย่างโค้ดนี้แสดงการทำงานหลัก ก่อนนำไปใช้ในโครงการของคุณ โปรดตรวจสอบให้แน่ใจว่าได้อัปเดตเส้นทางไฟล์ (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"

3. ดำเนินการผสานเอกสาร

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 Instance - 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 })
    });
});
  1. Merge Request - MergeDocumentsRequest รวมรายการและเส้นทางเอาต์พุตที่ต้องการ.

    const mergeRequest = new GroupDocsMergerCloud.Models.MergeDocumentsRequest({
        documents: documentEntries,
        outputPath: outputFile
    });
    
  2. การดำเนินการ - mergeApi.mergeDocuments(mergeRequest) ส่งคำขอไปยังบริการคลาวด์. Promise จะคืนค่าเป็นอ็อบเจกต์ผลลัพธ์ที่มีเส้นทางไฟล์ผลลัพธ์.

    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

แพ็กเกจนี้พร้อมให้ดาวน์โหลดจากหน้า หน้าดาวน์โหลด อย่างเป็นทางการ.

  1. เวอร์ชัน Node.js - ตรวจสอบว่าคุณกำลังใช้ Node.js 12 หรือใหม่กว่า.

  2. กำหนดค่า Credentials - แทนที่ YOUR_CLIENT_ID และ YOUR_CLIENT_SECRET ในโค้ดด้วยค่าจากบัญชี GroupDocs Cloud ของคุณ.

  3. สร้างโฟลเดอร์โปรเจกต์ - วางไฟล์ DOCX ต้นฉบับในโฟลเดอร์ย่อย documents/ ตามที่แสดงในตัวอย่าง.

เมื่อทำตามขั้นตอนเหล่านี้เสร็จแล้ว คุณพร้อมที่จะเรียกใช้สคริปต์การรวมหรือเรียกใช้ REST endpoints

สรุป

การรวมหลายเอกสาร Word ใน Node.JS กลายเป็นเรื่องง่ายด้วย GroupDocs.Merger Cloud SDK for Node.js. SDK จัดการการอัปโหลดไฟล์, โลจิกการรวม, และการสร้างผลลัพธ์, ทำให้คุณสามารถมุ่งเน้นที่ตรรกะธุรกิจแทนการจัดการไฟล์ระดับต่ำ. อย่าลืมรับใบอนุญาตที่เหมาะสมสำหรับการใช้งานในสภาพแวดล้อมการผลิต; คุณสามารถเริ่มต้นด้วย ใบอนุญาตชั่วคราว และอัปเกรดเป็นการสมัครสมาชิกเต็มรูปแบบเมื่อความต้องการของคุณเพิ่มขึ้น. เริ่มรวมไฟล์วันนี้และทำให้กระบวนการทำงานเอกสารของคุณเป็นระเบียบมากขึ้น.

คำถามที่พบบ่อย

  • ฉันจะรวมเอกสาร Word หลายไฟล์ใน Node.JS โดยใช้ SDK ได้อย่างไร?
    ใช้คลาส MergeApi เพื่อสร้าง MergeDocumentsRequest ที่ระบุไฟล์ DOCX แต่ละไฟล์เป็น DocumentEntry. SDK จะทำการรวมไฟล์เหล่านั้นตามลำดับที่ระบุและบันทึกผลลัพธ์ไปยังเส้นทางเอาต์พุตที่กำหนด.

  • สามารถรวมไฟล์ PDF เข้าด้วยกันได้ด้วย SDK เดียวกันหรือไม่?
    ใช่, Merger SDK รองรับ PDF, DOCX, ODT, และหลายรูปแบบอื่น ๆ เพียงเปลี่ยนส่วนขยายของไฟล์ในอาร์เรย์ inputFiles แล้ว SDK จะจัดการการแปลงโดยอัตโนมัติ ดูที่ เอกสารอย่างเป็นทางการ สำหรับรายละเอียดรูปแบบ.

  • จำนวนเอกสารที่ฉันสามารถรวมในคำขอเดียวได้มีขีดจำกัดเท่าใด?
    บริการคลาวด์กำหนดขีดจำกัดตามขนาดแทนที่จะเป็นจำนวนที่แน่นอน ตราบใดที่ขนาดรวมยังอยู่ในโควต้าของบัญชีของคุณ คุณสามารถรวมไฟล์ได้หลายสิบไฟล์ สำหรับชุดข้อมูลขนาดใหญ่มาก ให้พิจารณาอัปโหลดไฟล์ไปยังที่เก็บข้อมูลของ GroupDocs ก่อนและอ้างอิงโดยใช้ ID

  • ฉันต้องกังวลเรื่องการให้สิทธิ์สำหรับการพัฒนาเทียบกับการผลิตหรือไม่?
    การพัฒนาและการทดสอบสามารถใช้ใบอนุญาตชั่วคราวที่ได้รับจาก หน้าลิขสิทธิ์ชั่วคราว ได้ สำหรับการใช้งานในสภาพแวดล้อมการผลิต ให้ซื้อใบอนุญาตเต็มเพื่อเปิดใช้งานการรวมไม่จำกัดและการสนับสนุนระดับแรก.

อ่านเพิ่มเติม