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 - це персоналізований документ, що містить фіксовані дані та об’єднані поля, де ви хочете розмістити змінний текст. Шаблон злиття може бути в будь-якому форматі, що підтримує поля, наприклад, DOC, DOCX, DOT, DOTX, RTF. Крім того, ви також можете використовувати шаблон mustache, який детальніше описаний у статті “Синтаксис шаблону Mustache”.

Ви можете створити шаблон об’єднання, який буде служити зразком для нових документів, і він повинен містити основний текст, який повинен бути однаковим для кожної версії документа, що об’єднується. Додавання полів об’єднання в шаблон буде представляти дані персоналізації, такі як Імена або адреси, які витягуються з джерела даних. Операція Mail Merge автоматично вставить дані персоналізації з вашого джерела даних у документ шаблону злиття.

Крім того, ви можете додати регіон Mail Merge до свого шаблону, вставивши два поля Mail Merge, щоб позначити початок і кінець поштового регіону. У наступній статті " типи операцій Mail Merge" це пояснюється більш детально.

Створіть шаблон Mail Merge

Ви можете створити шаблон і додати до нього певні поля злиття, які будуть замінені значеннями з джерела даних або вручну, наприклад, за допомогою Microsoft Word, або програмно, використовуючи Aspose.Words. У цій статті ми розглянемо програмний спосіб створення шаблону.

Використовуйте клас DocumentBuilder, щоб створити необхідний шаблон злиття за допомогою Aspose.Words. Ви можете включити текст, поле для об’єднання та розрив рядка в такий шаблон, використовуючи методи InsertTextInput, InsetField та InsertParagraph.

Наступний приклад коду показує, як створити шаблон Mail Merge:

На малюнку нижче показано створений шаблон:

mail_merge_template

Налаштування властивостей шаблону Mail Merge

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

Налаштування властивостей зображення

Ви можете вказати Властивості зображення за допомогою класу ImageFieldMergingArgs. Зверніть увагу, що ви можете вставити зображення з бази даних, як описано в Aspose.Words GitHub.

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

Налаштування властивостей тексту

Ви можете використовувати властивість Text, щоб вставити текст у документ для поточного поля злиття. Крім того, ви можете змінити форматування текстів та абзаців у вашому шаблоні, використовуючи класи Font та ParagraphFormat. Ви можете обробляти текст, який буде вставлений до або після поля об’єднання, використовуючи властивості TextBefore та TextAfter, які включені до класу FieldMergeField.

Наступний приклад коду показує, як вставити прапорці або HTML під час операції Mail Merge:

Дивіться також

  • Для отримання більш докладної інформації про те, як створювати шаблони в Microsoft Word вручну, будь ласка, ознайомтеся зі статтею Створити шаблон у документації Microsoft
Типи операцій Mail Merge в C#