Mail Merge

Цей Aspose.Words Mail Merge for .NET плагін дозволяє розробникам створювати персоналізовані документи—такі як електронні листи, рахунки, каталоги, етикетки та звіти—шляхом визначення єдиного шаблону та заповнення його динамічними даними. Побудований на основному движку обробки документів Aspose.Words, він забезпечує потужне, масштабоване та налаштовуване рішення для масового створення документів у застосунках .NET.

Встановлення та налаштування

  1. Встановіть Aspose.Words for .NET пакет через NuGet або консоль Package Manager. ( Посібник з встановлення )
  2. Налаштувати Ліцензування за використанням перед запуском операцій злиття листів. ( Ліцензування за використанням ).
  3. Посилання Aspose.Words.dll у вашому проєкті.

Сумісний з Windows, Linux, macOS та мобільними платформами за допомогою .NET Framework, .NET або Mono. Підтримувані IDE включають Visual Studio (2010–2026), Xamarin та MonoDevelop 2.4+.

IDE: Visual Studio 2017–2026, JetBrains Rider, MonoDevelop.

Підтримувані шаблони / формати виводу: DOC, DOCX, RTF, DOT, DOTX, DOTM, DOCM, Word 2003 XML, і Word 2007 XML.

Ключові особливості та функціональність

Генерація документів на основі шаблонів

  • Створюйте шаблони у будь‑якому підтримуваному форматі.
  • Вставити merge fields (наприклад,., «FieldName») для представлення динамічних заповнювачів даних.
  • Зберігайте шаблони повторно використовуваними та підтримуваними в різних випадках використання.

Заповнення даних на рівні полів

  • Заповнюйте merge fields за допомогою текст, зображення, штрихкоди або форматований вміст.
  • Керуйте нумерацією, маркерами та стилями, щоб об’єднаний вміст відповідав корпоративному дизайну.

Вкладені області та умовні області

  • Повторювати таблиці, списки або абзаци для кожного запису даних, використовуючи регіони.
  • Використовуйте умовні області для динамічного включення/виключення розділів (наприклад, показувати адресу доставки лише за потреби).

Підключення джерела даних

  • Прив’язатися до будь‑якого джерело, сумісне з ADO.NET наприклад DataTable, DataReader, DataSet, масиви або користувацькі об’єкти.
  • Реалізуйте IMailMergeDataSource для повного контролю над обходом даних.
  • Легко працюйте з ієрархічними джерелами даних та злиттям батько‑дитина.

Користувацька обробка подій

  • Обробляти події, такі як MergeField, MergeImageField, і MergeRegion.
  • Застосовуйте трансформації (наприклад, форматування дат, генерація QR‑кодів або динамічна заміна заповнювачів).

Продуктивність і масштабованість

  • Оптимізовано для масштабних, високовольтних злиттів.
  • Потоково передавати результати безпосередньо на диск або у HTTP‑відповіді, щоб мінімізувати використання пам’яті.
  • Пакетна обробка, відкладена оцінка полів та повторне використання регіонів підвищують пропускну здатність.

Локалізація та інтернаціоналізація

  • Генеруйте багатомовні звіти, прив’язуючи локалізовані значення.
  • Застосувати культурно-специфічне форматування для чисел, валют і дат.
  • Підтримує мови з письмом справа наліво та правильну обробку кодування.

Сумісність та підтримка форматів

  • Підтримує всі основні формати Word (DOCX, DOC, RTF) і експортувати у той самий або інші формати через Aspose.Words conversion APIs.
  • Пост-обробка об’єднаних результатів за допомогою стандартних функцій Aspose.Words: конвертація, порівняння, AI‑функції, і інше.

Як створити звіт за допомогою Mail Merge 

// Load template
doc = new Document("InvoiceTemplate.docx");

// Example DataTable as data source
DataTable orders = new DataTable("Orders");
orders.Columns.Add("CustomerName");
orders.Columns.Add("Item");
orders.Columns.Add("Quantity");
orders.Rows.Add("John Doe", "Laptop", "1");
orders.Rows.Add("Jane Smith", "Phone", "2");

// Execute Mail Merge
doc.MailMerge.ExecuteWithRegions(orders);

// Save the result
doc.Save("InvoiceReport.docx");

Типові випадки використання

  • Масові листи & електронні листи: Автоматизуйте персоналізовану кореспонденцію.
  • Рахунки-фактури & Квитанції: Об’єднайте дані клієнтів та транзакцій у шаблони рахунків-фактур.
  • Звіти: Створюйте структуровані звіти з групованими або умовними даними.
  • Етикетки & Конверти: Створюйте поштові готові активи оптом.
  • Довідники & Каталоги: Скомпілюйте ієрархічні або табличні дані у структуровані документи.

Поради та найкращі практики

  • Використовуйте чіткі правила найменування для полів злиття, щоб підвищити підтримуваність.
  • Мінімізуйте глибоко вкладені області — спрощуйте дані, де це можливо.
  • Визначте та оформіть форматування в шаблоні, щоб забезпечити послідовність.
  • Перевірте джерела даних перед виконанням, щоб запобігти помилкам під час виконання.
  • Використовувати обробники подій для користувацької логіки, такої як вбудовування зображень або умовне форматування.
  • Контролюйте версії шаблонів і регулярно тестуйте їх за допомогою зразкових даних.
  • Реєструйте прогрес злиття та помилки для аудиту та моніторингу продуктивності.

Часті запитання

  1. Що таке Mail Merge для .NET? Фреймворк для створення персоналізованих документів із шаблонів з полями злиття, заповнених джерелами даних, такими як бази даних або колекції.
  2. Які джерела даних підтримуються? DataTable, DataSet, IDataReader, масиви та користувацькі об’єкти через IMailMergeDataSource.
  3. Чи працює це з ієрархічними даними? Так. Вкладені регіони дозволяють об’єднувати структури даних parent-child.
  4. Чи можна динамічно вставляти зображення? Так. Використовуйте MergeImageField події для вставки зображень (наприклад, аватари, QR‑коди).
  5. Чи підтримує це масштабні об’єднання? Так. Оптимізовано для високовольтного пакетного оброблення з низьким споживанням пам’яті.
 Українська