Menggabungkan beberapa dokumen PDF menjadi satu file adalah kebutuhan yang sering muncul saat membangun alur kerja dokumen atau menghasilkan laporan. GroupDocs.Merger Cloud SDK for Node.js memudahkan penggabungan PDF di Node.JS tanpa harus menangani struktur PDF tingkat rendah. Panduan ini memandu Anda melalui pengaturan, implementasi langkah demi langkah, contoh kode lengkap, panggilan cURL yang setara, serta tips kinerja untuk PDF yang besar atau terenkripsi.

Sebelum Anda Memulai: Prasyarat dan Instalasi

Sebelum Anda memulai, pastikan Anda memiliki hal berikut:

  • Node.js 14 atau lebih baru terpasang di mesin pengembangan Anda.
  • Akun GroupDocs Cloud aktif dengan client ID dan client secret.
  • Akses ke file PDF yang ingin Anda gabungkan, disimpan di penyimpanan GroupDocs Cloud.

Instal SDK melalui npm dan unduh paket terbaru:

npm install groupdocs-merger-cloud

Anda juga dapat mengambil SDK dari halaman rilis resmi: Download SDK. Setelah instalasi, Anda siap untuk mulai menulis kode.

Panduan Langkah-demi-Langkah untuk Menggabungkan PDF di Node.JS

Langkah 1: Instal SDK dan Impor Kelas yang Diperlukan

Pertama, impor kelas yang Anda perlukan untuk menggabungkan PDF.

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

Impor ini memberi Anda akses ke API inti, objek konfigurasi, dan deskriptor file.

Langkah 2: Konfigurasikan Kredensial GroupDocs Anda

Buat objek konfigurasi dengan kredensial klien Anda.

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

Memberikan kredensial yang benar memungkinkan perpustakaan mengautentikasi permintaan Anda.

Langkah 3: Tentukan File PDF yang Akan Digabung

Daftar dokumen PDF yang ingin Anda gabungkan. Langkah ini mempersiapkan Anda untuk menggabungkan PDF di Node.JS secara efisien.

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

Setiap FileInfo menunjuk ke file yang disimpan di penyimpanan GroupDocs Cloud Anda.

Langkah 4: Atur Opsi Penggabungan

Konfigurasikan lokasi output dan lampirkan daftar file ke permintaan merge.

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

Pengaturan ini mengontrol cara Anda menggabungkan PDF di Node.JS dan di mana hasilnya akan disimpan.

Langkah 5: Jalankan Operasi Penggabungan

Buat instance API, panggil metode merge, dan tangani respons.

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);
}

Panggilan async mengembalikan jalur dokumen yang digabungkan jika operasi berhasil.

Contoh Implementasi Lengkap untuk Menggabungkan PDF di Node.JS

Kode berikut menunjukkan alur kerja lengkap dari konfigurasi hingga penanganan hasil.

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();

Catatan: Contoh kode ini menunjukkan fungsi inti. Sebelum menggunakannya dalam proyek Anda, pastikan untuk memperbarui semua jalur file dan nilai konfigurasi agar sesuai dengan lingkungan Anda yang sebenarnya, verifikasi bahwa semua dependensi yang diperlukan telah terpasang dengan benar, dan uji secara menyeluruh di lingkungan pengembangan Anda. Jika Anda menemukan masalah, silakan merujuk ke dokumentasi resmi atau hubungi tim dukungan untuk bantuan.

Menggabungkan PDF melalui REST API menggunakan cURL

Jika Anda lebih suka pendekatan REST murni, operasi yang sama dapat dilakukan dengan perintah cURL.

Pertama, dapatkan token akses:

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

Unggah PDF sumber ke penyimpanan Anda (ganti YOUR_ACCESS_TOKEN dengan token dari langkah sebelumnya):

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"

Ulangi unggahan untuk input2.pdf. Kemudian minta operasi penggabungan:

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

Akhirnya, unduh file yang digabungkan:

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

Untuk daftar lengkap endpoint dan parameter, lihat referensi API.

Mengonfigurasi Opsi Penggabungan

SDK menyediakan beberapa opsi yang memungkinkan Anda menyesuaikan proses penggabungan secara detail:

  • outputPath - Jalur tujuan untuk PDF yang digabungkan. Sesuaikan ini untuk mengontrol di mana hasil disimpan.
  • fileInfos - Array objek FileInfo yang menentukan PDF sumber dan urutannya.

Anda juga dapat mengatur properti tambahan seperti pages untuk menggabungkan rentang halaman tertentu, atau password untuk PDF yang dienkripsi. Lihat dokumentasi resmi untuk daftar lengkap bidang yang dapat dikonfigurasi.

Pertimbangan Kinerja untuk Menggabungkan PDF

Saat menggabungkan file PDF yang besar atau banyak, perhatikan tips berikut:

  • Gunakan async/await untuk menghindari pemblokiran event loop, terutama untuk dokumen besar.
  • Unggahan batch: unggah PDF sumber secara paralel sebelum memanggil penggabungan untuk mengurangi latensi keseluruhan.
  • Pemrosesan streaming: untuk PDF yang sangat besar, pertimbangkan menyimpan hasil menengah di penyimpanan cloud dan menggabungkannya dalam potongan yang lebih kecil.
  • PDF terenkripsi: berikan kata sandi dalam objek FileInfo; memproses file terenkripsi menambah beban, jadi gabungkan setelah dekripsi bila memungkinkan.

Menerapkan praktik ini membantu Anda menggabungkan PDF di Node.JS secara efisien sambil meminimalkan konsumsi memori.

Pertanyaan yang Mungkin Anda Miliki

  • Bagaimana cara menggabungkan file PDF di Node.JS menggunakan GroupDocs?
    Gunakan GroupDocs.Merger Cloud SDK for Node.js untuk membuat instance MergeApi, konfigurasikan MergeOptions dengan PDF sumber Anda, dan panggil mergeDocuments. Contoh kode lengkap dalam panduan ini menunjukkan prosesnya.

  • Bisakah saya menggabungkan file PDF terenkripsi di Node.JS?
    Ya, SDK mendukung penggabungan PDF terenkripsi. Berikan kata sandi yang benar pada objek FileInfo sebelum memanggil mergeDocuments. Lihat dokumentasi resmi untuk detail.

  • Apa saja opsi lisensi untuk GroupDocs.Merger?
    GroupDocs menawarkan paket harga yang fleksibel. Untuk pengujian, Anda dapat meminta lisensi sementara untuk mengevaluasi perpustakaan sebelum membeli langganan penuh.

  • Di mana saya dapat menemukan contoh lebih lanjut dan dukungan?
    Contoh tambahan tersedia di repositori GitHub. Untuk bantuan, kunjungi forum dukungan.

Bacaan Lebih Lanjut