Fitur Page Builder mengubah penggabungan dokumen dengan memungkinkan pengguna untuk dengan mulus menggabungkan halaman dari dokumen yang berbeda dengan presisi dan kemudahan. Ini memungkinkan penggabungan halaman dalam urutan apa pun, memberikan kontrol penuh atas struktur dokumen akhir. Apakah menggabungkan beberapa halaman kunci atau membuat dokumen yang komprehensif, alat ini memastikan fleksibilitas dan efisiensi. Dengan mengurangi upaya manual, ini menyederhanakan proses pembuatan dokumen yang disesuaikan, menghemat waktu berharga dan meningkatkan produktivitas secara keseluruhan dalam alur kerja pribadi dan profesional.

Page Builder - cara menggabungkan halaman dari dokumen

Topik-topik berikut dibahas di sini:

Jika Anda tertarik dengan Merging documents online, kunjungi Online Merging Tool yang didukung oleh GroupDocs.

Memahami Page Builder

Fitur Page Builder memperkenalkan cara yang lebih sederhana untuk membuat dokumen kustom dengan menggabungkan halaman dari beberapa dokumen sumber. Fitur ini memungkinkan pengembang untuk membangun dokumen baru secara bertahap, menambahkan halaman dalam urutan apa pun dari dua dokumen atau lebih. Inilah cara proses ini bekerja:

  • Mulailah dengan memuat dokumen Word sumber menggunakan kelas Merger dan mengoper salah satu dokumen sumber ke konstruktor.
  • Gabungkan dokumen satu per satu untuk menggabungkannya menggunakan metode Join.
  • Initialize the Page Builder. Over the method CreatePageBuilder from the Merger instance Ini berfungsi sebagai titik awal untuk membangun dokumen baru Anda.
  • Metode AddPage dari instance Page Builder memungkinkan untuk menambahkan ke dalam dokumen tujuan halaman tertentu dari dokumen yang digabungkan sebelumnya.
  • untuk setiap dokumen sumber, pilih halaman spesifik yang ingin Anda sertakan dalam indeks;
  • tambahkan halaman-halaman ini ke dokumen baru dalam urutan yang diinginkan. Anda dapat menggabungkan dan mencocokkan halaman dari dokumen yang berbeda untuk memenuhi kebutuhan Anda;
  • ulang proses ini untuk dokumen sumber tambahan, memastikan bahwa Anda memiliki fleksibilitas untuk menggabungkan halaman dengan cara yang paling sesuai dengan kebutuhan Anda;
  • Menggunakan ApplyPageBuilder metode untuk menerapkan perubahan dari instance Page Builder
  • Simpan dokumen yang digabungkan ke tujuan mana pun. Setelah semua halaman yang diperlukan telah ditambahkan, simpan dokumen baru. Output akhir akan menjadi file yang sepenuhnya disesuaikan yang berisi halaman dari berbagai sumber, diorganisir persis seperti yang Anda inginkan.

Pendekatan langkah-demi-langkah ini memudahkan untuk membuat dokumen yang disesuaikan dengan kasus penggunaan tertentu, seperti menyusun laporan, membuat presentasi yang dipersonalisasi, atau mengumpulkan dokumen hukum. Dengan Page Builder, pengembang memiliki kontrol penuh atas urutan halaman dan konten, menghilangkan kebutuhan untuk pengeditan manual yang memakan waktu dan memastikan ketepatan dalam output akhir.

Sample case and code implementation

Mari kita tunjukkan cara menggunakan fitur Page Builder di GroupDocs.Merger dengan contoh praktis. Untuk menyederhanakan kasus, anggaplah kita memiliki dua dokumen:

  • Document A dengan 4 halaman.
  • Document B dengan 4 halaman.

Kami bertujuan untuk membuat dokumen baru dengan menggabungkan halaman dari kedua dokumen ini dalam urutan yang berbeda berdasarkan skenario tertentu.

Page Builder - Struktur dokumen Contoh A dan B dengan 4 halaman masing-masing

Di sini kami menandai setiap halaman dokumen dengan huruf dokumen A, B dan nomor halaman. Dari dokumen A dan B kami perlu menerima dokumen yang disesuaikan C dengan struktur berikut

Page Builder - Struktur dokumen Contoh A dan B dengan 4 halaman masing-masing

Cuplikan kode sumber berikut menunjukkan cara menggabungkan halaman-halaman tertentu dari beberapa dokumen ke dalam dokumen hasil.

string documentA = @"documentA.pdf";
string documentB = @"documentB.pdf";
string documentC = @"documentC.pdf";

