Розширені функції 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 для об’єднання наступного запису даних у поточний отриманий об’єднаний документ, замість того, щоб створювати новий об’єднаний документ. Воно використовується для відображення декількох записів в одному документі.

Реалізуйте поля NextIf та SkipIf для порівняння двох виразів

Ви можете використовувати поле NextIf або поле SkipIf, якщо хочете порівняти два вирази (вирази right та left) з деяким значенням operator.

NextIf

Field Name Comparison Result “True” Comparison Result “False”
NextIf Aspose.Words призведе до об’єднання наступного запису даних з поточним документом злиття, і всі поля злиття в шаблоні, які знаходяться після поля NextIf, будуть замінені значеннями з наступного запису даних, а не з поточного запису даних. Aspose.Words призведе до об’єднання наступного запису даних у Новий об’єднуючий документ.
SkipIf Aspose.Words скасує поточний об’єднуючий документ, перейде до наступного запису даних у джерелі даних та запустить новий об’єднуючий документ. Aspose.Words продовжить роботу з поточним об’єднуючим документом.

Наступний приклад коду показує, як порівняти два вирази з NextIf або SkipIf:

Отримати інформацію про структуру шаблону

Aspose.Words Дозволяє збирати різну інформацію у вашому шаблоні різними способами. Наприклад, вам може знадобитися отримати назви деяких полів злиття або ієрархію регіонів у вашому шаблоні. Тепер ми пояснимо можливі варіанти отримання певної інформації з вашого шаблону.

Отримання імен полів злиття

Ви можете зіткнутися зі сценарієм, коли вам захочеться об’єднати дані з полями злиття, створеними іншими користувачами, і в цьому випадку ви не будете впевнені в точних назвах полів злиття. Отже, для досягнення мети Mail Merge, по-перше, вам потрібно буде прочитати та відобразити назви всіх полів злиття. Aspose.Words дозволяє отримати колекцію імен полів злиття, використовуючи метод GetFieldNames.

Наступний приклад коду показує, як отримати імена всіх полів злиття в шаблоні:

Отримайте інформацію про регіони злиття

Можливо, у вас є сценарій, коли ви хочете зрозуміти, як структурований ваш шаблон за допомогою зазначених областей злиття. Ви можете використовувати деякі методи для збору всієї необхідної інформації про регіони злиття або для отримання ієрархії областей злиття у вашому шаблоні, наприклад, метод GetRegionsHierarchy. Ви можете використовувати властивості та методи з MailMergeRegionInfo class.The наступного прикладу коду, який показує, як отримати ієрархію областей злиття:

Java 

MailMergeRegionInfo regionInfo = doc.getMailMerge().getRegionsHierarchy();

Наступний приклад коду показує, як отримати певні області злиття всередині вашого шаблону на основі їх назв:

Додавання зіставлених полів

Aspose.Words дозволяє автоматично зіставляти назви полів у вашому джерелі даних та назви полів Mail Merge у шаблоні, використовуючи властивість MappedDataFields. Наприклад, якщо у вашому шаблоні є поле з назвою “Last Name”, а у вашому джерелі даних є поле з назвою “Last Name” або іншим варіантом, таким як “Last_Name” або “LastName”, тоді поле у джерелі даних буде автоматично зіставлено з відповідним іменем. відображене поле. Якщо шаблон злиття повинен бути об’єднаний з багатьма джерелами даних, зіставлені поля не вимагають повторного введення полів у шаблон для узгодження з іменами полів у базі даних.

Наступний приклад коду показує, як додати зіставлене поле за допомогою методу Add, коли комбіноване поле в шаблоні та поле даних у джерелі даних мають різні назви:

Mail Merge Шаблон із синтаксису Mustache