Banyak pengembang perlu menggabungkan beberapa dokumen Word di Node.JS untuk menghasilkan laporan atau paket yang terintegrasi. GroupDocs.Merger Cloud SDK for Node.js menyediakan API yang kuat yang menangani penggabungan Word di sisi server tanpa kode penanganan file yang kompleks. Dalam panduan ini Anda akan melihat implementasi lengkap, panggilan cURL yang setara, langkah‑langkah instalasi, dan tip praktik terbaik untuk menggabungkan dokumen Anda dengan cepat.

Menggabungkan Beberapa Dokumen Word di Node.JS - Contoh Kode Lengkap

Contoh ini menunjukkan cara menggabungkan tiga DOCX file menjadi satu dokumen menggunakan GroupDocs.Merger Cloud SDK untuk 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);
    }
})();

Catatan: Contoh kode ini menunjukkan fungsi inti. Sebelum menggunakannya dalam proyek Anda, pastikan untuk memperbarui jalur file (input1.docx, combined_output.docx, dll.) agar sesuai dengan lokasi file 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 Dokumen Word melalui REST API Menggunakan cURL

Jika Anda lebih suka pendekatan REST murni, operasi penggabungan yang sama dapat dilakukan dengan perintah cURL. Di bawah ini adalah alur kerja singkat yang mengautentikasi, mengunggah file sumber, menjalankan penggabungan, dan mengunduh hasilnya.

1. Autentikasi dan Dapatkan Token Akses

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

Respons berisi access_token yang digunakan dalam panggilan berikutnya.

2. Unggah File Sumber

Ulangi langkah ini untuk setiap file DOCX yang ingin Anda gabungkan.

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. Jalankan 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 '{
    "documents": [
        {"fileInfo": {"filePath": "documents/input1.docx"}},
        {"fileInfo": {"filePath": "documents/input2.docx"}},
        {"fileInfo": {"filePath": "documents/input3.docx"}}
    ],
    "outputPath": "documents/combined_output.docx"
}'

API mengembalikan jalur file yang digabungkan.

4. Unduh Dokumen yang Digabungkan

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

Untuk detail lebih lanjut tentang payload permintaan dan opsi, lihat dokumentasi API resmi.

Cara Kerja Penggabungan Beberapa Dokumen Word di Node.JS

SDK mengabstraksikan proses penggabungan menjadi beberapa langkah logis:

  1. Pembuatan Konfigurasi - new GroupDocsMergerCloud.Configuration(clientId, clientSecret) membuat konteks otentikasi. Lihat referensi kelas di Referensi API.
const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);

  1. API Instance - new GroupDocsMergerCloud.MergeApi(config) menyediakan akses ke operasi penggabungan.

    const mergeApi = new GroupDocsMergerCloud.MergeApi(config);

  2. Document Entries - Setiap file sumber dibungkus dalam sebuah DocumentEntry yang berisi FileInfo dengan jalur file.

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

  3. Merge Request - MergeDocumentsRequest menggabungkan entri dan jalur output yang diinginkan.

const mergeRequest = new GroupDocsMergerCloud.Models.MergeDocumentsRequest({
    documents: documentEntries,
    outputPath: outputFile
});
  1. Execution - mergeApi.mergeDocuments(mergeRequest) mengirim permintaan ke layanan cloud. Promise menyelesaikan dengan objek hasil yang berisi jalur file output.
const result = await mergeApi.mergeDocuments(mergeRequest);
console.log(`Merge completed successfully. Output file: ${result.path}`);

Langkah-langkah ini bersama-sama memungkinkan Anda menggabungkan beberapa dokumen Word secara efisien tanpa menangani aliran file tingkat rendah.

Menyiapkan Lingkungan untuk GroupDocs.Merger

  1. Install the SDK
npm install groupdocs-merger-cloud

Paket tersedia dari halaman unduhan.

  1. Node.js Versi - Pastikan Anda menjalankan Node.js 12 atau yang lebih baru.

  2. Konfigurasi Kredensial - Ganti YOUR_CLIENT_ID dan YOUR_CLIENT_SECRET dalam kode dengan nilai dari akun GroupDocs Cloud Anda.

  3. Buat Folder Proyek - Letakkan file DOCX sumber di subfolder documents/ seperti yang ditunjukkan dalam contoh.

Dengan langkah-langkah ini selesai, Anda siap menjalankan skrip penggabungan atau memanggil endpoint REST.

Kesimpulan

Menggabungkan beberapa dokumen Word di Node.JS menjadi mudah dengan GroupDocs.Merger Cloud SDK for Node.js. SDK menangani pengunggahan file, logika penggabungan, dan pembuatan output, memungkinkan Anda fokus pada logika bisnis daripada manipulasi file tingkat rendah. Ingatlah untuk mengamankan lisensi yang tepat untuk penggunaan produksi; Anda dapat memulai dengan lisensi sementara dan meningkatkan ke langganan penuh seiring kebutuhan Anda berkembang. Mulailah menggabungkan hari ini dan sederhanakan alur kerja dokumen Anda.

FAQs

  • Bagaimana cara menggabungkan beberapa dokumen Word di Node.JS menggunakan SDK?
    Gunakan kelas MergeApi untuk membuat MergeDocumentsRequest yang mencantumkan setiap file DOCX sebagai DocumentEntry. SDK menggabungkannya dalam urutan yang diberikan dan menyimpan hasilnya ke jalur output yang ditentukan.

  • Apakah memungkinkan menggabungkan PDF bersama dengan SDK yang sama?
    Ya, Merger SDK mendukung PDF, DOCX, ODT, dan beberapa format lainnya. Cukup ubah ekstensi file dalam array inputFiles dan SDK akan menangani konversi secara otomatis. Lihat dokumentasi resmi untuk detail format.

  • What are the limits on the number of documents I can merge in a single request?
    Layanan cloud memberlakukan batas ukuran daripada batas jumlah yang ketat. Selama ukuran gabungan tetap berada dalam kuota akun Anda, Anda dapat menggabungkan puluhan file. Untuk batch yang sangat besar, pertimbangkan untuk mengunggah file ke penyimpanan GroupDocs terlebih dahulu dan merujuknya dengan ID.

  • Apakah saya perlu khawatir tentang lisensi untuk pengembangan versus produksi?
    Pengembangan dan pengujian dapat menggunakan lisensi sementara yang diperoleh dari halaman lisensi sementara. Untuk penyebaran produksi, beli lisensi penuh untuk membuka kunci penggabungan tak terbatas dan dukungan prioritas.

Baca Selengkapnya