💡 Voll funktionsfähiges Beispiel auf GitHub verfügbar:
one-line-document-merge-and-split-dotnet

Wo Back‑Office‑Dokumentjobs tatsächlich stattfinden

Ein Finanz‑Back‑Office schließt den Monat ab, indem er eine Deckblatt‑Seite an das PDF‑Statement des Vormonats heftet. Ein Vertrags‑Team fügt einer unterschriebenen Vereinbarung einen unterschriebenen Nachtrag hinzu, bevor sie archiviert wird. Ein Sales‑Ops‑Assistent zieht zwei Folien aus einem sechzig‑Folie‑Deck heraus, weil ein Stakeholder nur die Preis‑Seite benötigt. Ein Akten‑Sachbearbeiter entfernt eine Seite, die niemals verschickt werden sollte, kurz bevor die Datei das Gebäude verlässt.

Keines davon ist ein Merge‑Projekt. Jeder Vorgang ist eine Datei und ein Vorgang, jedes Mal auf dieselbe Weise ausgeführt, meist von jemandem, der kein Interesse daran hat, eine allgemeine Dokument‑API zu erlernen, nur um das Ziel zu erreichen.

GroupDocs.Merger.LowCode ist ein .NET‑Paket, das einen solchen Job – ein Join, ein Split oder ein Seiten‑Entfernen – in einen einzigen Konstruktoraufruf verwandelt und damit von der allgemeinen Merger‑Klasse, die diese Jobs nie benötigen, abhebt. Jedes seiner sieben Produkte nimmt seine Quelle und seine Optionen im Konstruktor entgegen, in C#, und führt die Arbeit nur aus, wenn Save aufgerufen wird – unabhängig davon, ob es sich um ein PDF, ein Word‑Dokument oder ein PowerPoint‑Deck handelt.

Warum generische Lösungen hier nicht halten

Teams, die vor einem dieser Jobs stehen, versuchen meist eines von drei Dingen, bevor sie zu einem fokussierten Paket greifen:

  • Manuell in einem Desktop‑Editor erledigen: in Ordnung für ein Dokument, unmöglich zu planen, und niemand genehmigt einen manuellen Schritt, der um 2 Uhr morgens läuft.
  • Ein einmaliges Skript gegen rohe Datei‑APIs schreiben: funktioniert, bis das nächste Eingabeformat auftaucht, und das Skript wächst zu genau dem universellen Client, den es vermeiden sollte.
  • Die vollständige Merger‑Klasse für einen einzelnen Aufruf verwenden: korrekt, fügt jedoch eine breitere API‑Oberfläche hinzu, als für eine einzelne Operation jemals nötig wäre.

GroupDocs.Merger.LowCode existiert genau für diese letzte Lücke: ein Aufruf pro Operation, nichts weiter zu lernen.


Die Lösung: GroupDocs.Merger.LowCode für Back‑Office‑Pipelines

GroupDocs.Merger.LowCode bündelt sieben Single‑Purpose‑Produkte hinter dieser Konstruktor‑dann‑Save‑Form. JoinPdf und JoinDocx hängen ein Dokument an ein anderes an; JoinPptx macht dasselbe für Decks; SplitPdf, SplitDocx und SplitPptx ziehen ausgewählte Seiten bzw. Folien in eigene Dateien; RemovePagesPdf entfernt Seiten, ohne die Quelle zu berühren. Jedes der sieben akzeptiert seine Quelle als Pfad oder Stream und prüft diese Quelle sowie jede übergebene Datei gegen das eigene Format, bevor etwas geschrieben wird, sodass eine Pipeline nie raten muss, warum ein Output falsch ist.

Um die nachfolgende Implementierung nachzuvollziehen, benötigen Sie:

  • .NET 6.0 oder höher (dieses Beispiel‑Projekt zielt auf net8.0)
  • Das separate GroupDocs.Merger.LowCode‑NuGet‑Paket
  • Eine temporäre Lizenz, falls Sie die Ausgabe ohne die weiter unten beschriebenen Evaluierungs‑Limits sehen möchten
