💡 GitHub で利用できる完全な動作例: one-line-document-merge-and-split-dotnet

バックオフィスの文書ジョブが実際に存在する場所

財務バックオフィスは、前月のステートメント PDF に表紙ページをホチキスで留めて月末を締めくくります。契約チームは、原本の契約書に署名済みの修正条項を追加し、アーカイブに送る前に結合します。営業オペレーションのアシスタントは、60枚のスライドデッキから2枚のスライドを抜き出します。これは、あるステークホルダーが価格ページだけを必要としていたためです。レコード係は、ファイルが建物を出る直前に、決して出荷すべきでなかったページを削除します。

これらはマージプロジェクトではありません。各々は1つのファイルと1つの操作で、ジョブが実行されるたびに同じ方法で行われ、通常、そこにたどり着くために汎用文書 API を学ぶことに興味のない人が実行します。

GroupDocs.Merger.LowCode は、.NET パッケージで、結合、分割、ページ削除といったジョブを単一のコンストラクタ呼び出しに変換し、これらのジョブが決して必要としない汎用の Merger クラスとは別物です。その7つの製品はすべて、ソースとオプションをコンストラクタで受け取り、C# で記述され、Save が呼び出されたときにのみ実行されます。ジョブが PDF、Word 文書、PowerPoint デッキのいずれであっても同じ形です。

ここで汎用的な修正が通用しない理由

これらのジョブに直面するチームは、特化したパッケージに手を出す前に通常、次の3つのうちの1つを試みます。

  • デスクトップエディタで手作業で行う:1つの文書には問題ありませんが、スケジュール化は不可能で、深夜2時に手動ステップが実行されることに承認を得る人はいません。
  • 生のファイル API に対してワンオフのスクリプトを書く:次の入力フォーマットが現れるまで機能しますが、スクリプトは回避しようとしていた汎用クライアントそのものに成長してしまいます。
  • 単一呼び出しのためにフル Merger クラスを使用する:正しいですが、1つの操作が必要とする以上に広い API を追加してしまいます。

GroupDocs.Merger.LowCode はまさにその最後のギャップを埋めるために存在します:操作ごとに1回の呼び出しで、最初に学ぶべきことは何もありません。


解決策:バックオフィスパイプライン向け GroupDocs.Merger.LowCode

GroupDocs.Merger.LowCode は、1つのコンストラクタ‑Save 形状の背後に、7つの単一目的製品をパッケージ化します。JoinPdf と JoinDocx は文書を別の文書に追加します;JoinPptx はデッキに対して同様に動作します;SplitPdf、SplitDocx、SplitPptx は選択されたページやスライドをそれぞれのファイルに抽出します;RemovePagesPdf はソースに触れずにページを削除します。7つの製品すべてがソースをパスまたはストリームとして受け取り、書き込む前にそのソースと与えられたすべてのファイルが自分のフォーマットに合致しているかチェックするため、パイプラインが出力がなぜ間違っているのか推測する必要はありません。

以下の実装をたどるには、次が必要です:

  • .NET 6.0 以降(このサンプルのプロジェクトは net8.0 を対象)
  • 別の GroupDocs.Merger.LowCode NuGet パッケージ
  • 一時ライセンス(評価制限なしで出力を確認したい場合)
dotnet add package GroupDocs.Merger.LowCode

このパッケージは、メインの GroupDocs.Merger ライブラリとは別に NuGet にあります。


Reporting-Pack ジョブのステップバイステップ実装

以下は、7つの製品すべてが従う形状で、月次 PDF に表紙ページを追加する結合を例に説明します。

ステップ 1: 製品にソースを指定する

JoinPdf のコンストラクタは、ソース文書、追加するすべてのファイル、そして JoinOptions インスタンスを受け取ります;まだ何も実行されません。

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

ステップ 2: 結果の出力先を決める

Save(outputPath) がジョブを実際にコミットする場所です。相対パスはプロセスの現在の作業ディレクトリに対して解決され、Save は出力フォルダーが存在しない場合に作成します。そのため、毎回新しい月のフォルダーに書き込むパイプラインは、フォルダーを事前に用意する別ステップを必要としません。

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

無人ジョブにとって重要な理由:

  • 制御できるパス:出力パスは設定やジョブパラメータから構築し、検証されていない入力から直接取得しないでください;Save は null または空のパスで ArgumentNullException をスローします。
  • 作成されるフォルダー:毎回新しい宛先に書き込むスケジュールジョブは、独自の「ディレクトリが存在することを保証」ステップを持ちません。

