Contoh Kerja Penuh untuk Menggabungkan Beberapa Dokumen Word di Java

Contoh ini menunjukkan cara menggabungkan beberapa dokumen Word di Java menggunakan API Merger.

import com.groupdocs.merger.cloud.client.ApiClient;
import com.groupdocs.merger.cloud.client.ApiException;
import com.groupdocs.merger.cloud.api.MergerApi;
import com.groupdocs.merger.cloud.model.FileInfo;
import com.groupdocs.merger.cloud.model.MergeOptions;
import java.util.ArrayList;
import java.util.List;

public class CombineWordDocuments {
    public static void main(String[] args) {
        // Initialize the API client with your credentials
        ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
        MergerApi mergerApi = new MergerApi(apiClient);

try {
            // List of Word documents to combine
            List<FileInfo> sourceFiles = new ArrayList<>();
            sourceFiles.add(new FileInfo().setFilePath("input1.docx"));
            sourceFiles.add(new FileInfo().setFilePath("input2.docx"));
            sourceFiles.add(new FileInfo().setFilePath("input3.docx"));

// Configure merge options
            MergeOptions mergeOptions = new MergeOptions();
            mergeOptions.setOutputPath("merged_output.docx");
            mergeOptions.setFileInfos(sourceFiles);

// Execute the merge operation
            FileInfo result = mergerApi.merge(mergeOptions);

System.out.println("Merge completed successfully. Output file: " + result.getFilePath());
        } catch (ApiException e) {
            System.err.println("An error occurred while merging documents: " + e.getMessage());
        }
    }
}

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 lakukan pengujian secara menyeluruh di lingkungan pengembangan Anda. Jika Anda mengalami masalah, silakan merujuk ke dokumentasi resmi atau hubungi tim dukungan untuk bantuan.

Menggabungkan File Word melalui REST API Menggunakan cURL

Jika Anda lebih memilih pendekatan REST murni, operasi penggabungan yang sama dapat dilakukan dengan panggilan cURL. Langkah-langkah di bawah ini menunjukkan cara memperoleh token akses, mengunggah file sumber, meminta penggabungan, dan mengunduh hasilnya.

Autentikasi dan dapatkan token akses:

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

Unggah setiap file DOCX ke penyimpanan cloud Anda (ganti YOUR_ACCESS_TOKEN dengan token dari langkah sebelumnya):

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input1.docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document" \
     --data-binary @input1.docx

Ulangi perintah upload untuk input2.docx dan input3.docx.

Buat permintaan penggabungan:

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/merge" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "outputPath":"merged_output.docx",
           "fileInfos":[
               {"filePath":"input1.docx"},
               {"filePath":"input2.docx"},
               {"filePath":"input3.docx"}
           ]
         }'

Unduh dokumen yang digabungkan:

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/merged_output.docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o merged_output.docx

Untuk detail lebih lanjut tentang parameter permintaan, lihat dokumentasi API resmi.

Memahami Proses Menggabungkan Dokumen Word di Java

Berikut adalah penjelasan langkah demi langkah dari kode yang ditampilkan sebelumnya.

1. Buat ApiClient - new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") membuat koneksi ke layanan cloud GroupDocs.

   ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
   

2. Instansiasi MergerApi - new MergerApi(apiClient) memberikan akses ke endpoint terkait penggabungan.

   MergerApi mergerApi = new MergerApi(apiClient);
   

3. Siapkan daftar file sumber - Setiap objek FileInfo menunjuk ke file DOCX yang disimpan di cloud. Daftar tersebut diteruskan ke MergeOptions.

   List<FileInfo> sourceFiles = new ArrayList<>();
   sourceFiles.add(new FileInfo().setFilePath("input1.docx"));
   

4. Konfigurasikan MergeOptions - Atur jalur output yang diinginkan dan lampirkan daftar file sumber.

   MergeOptions mergeOptions = new MergeOptions();
   mergeOptions.setOutputPath("merged_output.docx");
   mergeOptions.setFileInfos(sourceFiles);
   