dotnet add package GroupDocs.Merger.LowCode

Das Paket ist separat auf NuGet vom Haupt‑GroupDocs.Merger‑Bibliothekspaket verfügbar.


Implementierung des Reporting‑Pack‑Jobs Schritt für Schritt

Hier ist die Form, der jedes der sieben Produkte folgt, demonstriert am Join, der eine Deckblatt‑Seite an ein monatliches PDF anhängt.

Schritt 1: Produkt auf seine Quelle zeigen

Der Konstruktor von JoinPdf nimmt das Quell‑Dokument, jede anzuhängende Datei und eine JoinOptions‑Instanz entgegen; es wird noch nichts ausgeführt.

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

Schritt 2: Entscheiden, wohin das Ergebnis geht

Save(outputPath) ist der Ort, an dem der Job tatsächlich abschließt. Ein relativer Pfad wird relativ zum aktuellen Arbeitsverzeichnis des Prozesses aufgelöst, und Save erstellt den Ausgabeverzeichnis, falls er noch nicht existiert, sodass eine Pipeline, die bei jedem Lauf in einen neuen Monatsordner schreibt, keinen separaten Schritt zur Bereitstellung benötigt.

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

Warum das für einen unbeaufsichtigten Job wichtig ist:

  • Ein Pfad, den Sie kontrollieren: bauen Sie den Ausgabepfad aus Konfiguration oder einem Job‑Parameter, niemals direkt aus ungeprüfter Eingabe; Save wirft ArgumentNullException bei einem null‑ oder leeren Pfad.
  • Der Ordner, den es erstellt: ein geplanter Job, der jedes Mal in ein neues Ziel schreibt, benötigt keinen separaten „Verzeichnis sicherstellen“‑Schritt.

Schritt 3: Ausführen und das Ergebnis erfassen

Der Aufruf von Save führt den Join sofort aus; es gibt keinen separaten Build‑dann‑Execute‑Schritt.

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

In unserem eigenen Durchlauf mit den Beispieldateien hat dieser Aufruf ein 2‑Seiten‑report.pdf mit einem 2‑Seiten‑appendix.pdf zu einer 4‑Seiten‑, 257987‑Byte‑report-with-appendix.pdf zusammengeführt.

Schritt 4: Ergebnis zurück in die Pipeline speisen

Die Dateigröße, die unmittelbar nach Save gelesen wird, reicht für einen Scheduler meist aus, um den Job als abgeschlossen zu markieren oder um sie mit einer Minimalgröße zu vergleichen, um zu entscheiden, ob das Ergebnis vertrauenswürdig genug ist, um weiterverarbeitet zu werden.

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

Akzeptiert GroupDocs.Merger.LowCode einen Stream anstelle eines Dateipfads?

Ja, auf der Eingabeseite. Jedes der sieben Produkte akzeptiert seine Quelle als Stream an derselben Stelle im Konstruktor, an der ein Dateipfad stehen würde – praktisch, wenn die Eingabe eines Jobs aus Blob‑Storage oder einer Queue stammt statt von der lokalen Festplatte. Save schreibt das Ergebnis weiterhin in einen Ausgabepfad‑String, egal wie; das Streamen des Outputs selbst bleibt in der vollständigen Merger‑Klasse.


Realer Workflow: Datei ablehnen, bevor sie das Archiv erreicht

Ein Vertrags‑Team, das Nachträge zu unterschriebenen Vereinbarungen anhängt, kann es sich nicht leisten, irgendeine Datei aus dem Posteingang zu akzeptieren; ein .docx‑Nachtrag, der versehentlich neben einem PDF‑Join liegt, würde sonst einen fehlerhaften Archiveintrag erzeugen. JoinPdf prüft die Quelle und jede anzuhängende Datei gegen das PDF‑Format, bevor etwas geschrieben wird, und wirft FileTypeNotSupportedException, sobald eine Datei nicht passt.

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

Im Beispiel‑Durchlauf, bei dem die Pfade aus dem resources‑Ordner gebaut werden, lautete die Meldung: Input format does not match the expected format 'PDF'; the joined file 'resources\contract.docx' is 'Microsoft Word Open XML Document (.docx)'.

Der obige Job schreibt output/mixed.pdf nie, wenn der Catch ausgelöst wird, sodass ein Vertrags‑Pipeline diese Meldung direkt in die bereits genutzte Alarm‑ oder Ticket‑Queue leiten kann, anstatt erst Tage später einen fehlerhaften Archiveintrag zu entdecken.


Weitere Back‑Office‑Szenarien, in denen dieses Muster passt

Sobald der obige Join funktioniert, deckt dieselbe Konstruktor‑dann‑Save‑Form mehrere Jobs ab, die ein Back‑Office nach einem Zeitplan ausführt:

  • Eine Seite vor dem Verlassen des Dokuments trimmen: RemovePagesPdf entfernt die ausgewählten Seiten und schreibt eine neue Datei, ohne die Quelle zu berühren, sodass das Original für Audits nach dem Versand der getrimmten Kopie verfügbar bleibt. In unserem eigenen Durchlauf erzeugte das Entfernen von Seite 2 aus report.pdf eine 1‑Seiten‑, 86647‑Byte‑report-without-page-2.pdf, und report.pdf blieb unverändert.
  • Ein Deck für einen Stakeholder aufteilen: SplitPptx zieht die gewünschten Folien in eigene Dateien, benannt nach einem {0}‑Token im Ausgabemuster oder, falls kein Token vorhanden ist, mit einer angehängten Teil‑Nummer im selben Ordner – das gleiche Muster, das SplitPdf zum Aufteilen von PDF‑Seiten verwendet.
  • Word‑Dokumente statt PDFs zusammenführen: JoinDocx folgt exakt der Konstruktor‑dann‑Save‑Form von JoinPdf und fügt das anzuhängende Dokument nach der letzten Seite der Quelle ein.

Ohne Lizenz läuft jeder dieser Vorgänge im Evaluierungsmodus. In unserem eigenen, nicht lizenzierten Durchlauf wurden die zusammengeführten PDF‑ und Word‑Ausgaben auf jeweils 3 Seiten gekürzt, obwohl alle sechs Beispiel‑Outputs dennoch erzeugt wurden; setzen Sie eine Lizenz mit License.Set, bevor irgendeiner dieser Vorgänge unbeaufsichtigt in Produktion läuft.


Einstieg in Ihre Back‑Office‑Pipeline

Sie haben ein Low‑Code‑Dokument‑Merge‑Muster, das End‑zu‑End funktioniert, plus den Nachweis, dass die Format‑Prüfung bei jedem Aufruf läuft. So geht es weiter:

  • Das Gesamtbild sehen: der Begleit‑Anwendungsfall‑Leitfaden führt jede der sechs Operationen des Beispiels Methode für Methode durch, mit einer vollständigen FAQ.
  • Tiefer einsteigen, wenn ein Job wächst: die vollständige GroupDocs.Merger‑API deckt mehr ab, als dieses Muster benötigt, sobald eine Pipeline mehr als eine Operation verlangt.
  • Den Code durchsuchen: das komplette Beispiel auf GitHub enthält jede im Beispiel verwendete Eingabedatei.
  • Installieren: die Installations‑Seite behandelt das separate Paket und die unterstützten Ziel‑Frameworks.
  • Evaluierungs‑Limits entfernen: holen Sie sich eine temporäre Lizenz, bevor Sie irgendetwas in Produktion einsetzen.
  • Fragen: das Support‑Forum ist dort, wo das Team Implementierungs‑Fragen beantwortet.

Ressourcen