ページビルダー機能は、異なる文書からページを正確かつ簡単にシームレスに結合できるようにすることで、文書のマージを変革します。最終文書の構造に対して完全な制御を提供し、任意の順序でページをマージすることを可能にします。重要なページをいくつかマージする場合でも、包括的な文書を作成する場合でも、このツールは柔軟性と効率性を確保します。手作業の努力を削減することで、カスタマイズされた文書を作成するプロセスを簡素化し、貴重な時間を節約し、個人およびプロフェッショナルのワークフロー全体で生産性を向上させます。
以下のトピックがここで議論されています:
If you are interested in ドキュメントをオンラインで結合する, visit the オンライン結合ツール that is powered by GroupDocs.
ページビルダーの理解
Page Builder 機能は、複数のソースドキュメントからページを組み合わせることでカスタムドキュメントを作成するための簡素化された方法を提供します。この機能により、開発者は2つ以上のドキュメントから任意の順序でページを追加しながら、新しいドキュメントを段階的に構築できます。プロセスは次のように機能します：
- ソース Word ドキュメントを Merger クラスを使用してロードし、コンストラクタにソース ドキュメントの 1 つを渡します。
- ドキュメントを1つずつ結合して@Joinメソッドを使用してマージします。
- Page Builderを初期化します。MergerインスタンスからのメソッドCreatePageBuilderを使用します。これは、新しいドキュメントを構築するための出発点となります。
- The AddPage method of the Page Builder instance allows to add into the destination document any particular page of joined documents previously
- 各ソースドキュメントについて、インデックスに含めたい特定のページを選択してください。
- これらのページを新しい文書に希望の順序で追加してください。必要に応じて、異なる文書からページを組み合わせて使用することができます；
- このプロセスを追加のソースドキュメントに対して繰り返し、要件に最も適した方法でページを結合できる柔軟性を持っていることを確認してください;
- ApplyPageBuilder メソッドを使用して、ページビルダーインスタンスからの変更を適用します。
- マージされた文書を任意の場所に保存します。すべての必要なページが追加されたら、新しい文書を保存します。最終的な出力は、複数のソースからのページを完全にカスタマイズされたファイルとして、あなたが望む方法で整理されたものになります。
この段階的アプローチにより、レポートの編纂、パーソナライズされたプレゼンテーションの作成、または法的文書の組み立てなど、特定のユースケースに合わせたドキュメントを簡単に作成できます。Page Builderを使用することで、開発者はページの順序とコンテンツを完全に制御でき、時間のかかる手動編集が不要になり、最終出力の精度が確保されます。
サンプルケースとコード実装
GroupDocs.Mergerのページビルダ機能を実際の例を用いて説明しましょう。ケースを簡略化するために、私たちに2つの文書があると仮定します：
- Document A with 4 pages.
- Document B with 4 pages.
私たちは、特定のシナリオに基づいて、これらの2つの文書のページを異なる順序で統合することで新しい文書を作成することを目指しています。
ここでは各文書ページに文書の文字 A、B とページ番号でマークを付けました。文書 A と B から、次の構造を持つカスタマイズされた文書 C を受け取る必要があります。
以下のソースコードスニペットは、結果のドキュメントに複数のドキュメントから特定のページをマージする方法を示しています。
string documentA = @"documentA.pdf";
string documentB = @"documentB.pdf";
string documentC = @"documentC.pdf";
using (Merger merger = new Merger(documentA))
{
merger.Join(documentB);
PageBuilder pageBuilder = merger.CreatePageBuilder();
// get documents A and B references
var docA = pageBuilder.Documents[0];
var docB = pageBuilder.Documents[1];
pageBuilder.AddPage(docA.Pages[0]); // document A, page 1 or Page A-1
pageBuilder.AddPage(docB.Pages[0]); // document B, page 1 or Page B-1
pageBuilder.AddPage(docB.Pages[1]); // document B, page 2 or Page B-2
pageBuilder.AddPage(docB.Pages[2]); // document B, page 3 or Page B-3
pageBuilder.AddPage(docA.Pages[1]); // document A, page 2 or Page A-2
pageBuilder.AddPage(docA.Pages[3]); // document A, page 4 or Page A-4
// Apply the page order
merger.ApplyPageBuilder(pageBuilder);
merger.Save(documentC);
}
必要なページの範囲を指定する
ドキュメント操作に取り組む際、複雑なワークフローを扱うためには、効率的に複数のページを追加することが重要です。ページを個別に追加する代わりに、AddPageRange メソッドを使用できます。このメソッドは、特定のページを表す IPageInfo オブジェクトの配列を受け入れます。このアプローチはプロセスを簡素化し、繰り返しのコードを減らし、バッチ処理を可能にすることによってパフォーマンスを向上させます。以下は、このメソッドを利用して異なるドキュメントから複数のページを一度に追加する方法を示すコードの例です。
ここでは、範囲として指定されたさまざまな文書から複数のページを結合する手順を説明します:
- Merger オブジェクトを作成し、ソースファイルのパスまたはストリームを提供してください。
- Join を使用して、別のソースドキュメントを追加します。マージしたい各ドキュメントについてこの手順を繰り返します。
- PageBuilder オブジェクトを CreatePageBuilder メソッドを呼び出して作成します。
- AddPageRange メソッドを呼び出し、適切なページを説明する IPageInfo オブジェクトの配列を渡してください。 IPageInfo オブジェクトは、ソースドキュメントおよびページ番号に対してゼロベースの表記を使用することに注意してください。
- 指定されたページの順序をマージされたドキュメントに適用するには、 ApplyPageBuilder メソッドを使用してください。
- 結果のドキュメントをSaveメソッドを呼び出してファイルパスを指定することで保存してください。
string documentA = @"documentA.pdf";
string documentB = @"documentB.pdf";
string documentC = @"documentC.pdf";
using (Merger merger = new Merger(documentA))
{
merger.Join(documentB);
PageBuilder pageBuilder = merger.CreatePageBuilder();
// get documents A and B references
var docA = pageBuilder.Documents[0];
var docB = pageBuilder.Documents[1];
// Specify a range of pages
IPageInfo[] range = new IPageInfo[] {
docA.Pages[0], // Page A-1 from the document A
docB.Pages[0], // Page B-1 from the document B
docB.Pages[1], // Page B-2 from the document B
docB.Pages[2], // Page B-3 from the document B
docA.Pages[1], // Page A-2 from the document A
docA.Pages[3], // Page A-4 from the document A
};
// Append a page of pages
pageBuilder.AddPageRange(range);
// Apply the page order
merger.ApplyPageBuilder(pageBuilder);
merger.Save(documentC);
}
結論
これらの例は、ページビルダー機能の多様性を示しています。開発者は、様々なシーケンスで複数のドキュメントからページを簡単に組み合わせて、カスタマイズされた出力を作成できます。この機能は手作業を大幅に削減し、ドキュメント生成の精度を確保するため、多様なユースケースにとって不可欠なツールとなっています。
無料のAPIライセンスを取得する
You can get a free temporary license を取得して、評価の制限なくAPIを使用できます。
独自のマージページビルダーアプリケーションを構築する
ここに自分の文書比較アプリケーションを構築するのに役立ついくつかの重要なリンクがあります。
Documentation | API Reference | Supported File Formats
Running Examples – GitHub | Free Support Forum | Release Notes
See Also
詳細情報および追加リソースについては、以下のリンクが役立つかもしれません：