💡 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ę Merger dla 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; Save rzuca ArgumentNullException przy 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: RemovePagesPdf usuwa 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 z report.pdf dało 1‑stronicowy, 86647‑bajtowy report-without-page-2.pdf, a sam report.pdf pozostał niezmieniony.
  • Dzielenie prezentacji dla jednego interesariusza: SplitPptx wycią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 przez SplitPdf do dzielenia stron PDF.
  • Scalanie dokumentów Word zamiast PDF‑ów: JoinDocx podąża dokładnie za strukturą konstruktor‑Save jak JoinPdf, 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.

Zasoby