Aspose.Words マージメール for .NET

Aspose.Words Mail Merge for .NET プラグイン」は、開発者が単一のテンプレートを定義し、ダイナミックなデータを収集することによって、メール、請求書、ディレクトリ、レポートなどのカスタマイズされたドキュメントを生成することを可能にします.

インストール&セットアップ

  • パッケージマネージャーコンソールまたは NuGet を通じて Aspose.Words for .NET をインストールします. ( インストールガイド )
  • メール関連作業を実行する前に ** 測定ライセンス** を設定します. ( メータードライセンス )
  • あなたのプロジェクトに参照する Aspose.Words.dll.

互換性 Windows、Linux、macOS、およびモバイルプラットフォーム .NET Framework、NET Core、またはMono を使用します.

キー機能と機能

テンプレートベースのドキュメント世代

  • テンプレートを作成する ** DOCX、DOC、RTF、またはHTML**.
  • 入力 ** 混合フィールド** (例えば., «FieldName») ダイナミックなデータプレーヤーを代表する.
  • テンプレートを複数の使用ケースで再利用可能かつ維持可能に保つ.

フィールドレベルのデータ人口

  • 人気の合併フィールドは テキスト、画像、バーコード、またはフォーマットされたコンテンツ.
  • コントロール番号、ボール、およびスタイルは、組み合わせたコンテンツが企業のデザインと一致するようにします.

地下地域と条件付き地域

  • 各データ記録のテーブル、リスト、または段落を 地域 を使用して繰り返します.
  • 条件区域を使用して、セクションをダイナミックに含/排除する(例えば、必要に応じて送料アドレスのみを表示する).

データソース接続

  • 関連する ADO.NET に合致するソース など DataTable, DataReader, DataSet, レイアウト、またはカスタムオブジェクト.
  • Implement IMailMergeDataSource データクローゼットの完全なコントロール.
  • 階級データソースと親子が簡単に合併します.

カスタムイベント処理

  • イベントのような行動 MergeField, MergeImageField, そして MergeRegion.
  • 変換を適用する(例えば、フォーマットの日付、QRコードを生成する、またはダイナミックに位置所有者を置き換える).

パフォーマンスとスケール性

  • 大規模、高容量の合併に最適化.
  • ストリームの結果はディスクまたはHTTP回答に直接流れ、メモリの使用量を最小限にします.
  • バッチ処理、分割フィールド評価、および地域再利用はパスポートを向上させます.

場所化と国際化

  • 多言語レポートを生成し、ローカル値を結びつける.
  • 数字、通貨、日付のための 文化特定のフォーマット を適用します.
  • 右向きの言語と適切な暗号化処理をサポートします.

互換性とフォーマットサポート

  • すべての主要な Word フォーマット( **DOCX, DOC, RTF, HTML ** )をサポートし、Aspose.Words 変換 API を通じて PDF またはその他の形式にエクスポートします.
  • プロセス後の結果は、標準的な Aspose.Words 機能と組み合わせた: デジタルサイン、圧縮、ハイフェナーション 、およびその他.

Mail Merge を使用してレポートを作成する方法 

// Load template
doc = new Document("InvoiceTemplate.docx");

// Example DataTable as data source
DataTable orders = new DataTable("Orders");
orders.Columns.Add("CustomerName");
orders.Columns.Add("Item");
orders.Columns.Add("Quantity");
orders.Rows.Add("John Doe", "Laptop", "1");
orders.Rows.Add("Jane Smith", "Phone", "2");

// Execute Mail Merge
doc.MailMerge.ExecuteWithRegions(orders);

// Save the result
doc.Save("InvoiceReport.docx");

一般的な使用例

  • Bulk Letters & Emails :自動化された配信.
  • 請求書&受付 :顧客および取引データを会計テンプレートに組み込む.
  • レポート :グループまたは条件データを含む構造化された報告を生成します.
  • Labels & Envelopes : 郵便準備の資産を大量に作成します.
  • ディレクトリ&カタログ :構造化された文書に階層または表データを組み合わせる.

ヒントと最良の実践

  • メンテナンスを向上させるために合併フィールドのための clear naming conventions を使用します.
  • 深く浸透した地域を最小限に抑える - 可能な限りフラットデータ.
  • 一貫性を確保するために、テンプレートで形式化とスタイルを設定します.
  • 実行前にデータソースを確認して、起動時間のエラーを防ぐ.
  • イベントマネージャー を使用して、画像組み込むか条件形式化などのカスタマイズされた論理に使用します.
  • ストリームはメモリの代わりに ディスクまたはネットワークストレーム に大きな合併します.
  • バージョンコントロールテンプレートとサンプルデータで定期的にテストします.
  • ログは、監査およびパフォーマンス監視のための進歩とエラーを合併します.

よくある質問

**NET の Mail Merge とは何ですか?**データベースやコレクションなどのデータソースによって人口化された合併フィールドを持つテンプレートからカスタマイズされた文書を生成するための枠組みです.

どのようなデータ源がサポートされていますか?DataTable, DataSet, IDataReader, オリジナルタイトル: Array, and custom objects via IMailMergeDataSource.

**これは、 hierarchical データで動作していますか?**ノースの地域は、親子のデータ構造を融合させることができます.

**画像はダイナミックに挿入できますか?**はい 使用 MergeImageField イメージを注入するイベント(例えば、プロフィール画像、QRコード).

**大規模合併をサポートしていますか?**高容量バッチ処理に最適化され、メモリ足跡が低い.

**どのフォーマットがサポートされていますか?**すべての主要な Word フォーマット ( **DOCX, DOC, RTF, HTML ** ) に輸出して PDF など.

 日本語