C# で Word 文書を差し込み印刷する

差し込み印刷は、受信者の名前や住所など特定の情報を除いて同一の文書セットを生成する最も簡単な方法です。多くの組織は、差し込み印刷を使用して、手紙、ニュースレター、販促資料などを通じて顧客や会員とコミュニケーションを取っています。そこでこの記事では、C# REST API を使用して Word 文書を差し込み印刷する方法について詳しく説明します。

メールマージAPI
C# を使用して差し込み印刷テンプレートを作成する
cURL コマンドを使用した Word の差し込み印刷

メールマージAPI

Aspose.Words Cloud には、新しい Word 文書を作成したり、既存の文書を開いたり、PDF、XPS、SVG、EPUB などのさまざまな形式に変換したりする機能があります。当社の API は REST アーキテクチャに従って開発されているため、言語やプラットフォームの制限を心配する必要はありません。C# .NET アプリケーションで API を使用するには、次のコマンドを使用して Aspose.Words Cloud SDK for .NET をインストールしてください。

 Install-Package Aspose.Words-Cloud

インストール後、GitHub または Google アカウントを使用して Aspose.Cloud ダッシュボードで無料アカウントを登録するか、サインアップしてクライアント資格情報を取得する必要があります。

C# で差し込み印刷テンプレートを作成する

データファイルを使用して差し込み印刷テンプレートを作成するには、以下の手順に従ってください。

String MyClientID = "c235e685-1aab-4cda-a95b-54afd63eb87f"; // Get MyClientID from https://dashboard.aspose.cloud/
String MyClientSecret = "b8da4ee37494f2ef8da3c727f3a0acb9"; // Get MyClientSecret from https://dashboard.aspose.cloud/

// 構成クラスのインスタンスを作成し、パーソナライズされたクライアントIDとクライアントシークレットの詳細を提供します。
var config = new Configuration { ClientId = MyClientID, ClientSecret = MyClientSecret };
// Configurationインスタンスを使用してWordsAPIオブジェクトを初期化する
var wordsApi = new WordsApi(config);
// 最初の入力文書
string inputDocument = "SampleMailMergeTemplate.docx";
string inputDataFile = "SampleMailMergeTemplateData.txt";
// 結果ファイルの名前
string resultantFile = "TestPostDocumentExecuteMailMerge.docx";
// データファイルの内容を読み取る
string data = File.ReadAllText("/Downloads/" + inputDataFile, System.Text.Encoding.UTF8);
// 入力ファイル、データファイル、および結果の出力の詳細を指定して、ExecuteMailMergeRequest オブジェクトを作成します。
Requests.ExecuteMailMergeRequest request = new Requests.ExecuteMailMergeRequest(inputDocument, data, null, null, null, null, null, null, null, null, resultantFile);
// 差し込み印刷操作を実行する
DocumentResponse result = wordsApi.ExecuteMailMerge(request);

cURL コマンドを使用した Word の差し込み印刷

cURL コマンドも REST API にアクセスする便利な方法です。Aspose.Words Cloud は REST API アーキテクチャに基づいて開発されているため、cURL コマンドを介して簡単に API にアクセスできます。前提条件として、クライアント ID とクライアントシークレットの詳細に基づいて JWT アクセストークンを生成する必要があります。

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=c235e685-1aab-4cda-a95b-54afd63eb87f&client_secret=b8da4ee37494f2ef8da3c727f3a0acb9" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

詳細については、クライアントIDとクライアントシークレットキーを使用してJWTトークンを取得する方法をご覧ください。

JWT アクセストークンを取得したら、次の cURL コマンドを使用して Mail Merge テンプレートにデータを入力できます。テキストファイルからデータを読み込みます。

ExecuteMailMerge APIが主な操作を実行します。
SampleMailMergeTemplate.docx は、クラウドストレージで利用できる入力メールマージテンプレートです。
-F パラメータを使用して、SampleMailMergeTemplateData.txt ファイルから入力データをアップロードします。
destFileName パラメータに対して指定された結果ファイルはクラウドストレージに保存されます。

curl -v "https://api.aspose.cloud/v4.0/words/SampleMailMergeTemplate.docx/MailMerge?withRegions=false&destFileName=TestPostDocumentExecuteMailMerge.docx" \
-X PUT  \
-F data=@/Downloads/SampleMailMergeTemplateData.txt \
-H "Content-Type: multipart/form-data" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>"

差し込み印刷プレビュー — 画像 1: 差し込み印刷操作後のドキュメントのプレビュー。

上記の例のサンプルファイルは、次のリンクから入手できます。

結論

この記事では、C# コードスニペットを使用して Word 文書で差し込み印刷を実行する方法について詳しく説明しました。同時に、cURL コマンドを使用した差し込み印刷の手順も学習しました。当社の SDK は MIT ライセンスに従って構築されているため、完全なソースコードは GitHub リポジトリからダウンロードできます。製品ドキュメントを参照して、API でサポートされている他の興味深い機能について学習することをお勧めします。

詳細については、次のリンクにアクセスすることをお勧めします。

メールマージAPI#

C# で差し込み印刷テンプレートを作成する#

cURL コマンドを使用した Word の差し込み印刷#

結論#

関連記事#

メールマージAPI

C# で差し込み印刷テンプレートを作成する

cURL コマンドを使用した Word の差し込み印刷

結論

関連記事