💡 Tam çalışan örnek GitHub’da mevcuttur: one-line-document-merge-and-split-dotnet
Back-Office Belge İşlerinin Gerçek Konumu
Finans back office, geçen ayın bildirim PDF’sine bir kapak sayfası zımbalayarak ayı kapatır. Sözleşme ekibi, arşive gitmeden önce imzalı bir ek belgeyi orijinal sözleşmeye ekler. Satış operasyonları asistanı, bir paydaşın sadece fiyatlandırma sayfasına ihtiyacı olduğu için altmış slayttan oluşan bir sunumdan iki slaytı çıkarır. Kayıt görevlisi, dosya binayı terk etmeden hemen önce gönderilmemesi gereken bir sayfayı çıkarır.
Bunların hiçbiri bir birleştirme projesi değildir. Her biri tek bir dosya ve tek bir işlemdir, iş her çalıştığında aynı şekilde yapılır, genellikle bunu başarmak için genel amaçlı bir belge API’si öğrenmeye ilgisi olmayan biri tarafından yapılır.
GroupDocs.Merger.LowCode, bir .NET paketi olup bu tür bir işi—bir birleştirme, bir bölme ya da bir sayfa kaldırma—tek bir yapıcı çağrısına dönüştürür ve bu işler için asla ihtiyaç duyulmayan genel amaçlı Merger sınıfından ayrılır. Yedi ürününün her biri, kaynağını ve seçeneklerini yapıcıda, C# içinde alır ve Save çağrıldığında yalnızca bir kez çalışır; iş PDF, Word belgesi ya da PowerPoint sunumu olsun aynı şekildedir.
Neden Genel Çözümler Burada İşe Yaramaz
Bu işlerden birini yöneten ekipler, odaklanmış bir paket almadan önce genellikle üç şeyden birini dener:
- Bir masaüstü editöründe elle yapmak: tek bir belge için uygundur, zamanlaması imkânsızdır ve kimse saat 02:00’de çalışan manuel bir adıma onay vermez.
- Ham dosya API’lerine karşı tek seferlik bir betik yazmak: bir sonraki giriş formatı ortaya çıkana kadar çalışır ve betik, kaçınmak için tasarlandığı genel amaçlı istemciye dönüşür.
- Tek bir çağrı için tam
Mergersınıfına yönelmek: doğru, ancak bir işlem için gerekenin çok ötesinde daha geniş bir API yüzeyi ekler.
GroupDocs.Merger.LowCode tam da bu son boşluk için vardır: işlem başına bir çağrı, önce öğrenilecek başka bir şey yok.
Çözüm: Back-Office Boru Hatları için GroupDocs.Merger.LowCode
GroupDocs.Merger.LowCode, yedi tek amaçlı ürünü o tek yapıcı‑sonra‑Save şekliyle paketler. JoinPdf ve JoinDocx bir belgeyi diğerine ekler; JoinPptx aynı şeyi sunumlar için yapar; SplitPdf, SplitDocx ve SplitPptx seçilen sayfaları ya da slaytları kendi dosyalarına çeker; RemovePagesPdf kaynağa dokunmadan sayfaları kaldırır. Yedi ürünün her biri kaynağını bir yol ya da akış (stream) olarak alır ve herhangi bir şey yazmadan önce bu kaynağı ve verilen her dosyayı kendi formatına karşı kontrol eder, böylece bir boru hattı çıktının neden yanlış olduğunu tahmin etmek zorunda kalmaz.
Aşağıdaki uygulamayı izlemek için şunlara ihtiyacınız olacak:
- .NET 6.0 veya üzeri (bu örnek projesi net8.0 hedefli)
- Ayrı
GroupDocs.Merger.LowCodeNuGet paketi - temporary license bağlantısı, değerlendirme sınırlamaları olmadan çıktıyı görmek isterseniz
dotnet add package GroupDocs.Merger.LowCode
Paket, ana GroupDocs.Merger kütüphanesinden ayrı olarak NuGet üzerinde bulunur.
Reporting-Pack İş Adımını Adım Adım Uygulama
Yedi ürünün her birinin izlediği şekil aşağıdadır; bu örnek, aylık bir PDF’ye kapak sayfası ekleyen bir birleştirmeyi gösterir.
Adım 1: Ürünü Kaynağına Yönlendirin
JoinPdf yapıcısı kaynak belgeyi, eklenecek her dosyayı ve bir JoinOptions örneğini alır; henüz bir şey çalışmaz.
var join = new JoinPdf("report.pdf", new[] { "appendix.pdf" }, new JoinOptions());
Adım 2: Sonucun Nereye Gidileceğini Belirleyin
Save(outputPath) işin gerçekten kaydedildiği yerdir. Göreceli bir yol, işlemin geçerli çalışma dizinine göre çözülür ve Save, klasör zaten yoksa oluşturur; böylece her çalıştırmada yeni bir ay klasörüne yazan bir boru hattının ayrı bir klasör oluşturma adımına ihtiyacı olmaz.
string outputPath = "output/monthly/report-with-appendix.pdf";
Bu, denetimsiz bir iş için neden önemlidir:
- Kontrol ettiğiniz bir yol: çıktı yolunu yapılandırmadan ya da iş parametresinden oluşturun, asla doğrulanmamış girdiyle doğrudan almayın;
Saveboş ya da null bir yol verildiğindeArgumentNullExceptionfırlatır. - Oluşturduğu klasör: her çalıştırmada yeni bir hedefe yazan zamanlanmış bir iş, kendi içinde ayrı bir “dizin var mı” adımı taşımaz.
Adım 3: Çalıştırın ve Geri Dönen Sonucu Yakalayın
Save çağrısı birleştirmeyi hemen çalıştırır; ayrı bir “derle‑sonra‑çalıştır” adımı yoktur.
join.Save(outputPath);
var sizeInBytes = new FileInfo(outputPath).Length;
Örnek dosyalarımızla yaptığımız çalışmada, bu çağrı 2 sayfalık report.pdf dosyasını 2 sayfalık appendix.pdf ile birleştirerek 4 sayfalık, 257987 baytlık report-with-appendix.pdf oluşturdu.
Adım 4: Sonucu Boru Hattına Geri Besleyin
Save sonrası okunan dosya boyutu, genellikle bir zamanlayıcının işi tamamlandığını işaretlemeden ya da çıktının güvenilirliğini belirlemek için minimum boyutla karşılaştırmadan önce ihtiyaç duyduğu tek şeydir.
if (sizeInBytes == 0)
{
throw new InvalidOperationException("Join produced an empty file.");
}
GroupDocs.Merger.LowCode Bir Dosya Yolu Yerine Akış (Stream) Kabul Ediyor mu?
Evet, giriş tarafında. Yedi ürünün her biri, dosya yolu konumuna gelecek şekilde aynı yapıcı konumunda kaynağını bir akış (stream) olarak kabul eder; bu, bir işin girdisinin yerel disk yerine blob depolama ya da kuyruktan gelmesi durumunda kullanışlıdır. Save yine de sonucu bir çıktı yolu dizesine yazar; çıktıyı akış olarak işlemek tamamen Merger sınıfında kalır.
Gerçek İş Akışı: Bir Dosyanın Arşive Ulaşmadan Önce Reddedilmesi
İmzalı sözleşmelere ek ekler ekleyen bir sözleşme ekibi, gelen kutusuna düşen herhangi bir dosyayı kabul etme riskini göze alamaz; .docx bir ek, PDF birleştirme yanında yanlış dosya olarak konulursa arşiv girişi bozulur. JoinPdf, kaynak ve eklenen her dosyayı PDF formatına karşı kontrol eder ve eşleşmediği anda FileTypeNotSupportedException fırlatır.
try
{
new JoinPdf("report.pdf", new[] { "contract.docx" }, new JoinOptions())
.Save("output/mixed.pdf");
}
catch (FileTypeNotSupportedException exception)
{
Console.WriteLine(exception.Message);
}
Örnek çalışmada, yollar resources klasöründen oluşturulduğunda mesaj şu şekilde okunur: Input format does not match the expected format 'PDF'; the joined file 'resources\contract.docx' is 'Microsoft Word Open XML Document (.docx)'.
Yukarıdaki iş, yakalama bloğu çalıştığında output/mixed.pdf dosyasını hiç yazmaz; böylece bir sözleşme boru hattı bu mesajı zaten kullandığı uyarı ya da bilet kuyruğuna doğrudan yönlendirebilir, kötü bir arşiv girdisini günler sonra keşfetmek yerine.
Bu Desenin Uygun Olduğu Diğer Back-Office Senaryoları
Yukarıdaki birleştirme çalıştıktan sonra, aynı yapıcı‑sonra‑Save şekli, bir back office’in zamanlanmış olarak yürüttüğü birkaç işi kapsar:
- Bir belge binayı terk etmeden önce bir sayfayı kırpma:
RemovePagesPdfseçilen sayfaları kaldırır ve kaynağa dokunmadan yeni bir dosya yazar; böylece kırpılmış kopya gönderildikten sonra orijinal denetim için kullanılabilir. Kendi çalışmamızda,report.pdfdosyasının 2. sayfasını kaldırmak 1 sayfalık, 86647 baytlıkreport-without-page-2.pdfüretti vereport.pdfdeğişmeden kaldı. - Bir paydaş için bir sunumu bölme:
SplitPptxistenen slaytları kendi dosyalarına çeker; çıktı deseni içinde{0}belirteciyle adlandırılır ya da belirteç yoksa aynı klasörde ek bir parça numarası eklenir; bu aynı desenSplitPdfPDF sayfalarını bölmek için kullanır. - PDF yerine Word belgelerini birleştirme:
JoinDocx,JoinPdfile aynı yapıcı‑sonra‑Saveşeklini izler, eklenen belgeyi kaynağın son sayfasının ardından yerleştirir.
Lisans olmadan, bu işlemlerin her biri değerlendirme modunda çalışır. Lisanssız çalışmamızda, birleştirilen PDF ve Word çıktıları her biri 3 sayfaya düşürüldü, ancak tüm altı örnek çıktı hâlâ üretildi; üretimde denetimsiz çalıştırmadan önce License.Set ile bir lisans uygulayın.
Back-Office Boru Hattınızda Başlarken
Uçtan uca çalışan bir düşük kodlu belge birleştirme modeliniz ve her çağrıda çalışan format kontrol kanıtınız var. Bundan sonra yapabilecekleriniz:
- Tam resmi görün: eşlik eden use-case guide örnek altı işlemi adım adım, tam bir SSS ile açıklar.
- İş büyüdükçe daha derine in: full GroupDocs.Merger API bu modelin bir işlemden daha fazlasına ihtiyaç duyduğu anda daha geniş bir alanı kapsar.
- Kodu incele: complete sample on GitHub yukarıda kullanılan tüm giriş dosyalarını içerir.
- Kur: installation page ayrı paketi ve desteklenen hedef çerçeveleri açıklar.
- Değerlendirme sınırlamalarını kaldır: üretimde çalıştırmadan önce bir temporary license alın.
- Sorular: support forum ekibin uygulama sorularını yanıtladığı yerdir.