高度なMail Merge機能

Aspose.Wordsは、単純なMail MergeまたはMail MergeリージョンでMail Mergeプロセスのさらなるカスタマイズを実行できるようにする追加のMail Mergeプロパティとメソッドを提供します。

高度なMail Merge機能には、Mail Merge操作を実行する前のテンプレート構造に関する情報の取得、Mail Merge操作のルールの設定、およびMail Merge操作中のクリーンアップが含まれますが、これ この記事では、高度な機能を使用する方法を示すために、いくつかのプロパティと例のみをカバーします。

Mail Merge操作のルールの設定

テンプレートにルールを追加すると、ワークフロープロセスをより効果的かつ柔軟にすることができます。 Mail Mergeルールを使用すると、すばやく変更できるコンテンツを設定し、複数のドキュメントを生成する必要がなくなります。

Aspose.Wordsを使用すると、Mail Merge操作を実行してマージ情報を制御するときに実行されるルールに基づいてMail Mergeをカスタマイズできます。 たとえば、すべての顧客に送信する電子メールまたは手紙を作成する場合です。 データソースの特定のフィールドのさまざまな値に基づいて、文字にさまざまなデータを含めることができるようにルールを設定できます。

実装できるいくつかのMail Mergeルールを見てください。

現在の文書内のデータレコードをマージする次のフィールドを実装する

Nextフィールドを実装すると、新しいマージされたドキュメントを開始する代わりに、次のデータレコードを現在の結果のマージされたドキュメントにマー これは、1つの文書に複数のレコードを表示するために使用されます。

NextIfフィールドとSkipIfフィールドを実装して、二つの式を比較します

2つの式（right式とleft式）をいくつかのoperatorで比較する場合は、NextIfフィールドまたはSkipIfフィールドのいずれかを使用できます。

NextIf

Field Name	Comparison Result “True”	Comparison Result “False”
NextIf	Aspose.Wordsは次のデータレコードを現在のマージ文書にマージし、テンプレート内のNextIfフィールドの後にあるすべての差し込み項目は、現在のデータレコードではなく次のデータレコードの値に置き換えられます。	Aspose.Wordsは次のデータレコードを新しいマージ文書にマージします。
SkipIf	Aspose.Wordsは現在のマージ文書をキャンセルし、データソース内の次のデータレコードに移動し、新しいマージ文書を開始します。	Aspose.Wordsは現在のマージ文書を続行します。

次のコード例は、2つの式をNextIfまたはSkipIfと比較する方法を示しています:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Use NextIf field. A NEXTIF field has the same function as a NEXT field,
// but it skips to the next row only if a statement constructed by the following 3 properties is true.
FieldNextIf fieldNextIf = (FieldNextIf)builder.InsertField(FieldType.FieldNextIf, true);

// Or use SkipIf field.
FieldSkipIf fieldSkipIf = (FieldSkipIf)builder.InsertField(FieldType.FieldSkipIf, true);
            
fieldNextIf.LeftExpression = "5";
fieldNextIf.RightExpression = "2 + 3";
fieldNextIf.ComparisonOperator = "=";

doc.Save(ArtifactsDir + "WorkingWithFields.FieldNext.docx");

テンプレート構造に関する情報の取得

Aspose.Wordsを使用すると、多くの方法でテンプレート内のさまざまな情報を収集できます。 たとえば、テンプレート内の一部の差し込み項目の名前やリージョンの階層を取得する必要がある場合があります。 ここでは、テンプレートから特定の情報を取得するための可能なバリアントについて説明します。

差し込み項目名の取得

他のユーザーによって作成された差し込み項目とデータをマージするシナリオに遭遇する可能性がありますが、この場合、差し込み項目の正確な名前がわ したがって、Mail Mergeの目的を達成するには、まず、すべての差し込み項目の名前を読み取って表示する必要があります。 Aspose.Wordsを使用すると、GetFieldNamesメソッドを使用して差し込み項目名のコレクションを取得できます。

次のコード例は、テンプレート内のすべての差し込み項目の名前を取得する方法を示しています:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document();

string[] fieldNames = doc.MailMerge.GetFieldNames();

マージ領域に関する情報の取得

指定されたマージ領域を通じてテンプレートがどのように構造化されているかを理解するシナリオがある場合があります。 いくつかのメソッドを使用して、マージ領域に関する必要な情報をすべて収集したり、テンプレート内のマージ領域階層を取得したりすることができます。GetRegionsHierarchyメソッドなどがあります。 MailMergeRegionInfoクラスのプロパティとメソッドを使用できます。次のコード例は、マージ領域階層を取得する方法を示しています:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
MailMergeRegionInfo regionInfo = doc.MailMerge.GetRegionsHierarchy();

次のコード例は、名前に基づいてテンプレート内の特定のマージ領域を取得する方法を示しています:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document(MyDir + "Mail merge regions.docx");

MailMergeRegionInfo regionInfo = doc.MailMerge.GetRegionsHierarchy();

IList<MailMergeRegionInfo> regions = doc.MailMerge.GetRegionsByName("Region1");
Assert.AreEqual(1, doc.MailMerge.GetRegionsByName("Region1").Count);
foreach (MailMergeRegionInfo region in regions) Assert.AreEqual("Region1", region.Name);

regions = doc.MailMerge.GetRegionsByName("Region2");
Assert.AreEqual(1, doc.MailMerge.GetRegionsByName("Region2").Count);
foreach (MailMergeRegionInfo region in regions) Assert.AreEqual("Region2", region.Name);

regions = doc.MailMerge.GetRegionsByName("NestedRegion1");
Assert.AreEqual(2, doc.MailMerge.GetRegionsByName("NestedRegion1").Count);
foreach (MailMergeRegionInfo region in regions) Assert.AreEqual("NestedRegion1", region.Name);

この例のサンプルファイルは、次の場所からダウンロードできます Aspose.Words GitHub.

マップされたフィールドの追加

Aspose.Wordsを使用すると、MappedDataFieldsプロパティを使用して、データソース内のフィールドの名前とテンプレート内のMail Mergeフィールドの名前を自動的にマップできます。 たとえば、テンプレートに"姓"というフィールド名があり、データソースに"姓"というフィールド名または"Last_Name"や"LastName"などの別のバリエーションがある場合、データソースのフィー マージテンプレートを多数のデータソースとマージする場合、マップされたフィールドは、データベース内のフィールド名と一致するようにフィールドをテンプレートに再

テンプレート内の差し込み項目とデータソース内のデータ項目の名前が異なる場合に、Addメソッドを使用してマップされた項目を追加する方法を次のコード:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document();

doc.MailMerge.MappedDataFields.Add("MyFieldName_InDocument", "MyFieldName_InDataSource");