Aspose.Words Mail Merge для .NET

Aspose.Words Mail Merge для .NET плагина позволяет разработчикам генерировать персонализированные документы — такие как электронные письма, счета, каталоги, этикетки и отчеты — путем определения единого шаблона и популяции его с динамическими данными.

Инсталляция и установка

Совместим с Windows, Linux, macOS и мобильными платформами с использованием .NET Framework, .Net Core или Mono. Поддерживаемые IDEs включают Visual Studio (2010–2022), Xamarin и ManoDevelop.

Ключевые особенности и функции

Модель-базируемая генерация документов

  • Создайте шаблоны в DOCX, DOC, RTF или HTML.
  • Введите ** смешанные поля** (например., «FieldName») 1) представлять динамические данные местонахождения.
  • Сохраняйте шаблоны повторным использованием и поддержанием во многих случаях использования.

Полевой уровень данных популяции

  • Популярные поля объединения с текстом, изображениями, баркодами или форматированным контентом.
  • Контрольная цифра, кулеты и стили так, чтобы смешанный контент соответствовал корпоративному дизайну.

Нестные регионы и условные районы

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

Источник данных Connectivity

  • Свяжитесь с любым ADO.NET-соответствующим источником , таким как DataTable, DataReader, DataSet, расы или обычные предметы.
  • Implement IMailMergeDataSource Для полного контроля над прохождением данных.
  • Управляйте иерархическими источниками данных и с легкостью сливаются родители и дети.

Кондиционирование событий

  • Сделать события, как MergeField, MergeImageField, и MergeRegion.
  • Применить трансформации (например, форматные даты, генерировать QR-коды или динамично заменить местообладателей).

производительность и масштабируемость

  • Оптимизируется для ** широкого масштаба, высокого объема сливок**.
  • Поток результатов напрямую на диск или HTTP ответы для минимизации использования памяти.
  • Обработка батарей, отклоненная оценка поля и повторное использование региона улучшают пропускную способность.

Местоположение и интернационализация

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

Совместимость и поддержка формата

  • Поддерживает все основные формати Word ( **DOCX, DOC, RTF, HTML ** ) и экспортирует в PDF или другие форматы через APIs конверсии Aspose.Words.
  • Пост-процесс сочетает результаты с стандартными функциями Aspose.Words: цифровые подписи, компрессия, гифенация и многое другое.

Как составить отчет с помощью 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");

Общие случаи использования

  • Bulk Letters & Emails : автоматическая персонализированная корреспонденция.
  • Финансы и поступления : Слияние данных клиента и транзакций в шаблоны счета.
  • Репортажи : генерируйте структурированные отчеты с групповыми или условными данными.
  • Labels & Envelopes : Создайте готовые почтовые активы в массе.
  • Директивы и каталоги : Сбор иерархических или табличных данных в структурированные документы.

Советы и лучшие практики

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

Часто задаваемые вопросы

**Что такое Mail Merge для .NET?**Рамка для создания персонализированных документов из шаблонов с сливающимися полями, населенными источниками данных, такими как базы данных или коллекции.

Какие источники данных поддерживаются?DataTable, DataSet, IDataReader, расы, и персональные объекты через IMailMergeDataSource.

**Работает ли это с иерархическими данными?**Нестные регионы позволяют сливать структуры данных родителей и детей.

**Можно ли вводить изображения динамично?**Да. Использование MergeImageField события для введения изображений (например, профильные изображения, QR-коды).

**Поддерживает ли она крупномасштабные слияния?**Да. Оптимизирован для обработки высокого объема батарей с низким отпечатком памяти.

**Какие форматы поддерживаются?**Все основные форматы Word ( **DOCX, DOC, RTF, HTML ** ) с экспортом в PDF и более.

 Русский