ステップ 3: 実行して戻り値を取得する

Save を呼び出すと結合が即座に実行されます;ビルドしてから実行する別ステップはありません。

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

サンプルのファイルで実行した結果、2ページの report.pdf と 2ページの appendix.pdf が結合され、4ページ、257987 バイトの report-with-appendix.pdf が生成されました。

ステップ 4: 結果をパイプラインに戻す

Save の直後に読み取ったファイルサイズは、ジョブ完了をマークする前、または出力が十分に信頼できるかを判断するために最小サイズと比較する前に、スケジューラが通常必要とするすべてです。

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

GroupDocs.Merger.LowCode はファイルパスの代わりにストリームを受け入れますか?

はい、入力側では可能です。7つの製品すべてが、ファイルパスが入るのと同じコンストラクタ位置でストリームとしてソースを受け取ります。これは、ジョブの入力がローカルディスクではなく BLOB ストレージやキューから来る場合に便利です。Save は結果を出力パス文字列に書き込みますが、出力自体をストリーミングする場合はフル Merger クラスを使用します。

実際のワークフロー:アーカイブに到達する前にファイルを拒否する

契約チームが署名済み契約書に修正条項を追加する際、受信トレイに入ってくる任意のファイルを受け入れるリスクは取れません。.docx の修正が PDF 結合の隣に誤って配置されると、破損したアーカイブエントリが生成されます。JoinPdf は書き込む前にソースと追加されるすべてのファイルが PDF フォーマットに合致しているかチェックし、合致しない場合は直ちに FileTypeNotSupportedException をスローします。

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

サンプル実行では、パスは resources フォルダーから構築され、メッセージは次のようになります:Input format does not match the expected format 'PDF'; the joined file 'resources\contract.docx' is 'Microsoft Word Open XML Document (.docx)'。

上記のジョブは例外が捕捉されたときに output/mixed.pdf を書き込むことはありません。そのため、契約パイプラインはこのメッセージを既存のアラートやチケットキューに直接送ることができ、数日後に壊れたアーカイブエントリを発見することを防げます。

このパターンが適合する他のバックオフィスシナリオ

上記の結合が機能すれば、同じコンストラクタ‑Save 形状でバックオフィスがスケジュールで実行する複数のジョブをカバーできます:

  • 文書が建物を出る前にページをトリミングする:RemovePagesPdf は選択されたページを削除し、ソースに触れずに新しいファイルを書き出すため、トリミングされたコピーが出荷された後も元のファイルは監査用に利用可能です。私たちの実行では、report.pdf のページ 2 を削除すると、1ページ、86647 バイトの report-without-page-2.pdf が生成され、report.pdf 自体は変更されませんでした。
  • 1人のステークホルダー向けにデッキを分割する:SplitPptx は要求されたスライドをそれぞれのファイルに抽出し、出力パターンの {0} トークンで名前付けするか、トークンがない場合は同じフォルダー内で付加されたパート番号で名前付けします。これは PDF ページを分割する際に SplitPdf が使用するのと同じパターンです。
  • PDF の代わりに Word 文書を結合する:JoinDocx は JoinPdf と同様のコンストラクタ‑Save 形状に従い、追加された文書をソースの最終ページの後に配置します。

ライセンスがない場合、これらはすべて評価モードで実行されます。私たちの無許可実行では、結合された PDF と Word の出力はそれぞれ 3 ページに削減されましたが、6つのサンプル出力はすべて生成されました。プロダクションで無人実行する前に License.Set でライセンスを適用してください。

バックオフィスパイプラインでの開始方法

エンドツーエンドで機能するローコード文書結合パターンが1つあり、背後のフォーマットチェックがすべての呼び出しで実行されることが証明されています。次に進むべき場所は以下です:

  • 全体像を見る:同伴のユースケースガイドは、サンプルの6つの操作を手順ごとに解説し、完全なFAQを提供します。
  • ジョブが拡大したらさらに深掘り: 完全な GroupDocs.Merger API は、パイプラインが1つの操作を超えて拡大した瞬間に、このパターンが必要とする以上の領域をカバーします。
  • コードを閲覧: GitHub の完全サンプル には、上記で使用されたすべての入力ファイルが含まれています。
  • インストール: インストールページ では、別パッケージとサポートされているターゲットフレームワークについて説明しています。
  • 評価制限を解除:本番で実行する前に 一時ライセンス を取得してください。
  • 質問: サポートフォーラム は、チームが実装に関する質問に回答する場所です。

リソース