Verschachtelt Mail Merge mit Regionen
In einigen Szenarien müssen Sie möglicherweise verschachtelte Mail Merge mit Regionen verwenden. Verschachtelter Seriendruck ist eine Funktion, mit der Sie hierarchische Daten aus Ihrer Datenquelle in Ihre Seriendruckvorlage zusammenführen können, um Ihr Dokument einfach zu füllen. Grundsätzlich werden die hierarchischen Daten als Satz von Datenelementen dargestellt, und hierarchische Beziehungen beschreiben, wie die Datenelemente miteinander in Beziehung stehen (ein Datenelement ist das übergeordnete Element eines anderen).
Mit Aspose.Words können Sie eine Mail Merge-Operation mit verschachtelten Bereichen ausführen. Sie können diese Funktion verwenden, wenn Sie über eine Datenquelle verfügen, die in einer baumartigen Struktur organisiert ist, und Sie eine Mail Merge-Operation ausführen möchten, um eine Vorlage mit hierarchischen Daten zu füllen.
Was ist eine verschachtelte Mail Merge
Die Mail Merge -Region wird als verschachtelt bezeichnet, wenn Sie zwei oder mehr Mail Merge -Regionen haben, von denen sich eine in hierarchischer Form in der anderen befindet. Beachten Sie, dass jede Region Daten aus einer Tabelle enthält.
Das häufigste Beispiel für eine verschachtelte Mail Merge ist eine Bestellung, die mehrere Elemente enthält, bei der Sie mehrere Datentabellen verknüpfen und die Informationen in einer Vorlage darstellen müssen.
Das Bild unten zeigt zwei verschachtelte Regionen, in denen die Region Order Mail Merge die übergeordnete Region der Region Item Mail Merge ist.
So verarbeiten Sie Mail Merge mit verschachtelten Regionen
Die Daten, die zu einer Vorlage zusammengeführt werden sollen, können aus verschiedenen Quellen stammen, hauptsächlich relationalen Datenbanken oder XML Dokumenten. In unserem Beispiel werden wir eine XML -Datei verwenden, um unsere Daten zu speichern und direkt in die DataSet zu laden.
Aspose.Words ermöglicht die Verarbeitung von Mail Merge mit verschachtelten Regionen unter Verwendung der in DataSet angegebenen Datenbeziehungen. Wenn das DataSet -Objekt XML lädt, verwendet es entweder das bereitgestellte Schema oder leitet es aus der Struktur von XML selbst ab, um dies zu erreichen. Aus dieser Struktur werden bei Bedarf Beziehungen zwischen Tabellen erstellt.
Die folgende Abbildung zeigt, wie die Daten aus der Order-Tabelle, die an die verschachtelten Zusammenführungsbereiche übergeben wurden, mit der Item-Tabelle verknüpft werden, sowie die während des Zusammenführungsvorgangs generierte Ausgabe.
Wie Sie dem Ausgabedokument entnehmen können, wird jeder Auftrag aus der Tabelle Order mit allen auftragsbezogenen Artikeln aus der Tabelle Item in die Seriendruckvorlage eingefügt. Die nächste Bestellung wird zusammen mit ihren Artikeln eingefügt, bis alle Bestellungen und Artikel aufgelistet sind. Die Reihenfolge der Verschachtelung von Mail Merge mit Regionen in der Vorlage muss mit den Datenbeziehungen zwischen den Tabellen in der Datenquelle übereinstimmen.
Das folgende Codebeispiel zeigt, wie Sie eine Rechnung mit verschachtelten Mail Merge mit Regionen generieren:
Sie können die Beispieldatei dieses Beispiels herunterladen von Aspose.Words GitHub.
Sie können die Implementierung der manuellen Einrichtung der Datenbeziehungen überprüfen von Aspose.Words Github.
So richten Sie Datenbeziehungen in verschachtelten Mail Merge mit Regionen ein
Sie müssen alle Datenbeziehungen in der Eltern-Kind-Struktur einrichten, um die verschachtelten Mail Merge mit Regionen korrekt auszuführen. Das Überspringen dieses wichtigen Schritts kann zu einem Fehler bei der Ausführung der verschachtelten Mail Merge mit Regionen führen.
Beim Abrufen von Daten für eine verschachtelte Mail Merge aus einer XML-Datei mit der ReadXml-Methode werden automatisch Beziehungen gemäß der Struktur des XML-Dokuments erstellt. Sie müssen jedoch sicherstellen, dass korrekte Beziehungen erstellt wurden.
Wenn Mail Merge nicht wie erwartet funktioniert, müssen Sie möglicherweise Ihre XML -Datei neu strukturieren oder explizit Beziehungen zwischen DataTable -Objekten in DataSet erstellen.
Ein DataSet mit verwandten Datentabellen verwendet das DataRelation -Objekt, um die Eltern-Kind-Beziehung zwischen den Tabellen darzustellen.
Das folgende Codebeispiel zeigt, wie Sie mithilfe eines DataRelation-Objekts eine DataRelation zwischen der Tabelle eines Kunden und der Tabelle einer Bestellung einrichten:
So erstellen Sie Datenbeziehungen aus einer benutzerdefinierten Datenquelle
Implementieren Sie die Schnittstelle IMailMergeDataSource, um Beziehungen in der Eltern-Kind-Struktur Ihrer benutzerdefinierten Datenquelle zu erstellen. Verwenden Sie die Methode GetChildDataSource, um die relevanten untergeordneten Daten eines aktuellen übergeordneten Datensatzes zurückzugeben.
Das folgende Beispiel zeigt, wie Datenbeziehungen mit GetChildDataSource erstellt werden: