Kết hợp nhiều tài liệu PDF thành một tệp duy nhất là một yêu cầu thường gặp khi xây dựng quy trình công việc tài liệu hoặc tạo báo cáo. GroupDocs.Merger Cloud SDK for Node.js giúp dễ dàng hợp nhất PDF trong Node.JS mà không cần xử lý các cấu trúc PDF cấp thấp. Hướng dẫn này sẽ đưa bạn qua quá trình cài đặt, triển khai từng bước, ví dụ mã đầy đủ, các lệnh cURL tương đương, và các mẹo hiệu năng cho các PDF lớn hoặc được mã hoá.

Trước Khi Bắt Đầu: Các Yêu Cầu Trước và Cài Đặt

Trước khi bắt đầu, hãy chắc chắn rằng bạn đã có những thứ sau:

  • Node.js 14 hoặc mới hơn được cài đặt trên máy phát triển của bạn.
  • Một tài khoản GroupDocs Cloud đang hoạt động với client ID và client secret.
  • Truy cập vào các tệp PDF mà bạn muốn kết hợp, được lưu trữ trong bộ nhớ GroupDocs Cloud.

Cài đặt SDK qua npm và tải gói mới nhất:

npm install groupdocs-merger-cloud

Bạn cũng có thể tải SDK từ trang phát hành chính thức: Download SDK. Sau khi cài đặt, bạn đã sẵn sàng để bắt đầu viết mã.

Hướng dẫn từng bước để hợp nhất PDF trong Node.JS

Bước 1: Cài đặt SDK và Nhập các lớp cần thiết

Đầu tiên, nhập các lớp mà bạn sẽ cần để hợp nhất các tệp PDF.

const { MergeApi, MergeOptions, FileInfo, Configuration } = require("@groupdocs/merger-cloud");

Lệnh import này cung cấp cho bạn quyền truy cập vào API lõi, các đối tượng cấu hình và các mô tả tệp.

Bước 2: Cấu hình Thông tin xác thực GroupDocs của bạn

Tạo một đối tượng cấu hình với thông tin xác thực client của bạn.

const config = new Configuration({
    clientId: "YOUR_CLIENT_ID",
    clientSecret: "YOUR_CLIENT_SECRET"
});

Cung cấp thông tin xác thực đúng sẽ cho phép thư viện xác thực các yêu cầu của bạn.

Bước 3: Xác định các tệp PDF cần hợp nhất

Liệt kê các tài liệu PDF mà bạn muốn kết hợp. Bước này chuẩn bị cho bạn việc hợp nhất PDF trong Node.JS một cách hiệu quả.

const filesToMerge = [
    new FileInfo({ filePath: "input1.pdf" }),
    new FileInfo({ filePath: "input2.pdf" })
];

Mỗi FileInfo chỉ tới một tệp được lưu trữ trong bộ nhớ đám mây GroupDocs của bạn.

Bước 4: Đặt tùy chọn hợp nhất

Cấu hình vị trí đầu ra và đính kèm danh sách tệp vào yêu cầu hợp nhất.

const mergeOptions = new MergeOptions();
mergeOptions.fileInfos = filesToMerge;
mergeOptions.outputPath = "merged_output.pdf";

Các cài đặt này kiểm soát cách bạn hợp nhất PDF trong Node.JS và nơi kết quả sẽ được lưu.

Bước 5: Thực hiện thao tác hợp nhất

Tạo một thể hiện API, gọi phương thức merge và xử lý phản hồi.

const mergeApi = new MergeApi(config);

try {
    const result = await mergeApi.mergeDocuments(mergeOptions);
    console.log("Merge completed. Output file stored at:", result.path);
} catch (error) {
    console.error("Error during PDF merge:", error);
}

Lời gọi async trả về đường dẫn của tài liệu đã hợp nhất nếu thao tác thành công.

Ví dụ triển khai đầy đủ cho việc hợp nhất PDF trong Node.JS

Đoạn mã sau đây trình bày quy trình làm việc đầy đủ từ cấu hình đến xử lý kết quả.

const { MergeApi, MergeOptions, FileInfo, Configuration } = require("@groupdocs/merger-cloud");

// Configure the SDK (replace with your actual credentials)
const config = new Configuration({
    clientId: "YOUR_CLIENT_ID",
    clientSecret: "YOUR_CLIENT_SECRET"
});

