Erweiterte Mail Merge Funktionen
Aspose.Words stellt einige zusätzliche mail merge-Eigenschaften und -Methoden bereit, mit denen Sie den mail merge-Prozess entweder in einfachen Mail Merge oder Mail Merge mit Regionen weiter anpassen können.
Zu den erweiterten mail merge-Funktionen gehören unter anderem das Abrufen von Informationen zur Vorlagenstruktur vor dem Ausführen einer mail merge-Operation, das Festlegen von Regeln für eine mail merge-Operation und das Bereinigen während einer mail merge-Operation. Dieser Artikel behandelt nur einige Eigenschaften und Beispiele, um Ihnen zu zeigen, wie Sie erweiterte Funktionen verwenden.
Regeln für Mail Merge-Operationen festlegen
Durch das Hinzufügen von Regeln zu Ihrer Vorlage können Sie den Workflow-Prozess effektiver und flexibler gestalten. Mit Mail Merge -Regeln können Sie Inhalte einrichten, die schnell geändert werden können, und die Notwendigkeit vermeiden, mehrere Dokumente zu generieren.
Mit Aspose.Words können Sie Mail Merge basierend auf Regeln anpassen, die beim Ausführen des Vorgangs Mail Merge ausgeführt werden, und Informationen zum Zusammenführen steuern. Zum Beispiel, wenn Sie eine E-Mail oder einen Brief erstellen, den Sie an alle Ihre Kunden senden möchten. Sie können eine Regel einrichten, damit der Brief verschiedene Daten enthalten kann, die auf den unterschiedlichen Werten in bestimmten Feldern Ihrer Datenquelle basieren.
Sehen Sie sich einige Mail Merge -Regeln an, die Sie implementieren können.
Nächstes Feld implementieren, um Datensätze im aktuellen Dokument zusammenzuführen
Sie können das Feld Next implementieren, um den nächsten Datensatz in das aktuelle resultierende Seriendruckdokument zusammenzuführen, anstatt ein neues Seriendruckdokument zu beginnen. Es wird verwendet, um mehrere Datensätze in einem Dokument anzuzeigen.
Implementieren Sie die Felder NextIf und SkipIf, um zwei Ausdrücke zu vergleichen
Sie können entweder das Feld NextIf oder das Feld SkipIf verwenden, wenn Sie zwei Ausdrücke ([right]https://reference.aspose.com/words/cpp/aspose.words.fields/fieldif/) and left -Ausdrücke) mit operator vergleichen möchten.
NextIf
| Field Name | Comparison Result “True” | Comparison Result “False” |
|---|---|---|
NextIf |
Aspose.Words fügt den nächsten Datensatz in das aktuelle Seriendruckdokument ein, und alle Seriendruckfelder in der Vorlage, die nach dem Feld NextIf stehen, werden durch Werte aus dem nächsten Datensatz und nicht durch den aktuellen Datensatz ersetzt. | Aspose.Words führt den nächsten Datensatz zu einem neuen Seriendruckdokument zusammen. |
SkipIf |
Aspose.Words bricht das aktuelle Seriendruckdokument ab, wechselt zum nächsten Datensatz in der Datenquelle und startet ein neues Seriendruckdokument. | Aspose.Words setzt das aktuelle Seriendruckdokument fort. |
Informationen über die Vorlagenstruktur erhalten
Aspose.Words ermöglicht es Ihnen, verschiedene Informationen in Ihrer Vorlage mit vielen Methoden zu sammeln. Beispielsweise müssen Sie möglicherweise die Namen einiger Seriendruckfelder oder die Hierarchie von Regionen in Ihrer Vorlage abrufen. Jetzt werden wir die möglichen Varianten erklären, um einige spezifische Informationen aus Ihrer Vorlage zu erhalten.
Seriendruckfeldnamen abrufen
Sie können auf ein Szenario stoßen, in dem Sie Daten mit Seriendruckfeldern zusammenführen möchten, die von anderen erstellt wurden, und in diesem Fall sind Sie sich über die genauen Namen der Seriendruckfelder nicht sicher. Um den Zweck von Mail Merge zu erreichen, müssen Sie zunächst die Namen aller Seriendruckfelder lesen und anzeigen. Aspose.Words ermöglicht es Ihnen, eine Sammlung von Seriendruckfeldnamen mit der Methode GetFieldNames abzurufen.
Das folgende Codebeispiel zeigt, wie Namen aller Seriendruckfelder in der Vorlage abgerufen werden:
Informationen zu Zusammenführungsregionen abrufen
Möglicherweise haben Sie ein Szenario, in dem Sie verstehen möchten, wie Ihre Vorlage durch die angegebenen Zusammenführungsbereiche strukturiert ist. Sie können einige Methoden verwenden, um alle erforderlichen Informationen zu Zusammenführungsregionen zu sammeln oder die Hierarchie der Zusammenführungsregionen in Ihrer Vorlage abzurufen, z. B. die Methode GetRegionsHierarchy. Sie können die Eigenschaften und Methoden der Klasse MailMergeRegionInfo verwenden.Das folgende Codebeispiel zeigt, wie die Hierarchie der Zusammenführungsregionen abgerufen wird:
System::SharedPtr<MailMergeRegionInfo> regionInfo = doc->get_MailMerge()->GetRegionsHierarchy();
Zugeordnete Felder hinzufügen
Mit Aspose.Words können Sie Namen von Feldern in Ihrer Datenquelle und Namen von Mail Merge Feldern in der Vorlage mithilfe der Eigenschaft MappedDataFields automatisch zuordnen. Wenn Sie beispielsweise einen Feldnamen mit dem Namen “Nachname” in Ihrer Vorlage und in Ihrer Datenquelle den Feldnamen “Nachname” oder eine andere Variante wie “Nachname” oder “LastName” haben, wird das Feld in der Datenquelle automatisch dem entsprechenden zugeordneten Feld zugeordnet. Wenn eine Zusammenführungsvorlage mit vielen Datenquellen zusammengeführt werden soll, machen zugeordnete Felder es unnötig, die Felder erneut in die Vorlage einzugeben, um mit den Feldnamen in der Datenbank übereinzustimmen.
Das folgende Codebeispiel zeigt, wie Sie ein zugeordnetes Feld mit der Methode Add hinzufügen, wenn ein Seriendruckfeld in einer Vorlage und ein Datenfeld in einer Datenquelle unterschiedliche Namen haben: