💡 Pełny działający przykład dostępny na GitHubie:
one-line-document-merge-and-split-dotnet
Gdzie faktycznie znajdują się zadania dokumentów w back office
Back office finansowy zamyka miesiąc, przybijając okładkę do PDF‑a z zeszłomiesięcznym zestawieniem. Zespół ds. kontraktów dołącza podpisany aneks do pierwotnej umowy, zanim trafi do archiwum. Asystent ds. sprzedaży i operacji wyciąga dwa slajdy z sześćdziesięcioslajdowej prezentacji, ponieważ jeden interesariusz potrzebował tylko strony z cenami. Pracownik archiwizacji usuwa stronę, której nigdy nie powinno się wysyłać, tuż przed opuszczeniem pliku budynku.
Żadne z tych zadań nie jest projektem scalania. Każde z nich to jeden plik i jedna operacja, wykonywana w ten sam sposób za każdym uruchomieniem zadania, zazwyczaj przez kogoś, kto nie ma ochoty uczyć się ogólnego API dokumentów tylko po to, aby to osiągnąć.
GroupDocs.Merger.LowCode to pakiet .NET, który zamienia takie zadanie – łączenie, dzielenie lub usuwanie stron – w pojedyncze wywołanie konstruktora, odróżniając się od ogólnego klasy Merger, której te zadania nigdy nie potrzebują. Każdy z jego siedmiu produktów przyjmuje źródło i opcje w konstruktorze, w C#, i działa dopiero po wywołaniu Save, przy zachowaniu tej samej struktury niezależnie od tego, czy zadanie dotyczy PDF‑a, dokumentu Word czy prezentacji PowerPoint.
Dlaczego ogólne rozwiązania nie sprawdzają się tutaj
Zespoły napotykające takie zadanie zazwyczaj próbują jednej z trzech rzeczy, zanim sięgną po dedykowany pakiet:
- Robienie tego ręcznie w edytorze desktopowym: w porządku dla jednego dokumentu, niemożliwe do zaplanowania i nikt nie zatwierdzi ręcznego kroku uruchamianego o 2 nad ranem.
- Pisanie jednorazowego skryptu korzystającego z surowych API plików: działa, dopóki nie pojawi się kolejny format wejściowy, a skrypt rośnie w dokładnie taki ogólny klient, którego miał unikać.
- Sięgnięcie po pełną klasę
Mergerdla pojedynczego wywołania: poprawne, ale zwiększa powierzchnię API ponad to, czego potrzebuje pojedyncza operacja.
GroupDocs.Merger.LowCode istnieje właśnie po to, aby wypełnić tę ostatnią lukę: jedno wywołanie na operację, nic więcej do nauki na początek.
Rozwiązanie: GroupDocs.Merger.LowCode dla potoków back‑office
GroupDocs.Merger.LowCode pakietuje siedem produktów jednopurposowych w tej samej strukturze: konstruktor, a potem Save. JoinPdf i JoinDocx dołączają dokument do innego; JoinPptx robi to samo dla prezentacji; SplitPdf, SplitDocx i SplitPptx wyciągają wybrane strony lub slajdy do osobnych plików; RemovePagesPdf usuwa strony bez dotykania źródła. Każdy z siedmiu przyjmuje źródło jako ścieżkę lub strumień i sprawdza to źródło, oraz każdy podany plik, pod kątem własnego formatu przed zapisaniem czegokolwiek, więc potok nigdy nie musi zgadywać, dlaczego wynik jest niepoprawny.
Aby śledzić poniższą implementację, będziesz potrzebować:
- .NET 6.0 lub nowszy (projekt tego przykładu celuje w net8.0)
- Oddzielny pakiet NuGet
GroupDocs.Merger.LowCode - Tymczasową licencję, jeśli chcesz zobaczyć wynik bez ograniczeń ewaluacyjnych opisanych dalej
dotnet add package GroupDocs.Merger.LowCode
Pakiet jest dostępny osobno na NuGet od głównej biblioteki GroupDocs.Merger.
Implementacja zadania Reporting-Pack krok po kroku
Oto struktura, której podąża każdy z siedmiu produktów, przedstawiona na przykładzie łączenia, które dołącza okładkę do miesięcznego PDF‑a.
Krok 1: Wskaż produkt na jego źródło
Konstruktor JoinPdf przyjmuje dokument źródłowy, każdy plik do dołączenia oraz instancję JoinOptions; nic nie jest jeszcze wykonywane.
var join = new JoinPdf("report.pdf", new[] { "appendix.pdf" }, new JoinOptions());
Krok 2: Zdecyduj, gdzie trafi wynik
Save(outputPath) to miejsce, w którym zadanie faktycznie zapisuje wynik. Ścieżka względna jest rozwiązywana względem bieżącego katalogu roboczego procesu, a Save tworzy folder wyjściowy, jeśli jeszcze nie istnieje, więc potok zapisujący do nowego folderu miesiąca przy każdym uruchomieniu nie potrzebuje osobnego kroku tworzenia go.
string outputPath = "output/monthly/report-with-appendix.pdf";
Dlaczego to ma znaczenie dla zadania bez nadzoru:
- Ścieżka pod twoją kontrolą: buduj ścieżkę wyjściową z konfiguracji lub parametru zadania, nigdy bezpośrednio z niezweryfikowanego wejścia;
SaverzucaArgumentNullExceptionprzy null lub pustej ścieżce. - Folder, który tworzy: zaplanowane zadanie, które zapisuje do nowego miejsca przy każdym uruchomieniu, nie wymaga osobnego kroku „upewnij się, że katalog istnieje”.
Krok 3: Uruchom i przechwyć zwrócony wynik
Wywołanie Save uruchamia łączenie natychmiast; nie ma osobnego kroku budowania, a potem wykonywania.
join.Save(outputPath);
var sizeInBytes = new FileInfo(outputPath).Length;
W naszym własnym uruchomieniu na plikach przykładu, to wywołanie połączyło 2‑stronicowy report.pdf z 2‑stronicowym appendix.pdf w 4‑stronicowy, 257987‑bajtowy report-with-appendix.pdf.
Krok 4: Przekaż wynik z powrotem do potoku
Rozmiar pliku odczytany zaraz po Save jest zazwyczaj wszystkim, czego potrzebuje harmonogram przed oznaczeniem zadania jako zakończone, lub przed porównaniem go z minimalnym rozmiarem, aby zdecydować, czy wynik jest wystarczająco wiarygodny, aby kontynuować.
if (sizeInBytes == 0)
{
throw new InvalidOperationException("Join produced an empty file.");
}
Czy GroupDocs.Merger.LowCode akceptuje strumień zamiast ścieżki pliku?
Tak, po stronie wejścia. Każdy z siedmiu produktów przyjmuje źródło jako strumień w tym samym miejscu konstruktora, w którym znajdowałaby się ścieżka pliku, co jest przydatne, gdy wejście zadania pochodzi z magazynu blobów lub kolejki zamiast z lokalnego dysku. Save nadal zapisuje wynik do ciągu ścieżki wyjściowej w obu przypadkach; strumieniowanie samego wyniku pozostaje w pełnej klasie Merger.
Rzeczywisty przepływ pracy: odrzucanie pliku przed jego archiwizacją
Zespół ds. kontraktów dołączający aneksy do podpisanych umów nie może ryzykować przyjęcia dowolnego pliku, który trafi do skrzynki; aneks w formacie .docx umieszczony obok łączenia PDF spowodowałby uszkodzony wpis w archiwum. JoinPdf sprawdza źródło i każdy dołączany plik pod kątem formatu PDF przed zapisaniem czegokolwiek i podnosi FileTypeNotSupportedException, gdy którykolwiek z nich nie pasuje.
try
{
new JoinPdf("report.pdf", new[] { "contract.docx" }, new JoinOptions())
.Save("output/mixed.pdf");
}
catch (FileTypeNotSupportedException exception)
{
Console.WriteLine(exception.Message);
}
W przykładowym uruchomieniu, gdzie ścieżki są budowane z folderu resources, komunikat brzmiał: Input format does not match the expected format 'PDF'; the joined file 'resources\contract.docx' is 'Microsoft Word Open XML Document (.docx)'.
Powyższe zadanie nigdy nie zapisuje output/mixed.pdf, gdy zostanie przechwycony wyjątek, więc potok kontraktowy może skierować tę wiadomość bezpośrednio do dowolnego alertu lub kolejki zgłoszeń, której już używa, zamiast odkrywać uszkodzony wpis w archiwum po kilku dniach.
Inne scenariusze back‑office, w których ten wzorzec się sprawdza
Gdy powyższe łączenie działa, ta sama struktura konstruktor‑Save obejmuje kilka zadań, które back office wykonuje według harmonogramu:
- Przycinanie strony przed opuszczeniem budynku przez dokument:
RemovePagesPdfusuwa wybrane strony i zapisuje nowy plik bez modyfikacji źródła, więc oryginał pozostaje dostępny do audytu po wysłaniu przyciętej kopii. W naszym własnym uruchomieniu, usunięcie strony 2 zreport.pdfdało 1‑stronicowy, 86647‑bajtowyreport-without-page-2.pdf, a samreport.pdfpozostał niezmieniony. - Dzielenie prezentacji dla jednego interesariusza:
SplitPptxwyciąga żądane slajdy do osobnych plików, nazwanych według tokenu{0}w wzorcu wyjściowym lub, jeśli go nie ma, przez dołączony numer części w tym samym folderze, tak jak wzorzec używany przezSplitPdfdo dzielenia stron PDF. - Scalanie dokumentów Word zamiast PDF‑ów:
JoinDocxpodąża dokładnie za strukturą konstruktor‑SavejakJoinPdf, umieszczając dołączany dokument po ostatniej stronie źródła.
Bez licencji każde z tych zadań działa w trybie ewaluacyjnym. W naszym własnym uruchomieniu bez licencji, połączone PDF‑y i Wordy zostały ograniczone do 3 stron każdy, choć wszystkie sześć wyników przykładowych zostało nadal wygenerowanych; zastosuj licencję za pomocą License.Set przed uruchomieniem tego w trybie bez nadzoru w produkcji.
Rozpoczęcie pracy w Twoim potoku back‑office
Masz jeden wzorzec niskokodowego scalania dokumentów działający od początku do końca, plus dowód, że sprawdzanie formatu odbywa się przy każdym wywołaniu. Oto, co dalej:
- Zobacz pełny obraz: przewodnik przewodnik po przypadkach użycia opisuje każdy z sześciu przykładów metodą po metodzie, z pełnym FAQ.
- Zagłęb się, gdy zadanie rośnie: pełne API GroupDocs.Merger obejmuje więcej niż potrzebuje ten wzorzec, gdy potok przekracza jedną operację.
- Przeglądaj kod: pełny przykład na GitHubie zawiera wszystkie pliki wejściowe użyte powyżej.
- Zainstaluj: strona instalacji opisuje oddzielny pakiet i obsługiwane docelowe frameworki.
- Usuń ograniczenia ewaluacyjne: zdobądź tymczasową licencję przed uruchomieniem tego w produkcji.
- Pytania: forum wsparcia to miejsce, w którym zespół odpowiada na pytania implementacyjne.