Mail Merge mit Regionen

Sie können in Ihrer Vorlage verschiedene Regionen erstellen, um spezielle Bereiche zu haben, die Sie einfach mit Ihren Daten füllen können. Verwenden Sie mail merge mit Regionen, wenn Sie Tabellen und Zeilen mit sich wiederholenden Daten einfügen möchten, damit Ihre Dokumente dynamisch wachsen, indem Sie diese Regionen in Ihrer Vorlage angeben.

Sie können sowohl verschachtelte (untergeordnete) Regionen erstellen als auch Regionen zusammenführen. Der Hauptvorteil der Verwendung dieses Typs besteht darin, Teile innerhalb eines Dokuments dynamisch zu vergrößern. Weitere Details finden Sie im nächsten Artikel “Verschachtelte Mail Merge mit Regionen”.

Informationen zu einer mail merge -Region können mit der MailMergeRegionInfo -Klasse abgerufen werden.

So führen Sie Mail Merge mit Regionen aus

Ein mail merge -Bereich ist ein bestimmter Teil in einem Dokument, der einen Start- und einen Endpunkt hat. Beide Punkte werden als mail merge -Felder dargestellt, die bestimmte Namen “TableStart:XXX” und “TableEnd:XXX” haben. Alle Inhalte, die in einer mail merge-Region enthalten sind, werden automatisch für jeden Datensatz in der Datenquelle wiederholt.

Aspose.Words ermöglicht die Ausführung von mail merge mit Regionen unter Verwendung einer der ExecuteWithRegions-Methoden, die eine benutzerdefinierte IMailMergeDataSource-Datenquelle akzeptieren.

Das folgende Codebeispiel zeigt, wie mail merge mit Regionen aus der SQLite-Datenbank ausgeführt wird mit SQLiteCpp:

Sie können den Unterschied zwischen dem Dokument feststellen, bevor Sie mail merge mit Regionen ausführen:

Und nach dem Ausführen von mail merge mit Regionen:

Einschränkungen von Mail Merge mit Regionen

Es gibt einige wichtige Punkte, die Sie beachten müssen, wenn Sie eine mail merge mit Regionen durchführen:

• Der Startpunkt TableStart:Orders und der Endpunkt TableEnd:Orders müssen sich beide in derselben Zeile oder Zelle befinden. Wenn Sie beispielsweise einen Zusammenführungsbereich in einer Zelle einer Tabelle beginnen, müssen Sie den Zusammenführungsbereich in derselben Zeile wie die erste Zelle beenden. Der Name des Seriendruckfelds muss mit dem Spaltennamen in Ihrem DataTable übereinstimmen. Sofern Sie keine zugeordneten Felder angeben, ist mail merge mit Regionen für Seriendruckfelder mit einem anderen Namen als dem Spaltennamen nicht erfolgreich.
• Aspose.Words für C++ unterstützt nur IMailMergeDataSource- und IMailMergeDataSourceRoot-basierte Datenquellen. Im Gegensatz zu .NET und Java verfügt C++ nicht über eine allgemein akzeptierte plattformübergreifende API für die Arbeit mit Datenbanken (wie ADODB, ODBC oder JDBC). Um mit einer bestimmten Datenquelle zu arbeiten, müssen Sie die Schnittstelle IMailMergeDataSource oder IMailMergeDataSourceRoot implementieren.

Wenn eine dieser Regeln verletzt wird, erhalten Sie unerwartete Ergebnisse oder es wird möglicherweise eine Ausnahme ausgelöst.

Wenn Sie keine mail merge -Regionen verwenden, ähnelt dies Microsoft Word mail merge, und der gesamte Dokumentinhalt wird für jeden Datensatz in der Datenquelle wiederholt.