using (Merger merger = new Merger(documentA))
{
    merger.Join(documentB);

    PageBuilder pageBuilder = merger.CreatePageBuilder();
    // get documents A and B references
    var docA = pageBuilder.Documents[0];
    var docB = pageBuilder.Documents[1];
    
    pageBuilder.AddPage(docA.Pages[0]); // document A, page 1 or Page A-1
    pageBuilder.AddPage(docB.Pages[0]); // document B, page 1 or Page B-1
    pageBuilder.AddPage(docB.Pages[1]); // document B, page 2 or Page B-2
    pageBuilder.AddPage(docB.Pages[2]); // document B, page 3 or Page B-3
    pageBuilder.AddPage(docA.Pages[1]); // document A, page 2 or Page A-2
    pageBuilder.AddPage(docA.Pages[3]); // document A, page 4 or Page A-4
    
    // Apply the page order
    merger.ApplyPageBuilder(pageBuilder);

    merger.Save(documentC);
}

Menentukan rentang halaman yang diperlukan

Ketika bekerja dengan manipulasi dokumen, menambahkan beberapa halaman secara efisien adalah kunci untuk menangani alur kerja yang kompleks. Alih-alih menambahkan halaman secara individu, Anda dapat menggunakan metode AddPageRange, yang menerima array dari IPageInfo objek, masing-masing mewakili halaman tertentu. Pendekatan ini menyederhanakan proses, mengurangi kode yang berulang, dan meningkatkan kinerja dengan memungkinkan operasi batch. Di bawah ini adalah contoh kode yang menunjukkan bagaimana menggunakan metode ini untuk menambahkan beberapa halaman dari dokumen yang berbeda dalam satu operasi yang terintegrasi.

Berikut adalah langkah-langkah untuk menggabungkan beberapa halaman dari berbagai dokumen dengan menentukan mereka sebagai rentang:

  • Buat objek Merger dan berikan jalur atau aliran dari file sumber.
  • Gunakan Join untuk menambahkan dokumen sumber lainnya. Ulangi langkah ini untuk setiap dokumen yang ingin Anda gabungkan.
  • Buat objek PageBuilder dengan memanggil metode CreatePageBuilder.
  • Call the AddPageRange method and pass an array of IPageInfo objects describing the appropriate pages. Please note that IPageInfo objects use zero-based notation for source documents and page numbers.
  • Gunakan metode ApplyPageBuilder untuk menerapkan urutan halaman yang ditentukan ke dokumen yang digabungkan.
  • Save the resulting document by calling the Save method and providing a file path.
string documentA = @"documentA.pdf";
string documentB = @"documentB.pdf";
string documentC = @"documentC.pdf";

using (Merger merger = new Merger(documentA))
{
    merger.Join(documentB);

    PageBuilder pageBuilder = merger.CreatePageBuilder();
     // get documents A and B references
    var docA = pageBuilder.Documents[0];
    var docB = pageBuilder.Documents[1];
    // Specify a range of pages
    IPageInfo[] range = new IPageInfo[] {
        docA.Pages[0], // Page A-1 from the document A
        docB.Pages[0], // Page B-1 from the document B
        docB.Pages[1], // Page B-2 from the document B
        docB.Pages[2], // Page B-3 from the document B
        docA.Pages[1], // Page A-2 from the document A
        docA.Pages[3], // Page A-4 from the document A                    
    };
    // Append a page of pages
    pageBuilder.AddPageRange(range);

    // Apply the page order
    merger.ApplyPageBuilder(pageBuilder);

    merger.Save(documentC);
}

Kesimpulan

Contoh-contoh ini menggambarkan fleksibilitas dari fitur Page Builder. Pengembang dapat dengan mudah menggabungkan halaman dari beberapa dokumen dalam berbagai urutan untuk membuat output yang disesuaikan. Fitur ini secara signifikan mengurangi pekerjaan manual dan memastikan ketelitian dalam pembuatan dokumen, menjadikannya alat yang penting untuk berbagai kasus penggunaan.

Dapatkan Lisensi API Gratis

You can get a free temporary license to use the API without the evaluation limitations.

Bangun Aplikasi Pembuat Halaman Gabungan Anda Sendiri

Berikut adalah beberapa tautan penting yang akan membantu Anda dalam membangun aplikasi perbandingan dokumen Anda sendiri.

Documentation | API Reference | Supported File Formats

Running Examples – GitHub | Free Support Forum | Release Notes

Lihat Juga

Untuk informasi lebih lanjut dan sumber tambahan, Anda mungkin menemukan tautan berikut berguna: