💡 Contoh kerja penuh tersedia di GitHub: one-line-document-merge-and-split-dotnet

Di Mana Pekerjaan Dokumen Back-Office Sebenarnya Berada

Sebuah back office keuangan menutup bulan dengan menjahit halaman sampul ke PDF pernyataan bulan sebelumnya. Tim kontrak menambahkan amandemen yang ditandatangani ke perjanjian asli sebelum disimpan ke arsip. Asisten sales‑ops menarik dua slide dari dek enam puluh slide karena satu pemangku kepentingan hanya pernah membutuhkan halaman harga. Seorang petugas arsip menghapus halaman yang seharusnya tidak pernah dikirim, tepat sebelum berkas meninggalkan gedung.

Tidak ada satupun dari ini yang merupakan proyek penggabungan. Masing‑masing adalah satu berkas dan satu operasi, dilakukan dengan cara yang sama setiap kali pekerjaan dijalankan, biasanya oleh seseorang yang tidak tertarik mempelajari API dokumen umum hanya untuk mencapai tujuan tersebut.

GroupDocs.Merger.LowCode adalah paket .NET yang mengubah satu pekerjaan semacam itu—penggabungan, pemisahan, atau penghapusan halaman—menjadi satu pemanggilan konstruktor, terpisah dari kelas umum Merger yang tidak pernah dibutuhkan oleh pekerjaan tersebut. Setiap dari tujuh produknya mengambil sumber dan opsi di konstruktor, dalam C#, dan dijalankan hanya sekali Save dipanggil, dengan bentuk yang sama apakah pekerjaan itu PDF, dokumen Word, atau dek PowerPoint.

Mengapa Perbaikan Umum Tidak Cukup Di Sini

Tim yang menghadapi salah satu pekerjaan ini biasanya mencoba salah satu dari tiga hal sebelum beralih ke paket yang terfokus:

  • Melakukannya secara manual di editor desktop: cocok untuk satu dokumen, tidak dapat dijadwalkan, dan tidak ada yang menyetujui langkah manual yang dijalankan pada pukul 2 pagi.
  • Menulis skrip satu‑off melawan API berkas mentah: berfungsi sampai format masukan berikutnya muncul, dan skrip tersebut berkembang menjadi klien umum yang sebenarnya ingin dihindari.
  • Menggunakan kelas Merger lengkap untuk satu pemanggilan: benar, tetapi menambah permukaan API yang lebih luas daripada yang diperlukan satu operasi.

GroupDocs.Merger.LowCode ada untuk menutup kesenjangan terakhir itu: satu pemanggilan per operasi, tidak ada hal lain yang harus dipelajari terlebih dahulu.


Solusi: GroupDocs.Merger.LowCode untuk Pipeline Back-Office

GroupDocs.Merger.LowCode mengemas tujuh produk satu‑tujuan di balik bentuk konstruktor‑lalu‑Save itu. JoinPdf dan JoinDocx menambahkan satu dokumen ke dokumen lain; JoinPptx melakukan hal yang sama untuk dek; SplitPdf, SplitDocx, dan SplitPptx menarik halaman atau slide yang dipilih ke berkas masing‑masing; RemovePagesPdf menghapus halaman tanpa menyentuh sumber. Setiap dari tujuh produk menerima sumbernya sebagai jalur atau aliran dan memeriksa sumber tersebut, serta setiap berkas yang diberikan, terhadap formatnya sendiri sebelum menulis apa pun, sehingga pipeline tidak pernah harus menebak mengapa keluaran menjadi salah.

Untuk mengikuti implementasi di bawah, Anda memerlukan:

  • .NET 6.0 atau lebih baru (proyek contoh ini menargetkan net8.0)
  • Paket NuGet GroupDocs.Merger.LowCode terpisah
  • Lisensi sementaratemporary license, jika Anda ingin melihat keluaran tanpa batasan evaluasi yang dijelaskan lebih jauh
dotnet add package GroupDocs.Merger.LowCode

Paket ini berada terpisah di NuGet dari pustaka utama GroupDocs.Merger.


Menerapkan Langkah Pekerjaan Reporting‑Pack Secara Bertahap

Berikut adalah bentuk yang diikuti oleh setiap produk, dijelaskan dengan contoh penggabungan yang menambahkan halaman sampul ke PDF bulanan.

Langkah 1: Arahkan Produk ke Sumbernya

Konstruktor JoinPdf mengambil dokumen sumber, setiap berkas yang akan ditambahkan, dan sebuah instance JoinOptions; belum ada yang dijalankan.

var join = new JoinPdf("report.pdf", new[] { "appendix.pdf" }, new JoinOptions());

Langkah 2: Tentukan Di Mana Hasilnya Disimpan

Save(outputPath) adalah tempat pekerjaan sebenarnya melakukan komit. Jalur relatif dipecahkan terhadap direktori kerja proses saat ini, dan Save membuat folder keluaran jika belum ada, sehingga pipeline yang menulis ke folder bulan baru setiap kali tidak memerlukan langkah terpisah untuk menyiapkannya.

string outputPath = "output/monthly/report-with-appendix.pdf";

Mengapa ini penting untuk pekerjaan tanpa pengawasan:

  • Jalur yang Anda kontrol: bangun jalur keluaran dari konfigurasi atau parameter pekerjaan, jangan langsung dari masukan yang belum divalidasi; Save melempar ArgumentNullException bila jalur null atau kosong.
  • Folder yang dibuatnya: pekerjaan terjadwal yang menulis ke tujuan baru setiap kali tidak memerlukan langkah terpisah “pastikan direktori ada”.

Langkah 3: Jalankan dan Tangkap Apa yang Kembali

Memanggil Save menjalankan penggabungan secara langsung; tidak ada langkah build‑lalu‑execute terpisah.

join.Save(outputPath);
var sizeInBytes = new FileInfo(outputPath).Length;

Dalam percobaan kami dengan berkas contoh, pemanggilan itu menggabungkan PDF report.pdf ber‑2 halaman dengan appendix.pdf ber‑2 halaman menjadi report-with-appendix.pdf ber‑4 halaman, berukuran 257 987 byte.

Langkah 4: Masukkan Hasil Kembali ke Pipeline

Ukuran berkas yang dibaca tepat setelah Save biasanya sudah cukup bagi penjadwal sebelum menandai pekerjaan selesai, atau sebelum membandingkannya dengan ukuran minimum untuk memutuskan apakah keluaran cukup dapat dipercaya untuk dilanjutkan.

if (sizeInBytes == 0)
{
    throw new InvalidOperationException("Join produced an empty file.");
}

Apakah GroupDocs.Merger.LowCode Menerima Aliran (Stream) Alih‑Alih Jalur Berkas?

Ya, pada sisi masukan. Setiap produk menerima sumbernya sebagai aliran di posisi konstruktor yang sama dengan jalur berkas, berguna ketika masukan pekerjaan berasal dari penyimpanan blob atau antrian alih‑alih disk lokal. Save tetap menulis hasilnya ke jalur output string dalam kedua kasus; streaming output sendiri tetap berada di kelas Merger lengkap.


Alur Kerja Nyata: Menolak Berkas Sebelum Masuk ke Arsip

Tim kontrak yang menambahkan amandemen ke perjanjian yang sudah ditandatangani tidak dapat mengambil risiko menerima berkas apa pun yang masuk ke kotak masuk; amandemen .docx yang terselip di samping penggabungan PDF akan menghasilkan entri arsip yang rusak. JoinPdf memeriksa sumber dan setiap berkas yang ditambahkan terhadap format PDF sebelum menulis apa pun, dan mengangkat FileTypeNotSupportedException begitu ada yang tidak cocok.

try
{
    new JoinPdf("report.pdf", new[] { "contract.docx" }, new JoinOptions())
        .Save("output/mixed.pdf");
}
catch (FileTypeNotSupportedException exception)
{
    Console.WriteLine(exception.Message);
}

Dalam percobaan contoh, di mana jalur dibangun dari folder resources, pesan yang muncul adalah: Input format does not match the expected format 'PDF'; the joined file 'resources\contract.docx' is 'Microsoft Word Open XML Document (.docx)'.

Pekerjaan di atas tidak pernah menulis output/mixed.pdf ketika pengecualian ditangkap, sehingga pipeline kontrak dapat mengarahkan pesan itu langsung ke sistem peringatan atau antrean tiket yang sudah mereka gunakan, alih‑alih menemukan entri arsip yang buruk beberapa hari kemudian.


Skenario Back‑Office Lain yang Cocok dengan Pola Ini

Setelah penggabungan di atas berfungsi, bentuk konstruktor‑lalu‑Save yang sama mencakup beberapa pekerjaan yang dijalankan back office secara terjadwal:

  • Memangkas halaman sebelum dokumen meninggalkan gedung: RemovePagesPdf menghapus halaman yang dipilih dan menulis berkas baru tanpa menyentuh sumber, sehingga berkas asli tetap tersedia untuk audit setelah salinan yang dipangkas dikirim. Dalam percobaan kami, menghapus halaman 2 dari report.pdf menghasilkan report-without-page-2.pdf ber‑1 halaman, berukuran 86 647 byte, sementara report.pdf tetap tidak berubah.
  • Membagi dek untuk satu pemangku kepentingan: SplitPptx menarik slide yang diminta ke berkas masing‑masing, dinamai dengan token {0} dalam pola output atau, bila tidak ada, dengan nomor urut tambahan di folder yang sama, pola yang sama digunakan SplitPdf untuk memisahkan halaman PDF.
  • Menggabungkan dokumen Word alih‑alih PDF: JoinDocx mengikuti bentuk konstruktor‑lalu‑Save yang persis seperti JoinPdf, menempatkan dokumen yang ditambahkan setelah halaman terakhir sumber.

Tanpa lisensi, setiap pekerjaan ini berjalan dalam mode evaluasi. Dalam percobaan tanpa lisensi kami, PDF dan Word yang digabung dipotong menjadi 3 halaman masing‑masing, meskipun semua enam keluaran contoh tetap dihasilkan; terapkan lisensi dengan License.Set sebelum menjalankan pekerjaan ini secara tidak diawasi di produksi.


Memulai di Pipeline Back‑Office Anda

Anda kini memiliki satu pola penggabungan dokumen low‑code yang berfungsi dari ujung ke ujung, plus bukti bahwa pemeriksaan format di belakangnya dijalankan pada setiap pemanggilan. Berikut langkah selanjutnya:

  • Lihat gambaran lengkap: panduan use‑case guide pendamping menjelaskan masing‑masing dari enam operasi contoh langkah demi langkah, lengkap dengan FAQ.
  • Mendalami ketika pekerjaan berkembang: full GroupDocs.Merger API mencakup lebih banyak hal daripada pola ini butuhkan begitu pipeline melampaui satu operasi.
  • Jelajahi kode: complete sample on GitHub mencakup semua berkas masukan yang digunakan di atas.
  • Instalasi: installation page menjelaskan paket terpisah dan kerangka kerja target yang didukung.
  • Hilangkan batasan evaluasi: dapatkan temporary license sebelum menjalankan apa pun ini di produksi.
  • Pertanyaan: support forum adalah tempat tim menjawab pertanyaan implementasi.

Sumber Daya