Kết hợp nhiều tài liệu Word trong Node.JS - Ví dụ mã hoàn chỉnh

Ví dụ này minh họa cách hợp nhất ba tệp DOCX thành một tài liệu duy nhất bằng cách sử dụng 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);
    }
})();

Lưu ý: Ví dụ mã này minh họa chức năng cốt lõi. Trước khi sử dụng trong dự án của bạn, hãy đảm bảo cập nhật các đường dẫn tệp (input1.docx, combined_output.docx, v.v.) cho phù hợp với vị trí tệp thực tế của bạn, xác minh rằng tất cả các phụ thuộc cần thiết đã được cài đặt đúng cách, và kiểm tra kỹ lưỡng trong môi trường phát triển. Nếu bạn gặp bất kỳ vấn đề nào, vui lòng tham khảo tài liệu chính thức hoặc liên hệ với đội hỗ trợ để được trợ giúp.

Kết hợp tài liệu Word qua REST API bằng cURL

Nếu bạn ưu tiên cách tiếp cận REST thuần túy, cùng một thao tác hợp nhất có thể được thực hiện bằng các lệnh cURL. Dưới đây là quy trình ngắn gọn xác thực, tải lên các tệp nguồn, thực hiện hợp nhất và tải xuống kết quả.

1. Xác thực và Lấy Mã Truy cập

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

Phản hồi chứa một access_token được sử dụng trong các cuộc gọi tiếp theo.

2. Tải lên các tệp nguồn

Lặp lại bước này cho mỗi tệp DOCX mà bạn muốn hợp nhất.

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. Thực hiện thao tác hợp nhất

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 trả về đường dẫn của tệp đã hợp nhất.

4. Tải xuống tài liệu đã hợp nhất

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

Để biết thêm chi tiết về payload yêu cầu và các tùy chọn, xem tài liệu API chính thức.

Cách hoạt động của việc hợp nhất nhiều tài liệu Word trong Node.JS

SDK trừu tượng hóa quá trình hợp nhất thành một vài bước logic:

1. Tạo cấu hình - new GroupDocsMergerCloud.Configuration(clientId, clientSecret) tạo ngữ cảnh xác thực. Xem tham chiếu lớp trong API Reference.

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

2. API Instance - new GroupDocsMergerCloud.MergeApi(config) cung cấp quyền truy cập vào các thao tác hợp nhất.

   const mergeApi = new GroupDocsMergerCloud.MergeApi(config);
   

3. Các mục tài liệu - Mỗi tệp nguồn được bao bọc trong một DocumentEntry chứa một FileInfo với đường dẫn tệp.

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

4. Yêu cầu hợp nhất - MergeDocumentsRequest gói các mục và đường dẫn đầu ra mong muốn.

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

5. Thực thi - mergeApi.mergeDocuments(mergeRequest) gửi yêu cầu tới dịch vụ đám mây. Promise trả về một đối tượng kết quả chứa đường dẫn tệp đầu ra.

   const result = await mergeApi.mergeDocuments(mergeRequest);
   console.log(`Merge completed successfully. Output file: ${result.path}`);
   

Các bước này cùng nhau cho phép bạn kết hợp nhiều tài liệu Word một cách hiệu quả mà không cần xử lý các luồng tệp cấp thấp.

Chuẩn bị môi trường cho GroupDocs.Merger

1. Cài đặt SDK

npm install groupdocs-merger-cloud

Gói có sẵn từ trang tải xuống chính thức.

2. Node.js Version - Đảm bảo bạn đang chạy Node.js 12 hoặc mới hơn.

3. Cấu hình thông tin xác thực - Thay thế YOUR_CLIENT_ID và YOUR_CLIENT_SECRET trong mã bằng các giá trị từ tài khoản GroupDocs Cloud của bạn.

4. Tạo Thư Mục Dự Án - Đặt các tệp DOCX nguồn vào thư mục con documents/ như được minh họa trong ví dụ.

Với các bước này đã hoàn thành, bạn đã sẵn sàng để chạy script hợp nhất hoặc gọi các endpoint REST.

Kết luận

Kết hợp nhiều tài liệu Word trong Node.JS trở nên đơn giản với GroupDocs.Merger Cloud SDK for Node.js. SDK xử lý việc tải lên tệp, logic hợp nhất và tạo đầu ra, cho phép bạn tập trung vào logic nghiệp vụ thay vì thao tác tệp cấp thấp. Hãy nhớ đảm bảo có giấy phép phù hợp cho việc sử dụng trong môi trường sản xuất; bạn có thể bắt đầu với một giấy phép tạm thời và nâng cấp lên đăng ký đầy đủ khi nhu cầu của bạn tăng lên. Bắt đầu hợp nhất ngay hôm nay và tối ưu hoá quy trình công việc tài liệu của bạn.

Câu hỏi thường gặp

• Làm thế nào để kết hợp nhiều tài liệu Word trong Node.JS bằng SDK?
  Sử dụng lớp MergeApi để tạo một MergeDocumentsRequest liệt kê mỗi tệp DOCX dưới dạng DocumentEntry. SDK sẽ hợp nhất chúng theo thứ tự đã cung cấp và lưu kết quả vào đường dẫn đầu ra đã chỉ định.

• Liệu có thể hợp nhất các tệp PDF lại với cùng một SDK không?
  Có, Merger SDK hỗ trợ PDF, DOCX, ODT, và một số định dạng khác. Chỉ cần thay đổi phần mở rộng tệp trong mảng inputFiles và SDK sẽ tự động xử lý việc chuyển đổi. Xem tài liệu chính thức để biết chi tiết về các định dạng.

• Giới hạn về số lượng tài liệu tôi có thể hợp nhất trong một yêu cầu là bao nhiêu?
  Dịch vụ đám mây áp dụng giới hạn kích thước thay vì số lượng cố định. Miễn là tổng kích thước vẫn nằm trong hạn mức tài khoản của bạn, bạn có thể hợp nhất hàng chục tệp. Đối với các lô rất lớn, hãy cân nhắc tải các tệp lên lưu trữ GroupDocs trước và tham chiếu chúng bằng ID.

• Tôi có cần lo lắng về giấy phép cho phát triển so với sản xuất không?
  Phát triển và kiểm thử có thể sử dụng giấy phép tạm thời được lấy từ trang giấy phép tạm thời. Đối với triển khai sản xuất, mua giấy phép đầy đủ để mở khóa số lần hợp nhất không giới hạn và hỗ trợ ưu tiên.

Đọc thêm

• Bảo vệ tệp ZIP bằng phần mềm bảo vệ mật khẩu
• Bảo vệ Excel bằng dịch vụ bảo vệ mật khẩu
• Kết hợp tài liệu Word trong C#