async function mergePdfFiles() {
    // Initialize the Merge API
    const mergeApi = new MergeApi(config);

// Define the PDF files to be merged (must exist in GroupDocs Cloud storage)
    const filesToMerge = [
        new FileInfo({ filePath: "input1.pdf" }),
        new FileInfo({ filePath: "input2.pdf" })
    ];

// Set merge options
    const mergeOptions = new MergeOptions();
    mergeOptions.fileInfos = filesToMerge;
    mergeOptions.outputPath = "merged_output.pdf";

try {
        // Perform the merge operation
        const result = await mergeApi.mergeDocuments(mergeOptions);
        console.log("Merge completed. Output file stored at:", result.path);
    } catch (error) {
        console.error("Error during PDF merge:", error);
    }
}

// Execute the merge
mergePdfFiles();

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 chắc chắn cập nhật mọi đường dẫn tệp và giá trị cấu hình để phù hợp với môi trường 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 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.

Gộp PDF qua REST API bằng cURL

Nếu bạn thích một cách tiếp cận REST thuần túy, cùng một thao tác có thể được thực hiện bằng các lệnh cURL.

Đầu tiên, lấy token truy cập:

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

Tải lên các PDF nguồn vào kho lưu trữ của bạn (thay thế YOUR_ACCESS_TOKEN bằng token từ bước trước):

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

Lặp lại việc tải lên cho input2.pdf. Sau đó yêu cầu 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 '{
           "fileInfos": [
               {"filePath":"input1.pdf"},
               {"filePath":"input2.pdf"}
           ],
           "outputPath":"merged_output.pdf"
         }'

Cuối cùng, tải xuống tệp đã hợp nhất:

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

Để có danh sách đầy đủ các điểm cuối và tham số, xem tài liệu tham khảo API.

Cấu hình các tùy chọn hợp nhất

SDK cung cấp một số tùy chọn cho phép bạn tinh chỉnh quá trình hợp nhất:

  • outputPath - Đường dẫn đích cho PDF đã hợp nhất. Điều chỉnh điều này để kiểm soát nơi kết quả được lưu trữ.
  • fileInfos - Một mảng các đối tượng FileInfo xác định các PDF nguồn và thứ tự của chúng.

Bạn cũng có thể đặt các thuộc tính bổ sung như pages để hợp nhất các phạm vi trang cụ thể, hoặc password cho các PDF được mã hóa. Tham khảo tài liệu chính thức để biết danh sách đầy đủ các trường có thể cấu hình.

Các cân nhắc về hiệu năng khi hợp nhất PDF

Khi hợp nhất nhiều tệp PDF lớn hoặc số lượng lớn, hãy nhớ những mẹo sau:

  • Sử dụng async/await để tránh chặn vòng lặp sự kiện, đặc biệt đối với các tài liệu lớn.
  • Tải lên hàng loạt: tải các PDF nguồn song song trước khi gọi hàm merge để giảm độ trễ tổng thể.
  • Xử lý dạng stream: đối với các PDF cực lớn, cân nhắc lưu trữ kết quả trung gian trong lưu trữ đám mây và hợp nhất chúng thành các phần nhỏ hơn.
  • PDF được mã hoá: cung cấp mật khẩu trong các đối tượng FileInfo; xử lý các tệp được mã hoá gây tốn tài nguyên, vì vậy hãy hợp nhất chúng sau khi giải mã nếu có thể.

Áp dụng các thực hành này giúp bạn hợp nhất PDF trong Node.JS một cách hiệu quả trong khi giảm thiểu việc tiêu thụ bộ nhớ.

Câu hỏi bạn có thể có

  • Làm thế nào để hợp nhất các tệp PDF trong Node.JS bằng GroupDocs?
    Sử dụng GroupDocs.Merger Cloud SDK for Node.js để tạo một thể hiện MergeApi, cấu hình MergeOptions với các PDF nguồn của bạn và gọi mergeDocuments. Ví dụ mã đầy đủ trong hướng dẫn này minh họa quy trình.

  • Tôi có thể hợp nhất các tệp PDF được mã hóa trong Node.JS không?
    Có, SDK hỗ trợ hợp nhất các PDF được mã hóa. Cung cấp mật khẩu đúng trong các đối tượng FileInfo trước khi gọi mergeDocuments. Xem tài liệu chính thức để biết chi tiết.

  • Các tùy chọn cấp phép cho GroupDocs.Merger là gì?
    GroupDocs cung cấp các gói giá linh hoạt. Để thử nghiệm, bạn có thể yêu cầu một giấy phép tạm thời để đánh giá thư viện trước khi mua gói đăng ký đầy đủ.

  • Tôi có thể tìm thêm ví dụ và hỗ trợ ở đâu?
    Các mẫu bổ sung có sẵn trên kho GitHub. Để được trợ giúp, hãy truy cập diễn đàn hỗ trợ.

Đọc thêm