5. Jalankan penggabungan - mergerApi.merge(mergeOptions) mengirim permintaan dan mengembalikan FileInfo untuk dokumen yang telah digabungkan.

   FileInfo result = mergerApi.merge(mergeOptions);
   

Untuk daftar lengkap properti yang tersedia, lihat referensi API.

Prasyarat dan Penyiapan untuk GroupDocs.Merger Cloud SDK

Sebelum Anda dapat menjalankan kode, tambahkan dependensi Maven ke proyek Anda dan pastikan Anda memiliki akun GroupDocs yang valid.

Tambahkan SDK ke pom.xml Anda:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-merger-cloud</artifactId>
    <version>25.11</version>
</dependency>

Unduh JAR terbaru dan sumbernya dari halaman unduhan.
Anda juga memerlukan Java 8 atau yang lebih tinggi serta akses internet untuk panggilan cloud.
Buat akun GroupDocs, dapatkan Client ID dan Client Secret Anda, dan simpan dengan aman.

Kesimpulan

Menggabungkan file DOCX secara programatik kini menjadi mudah dengan GroupDocs.Merger Cloud SDK for Java. Kode contoh dan cuplikan cURL menunjukkan dua cara fleksibel untuk menggabungkan beberapa dokumen Word di Java, baik Anda lebih suka pustaka native maupun panggilan REST langsung. Pastikan untuk mengonfigurasi kredensial Anda, menangani file besar dengan streaming jika diperlukan, dan menguji operasi penggabungan dengan dokumen yang representatif. Untuk penerapan produksi, Anda memerlukan lisensi berbayar; detail harga tersedia di halaman produk dan Anda dapat meminta lisensi sementara untuk evaluasi dari halaman lisensi sementara.

FAQ

• Bagaimana cara menggabungkan beberapa dokumen Word di Java tanpa menulis kode penanganan file khusus?
  Gunakan GroupDocs.Merger Cloud SDK for Java. SDK ini mengabstraksi semua operasi tingkat rendah dan memungkinkan Anda menggabungkan file DOCX dengan beberapa panggilan API.

• Apakah memungkinkan untuk menggabungkan dokumen yang disimpan di folder cloud yang berbeda?
  Ya. Berikan jalur file cloud lengkap dalam objek FileInfo, dan operasi penggabungan akan mengambil setiap file dari lokasinya sebelum menggabungkannya.

• Apa yang harus saya lakukan jika penggabungan gagal dengan ApiException?
  Periksa pesan pengecualian untuk detail seperti file yang hilang atau masalah izin. Pastikan jalur file sudah benar dan akun Anda memiliki akses baca/tulis ke penyimpanan. Konsultasikan dokumentasi resmi untuk kode kesalahan.

• Apakah saya memerlukan lisensi terpisah untuk setiap lingkungan (pengembangan, staging, produksi)?
  Satu lisensi mencakup semua lingkungan, tetapi Anda harus menghormati batas penggunaan yang ditentukan dalam perjanjian lisensi Anda. Untuk pengujian, Anda dapat menggunakan lisensi sementara yang ditautkan di atas.

Baca Selengkapnya

• Lindungi ZIP dengan Kata Sandi menggunakan Perangkat Lunak Perlindungan Kata Sandi
• Lindungi Excel dengan Kata Sandi menggunakan Layanan Perlindungan Kata Sandi
• Gabungkan Dokumen Word dalam C#

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

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

   const mergeApi = new GroupDocsMergerCloud.MergeApi(config);
   

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

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

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

5. 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.

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

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

4. 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

• Melindungi File ZIP dengan Kata Sandi menggunakan Perangkat Lunak Perlindungan Kata Sandi
• Melindungi Excel dengan Kata Sandi menggunakan Layanan Perlindungan Kata Sandi
• Menggabungkan Dokumen Word dalam C#