💡 Plně funkční příklad dostupný na GitHubu: one-line-document-merge-and-split-dotnet
Kde ve skutečnosti probíhají úlohy back‑office dokumentů
Finanční back‑office uzavírá měsíc připevněním titulní stránky k PDF výpisu z minulého měsíce. Tým smluv připojuje podepsaný dodatkový dokument k původní smlouvě, než ji odešle do archivu. Asistent prodeje‑operací vyjme dva snímky ze šedesátisnímkového decku, protože jeden stakeholder potřeboval jen stránku s cenami. Úředník archivace odstraní stránku, která nikdy neměla být odeslána, těsně před tím, než soubor opustí budovu.
Žádná z těchto úloh není projektem slučování. Každá se týká jednoho souboru a jedné operace, prováděné stejným způsobem pokaždé, když úloha běží, obvykle někým, kdo nemá zájem učit se obecné API pro dokumenty jen kvůli dosažení cíle.
GroupDocs.Merger.LowCode je .NET balíček, který promění takovou úlohu – spojení, rozdělení nebo odstranění stránky – na jediný volání konstruktoru, oddělený od obecné třídy Merger, kterou tyto úlohy nikdy nepotřebují. Každý ze svých sedmi produktů přijímá ve svém konstruktoru zdroj a možnosti, v C#, a provede se až po zavolání Save, a to ve stejném tvaru, ať už jde o PDF, Word dokument nebo PowerPoint prezentaci.
Proč obecná řešení zde nefungují
Týmy čelící jedné z těchto úloh obvykle vyzkouší jednu ze tří možností, než sáhnou po specializovaném balíčku:
- Provést to ručně v desktopovém editoru: v pořádku pro jeden dokument, nemožné naplánovat a nikdo neschvaluje manuální krok běžící ve 2 ráno.
- Napsat jednorázový skript využívající surové souborové API: funguje, dokud se neobjeví další vstupní formát, a skript se rozroste právě v obecného klienta, kterému se chtěl vyhnout.
- Sáhnout po plné třídě
Mergerpro jediný volání: je to správné, ale přidává širší rozhraní API, než kdyby jedna operace kdy potřebovala.
GroupDocs.Merger.LowCode existuje právě pro tuto poslední mezeru: jedno volání na operaci, nic dalšího se předtím nemusí učit.
Řešení: GroupDocs.Merger.LowCode pro back‑office pipeline
GroupDocs.Merger.LowCode balíčkovává sedm jednoprvkových produktů za tímto tvarem konstruktor‑pak‑Save. JoinPdf a JoinDocx připojují dokument k dalšímu; JoinPptx dělá totéž pro prezentace; SplitPdf, SplitDocx a SplitPptx vytahují vybrané stránky nebo snímky do samostatných souborů; RemovePagesPdf odstraňuje stránky, aniž by se dotýkal zdroje. Každý ze sedmi přijímá svůj zdroj jako cestu nebo stream a kontroluje tento zdroj, spolu se všemi předanými soubory, vůči svému formátu před zápisem, takže pipeline nikdy nemusí hádat, proč výstup selhal.
Abyste mohli sledovat níže uvedenou implementaci, budete potřebovat:
- .NET 6.0 nebo novější (projekt tohoto příkladu cílí na net8.0)
- Samostatný NuGet balíček
GroupDocs.Merger.LowCode - Dočasnou licenci (temporary license), pokud chcete vidět výstup bez omezení vyhodnocení popsaných níže
dotnet add package GroupDocs.Merger.LowCode
Balíček je umístěn samostatně na NuGet mimo hlavní knihovnu GroupDocs.Merger.
Implementace úlohy Reporting‑Pack krok za krokem
Zde je tvar, který každý ze sedmi produktů dodržuje, ukázán na příkladu spojení, které připojuje titulní stránku k měsíčnímu PDF.
Krok 1: Nastavte produkt na jeho zdroj
Konstruktor JoinPdf přijímá zdrojový dokument, všechny soubory k připojení a instanci JoinOptions; zatím se nic nespustí.
var join = new JoinPdf("report.pdf", new[] { "appendix.pdf" }, new JoinOptions());
Krok 2: Rozhodněte, kam výsledek půjde
Save(outputPath) je místo, kde úloha skutečně uloží výsledek. Relativní cesta se vyhodnocuje vůči aktuálnímu pracovním adresáři procesu a Save vytvoří výstupní složku, pokud ještě neexistuje, takže pipeline zapisující do nové měsíční složky při každém běhu nepotřebuje samostatný krok pro její vytvoření.
string outputPath = "output/monthly/report-with-appendix.pdf";
Proč je to důležité pro neřízenou úlohu:
- Cesta, kterou kontrolujete: sestavte výstupní cestu z konfigurace nebo parametru úlohy, nikdy přímo z neověřeného vstupu;
SavevyhodíArgumentNullExceptionpři null nebo prázdné cestě. - Složka, kterou vytvoří: naplánovaná úloha, která při každém běhu zapisuje do nového umístění, nepotřebuje samostatný krok „zajistit existenci adresáře“.
Krok 3: Spusťte to a zachyťte výsledek
Volání Save spustí spojení okamžitě; neexistuje samostatný krok sestavení‑pak‑spuštění.
join.Save(outputPath);
var sizeInBytes = new FileInfo(outputPath).Length;
V našem vlastním běhu na souborech ze vzorku toto volání spojilo dvoustránkový report.pdf s dvoustránkovým appendix.pdf do čtyřstránkového, 257987‑bajtového report-with-appendix.pdf.
Krok 4: Vraťte výsledek zpět do pipeline
Velikost souboru načtená těsně po Save je obvykle vše, co plánovač potřebuje před označením úlohy jako dokončené, nebo před porovnáním s minimální velikostí, aby rozhodl, zda je výstup dostatečně spolehlivý k dalšímu kroku.
if (sizeInBytes == 0)
{
throw new InvalidOperationException("Join produced an empty file.");
}
Přijímá GroupDocs.Merger.LowCode stream místo cesty k souboru?
Ano, na vstupní straně. Každý ze sedmi produktů přijímá svůj zdroj jako stream ve stejné pozici konstruktoru, kde by byla cesta k souboru, což je užitečné, když vstup úlohy pochází z blob úložiště nebo fronty místo lokálního disku. Save i nadále zapisuje výsledek do řetězce výstupní cesty; streamování samotného výstupu zůstává ve full Merger třídě.
Skutečný pracovní postup: Odmítnutí souboru před tím, než dorazí do archivu
Tým smluv, který připojuje dodatky k podepsaným dohodám, si nemůže dovolit přijímat jakýkoli soubor, který dorazí do schránky; .docx dodatek nesprávně umístěný vedle PDF spojení by jinak vytvořil poškozený archivní záznam. JoinPdf kontroluje zdroj a každý připojovaný soubor vůči PDF formátu před zápisem a vyvolá FileTypeNotSupportedException, jakmile se některý neshoduje.
try
{
new JoinPdf("report.pdf", new[] { "contract.docx" }, new JoinOptions())
.Save("output/mixed.pdf");
}
catch (FileTypeNotSupportedException exception)
{
Console.WriteLine(exception.Message);
}
Ve vzorovém běhu, kde jsou cesty sestaveny z jeho složky resources, zpráva zněla: Input format does not match the expected format 'PDF'; the joined file 'resources\contract.docx' is 'Microsoft Word Open XML Document (.docx)'.
Výše uvedená úloha nikdy nezapíše output/mixed.pdf, když se zachytí výjimka, takže pipeline smluv může tuto zprávu nasměrovat přímo do jakéhokoli výstražného nebo ticketového frontu, který již používá, místo aby objevila špatný archivní záznam o několik dní později.
Další scénáře back‑office, kde tento vzor zapadá
Jakmile výše uvedené spojení funguje, stejný tvar konstruktor‑pak‑Save pokrývá několik úloh, které back‑office spouští podle plánu:
- Oříznutí stránky před tím, než dokument opustí budovu:
RemovePagesPdfodstraňuje vybrané stránky a zapíše nový soubor, aniž by se dotkl zdroje, takže originál zůstává k dispozici pro audit po odeslání oříznuté kopie. V našem vlastním běhu odstranění stránky 2 zreport.pdfvytvořilo 1‑stránkový, 86647‑bajtovýreport-without-page-2.pdf, areport.pdfzůstal nezměněn. - Rozdělení prezentace pro jednoho stakeholdera:
SplitPptxvytahuje požadované snímky do samostatných souborů, pojmenovaných pomocí tokenu{0}ve výstupním vzoru nebo, pokud není, připojeným číslem části ve stejné složce, stejný vzor, kterýSplitPdfpoužívá k rozdělení PDF stránek. - Slučování Word dokumentů místo PDF:
JoinDocxdodržuje přesně tvar konstruktor‑pak‑SavejakoJoinPdf, přičemž připojený dokument umístí za poslední stránku zdroje.
Bez licence každá z těchto úloh běží v evaluačním režimu. V našem vlastním nelicencovaném běhu byly spojené PDF a Word výstupy zkráceny na 3 stránky každý, ačkoliv všech šest vzorových výstupů bylo stále vytvořeno; použijte licenci pomocí License.Set před tím, než se cokoli z toho spustí bez dozoru ve výrobě.
Začínáme ve vaší back‑office pipeline
Máte jeden low‑code vzor pro slučování dokumentů fungující od začátku do konce, plus důkaz, že kontrola formátu běží při každém volání. Zde je, kam dál:
- Prohlédněte si celý obrázek: doprovodný use-case guide provádí každou ze šesti operací vzorku krok za krokem, s kompletním FAQ.
- Jděte hlouběji, až úloha poroste: plné API GroupDocs.Merger pokrývá více oblastí, než tento vzor potřebuje, jakmile pipeline překročí jednu operaci.
- Prohlédněte si kód: kompletní ukázka na GitHubu obsahuje všechny vstupní soubory použité výše.
- Nainstalujte jej: stránka instalace popisuje samostatný balíček a podporované cílové frameworky.
- Odstraňte evaluační omezení: získejte temporary license před spuštěním čehokoli v produkci.
- Otázky: support forum je místo, kde tým odpovídá na otázky ohledně implementace.