ادغام نامه

این Aspose.Words Mail Merge for .NET افزونه به توسعه‌دهندگان امکان می‌دهد اسناد شخصی‌سازی‌شده—مانند ایمیل‌ها، فاکتورها، فهرست‌ها، برچسب‌ها و گزارش‌ها—را با تعریف یک قالب واحد و پر کردن آن با داده‌های پویا تولید کنند. این افزونه بر پایهٔ موتور پردازش اسناد اصلی Aspose.Words ساخته شده است و راه‌حلی قدرتمند، مقیاس‌پذیر و قابل تنظیم برای ایجاد اسناد انبوه در برنامه‌های .NET فراهم می‌کند.

نصب و راه‌اندازی

  1. نصب Aspose.Words for .NET پکیج از طریق NuGet یا کنسول Package Manager. ( راهنمای نصب )
  2. پیکربندی مجوز متری قبل از اجرای عملیات ادغام ایمیل. ( مجوز متری ).
  3. مرجع Aspose.Words.dll در پروژهٔ شما.

سازگار با ویندوز، لینوکس، 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.

ویژگی‌ها و عملکردهای کلیدی

تولید سند مبتنی بر قالب

  • قالب‌ها را در هر فرمت پشتیبانی‌شده‌ای ایجاد کنید.
  • درج فیلدهای ادغام (مثلاً،., «FieldName») برای نمایش متغیرهای داده پویا.
  • قالب‌ها را قابل استفاده مجدد و قابل نگهداری در چندین مورد استفاده نگه دارید.

پرکردن داده‌ها در سطح فیلد

  • فیلدهای ترکیبی را با متن، تصاویر، بارکدها یا محتوای قالب‌بندی‌شده.
  • شماره‌گذاری، گلوله‌ها و سبک‌ها را کنترل کنید تا محتوای ترکیبی با طراحی شرکتی مطابقت داشته باشد.

ناحیه‌های تو در تو و ناحیه‌های شرطی

  • تکرار جداول، فهرست‌ها یا پاراگراف‌ها برای هر رکورد داده با استفاده از نواحی.
  • از ناحیه‌های شرطی برای گنجاندن/حذف بخش‌ها به‌صورت پویا استفاده کنید (مثلاً فقط در صورت نیاز، آدرس حمل و نقل را نمایش دهید).

اتصال به منبع داده

  • اتصال به هر منبع سازگار با ADO.NET مانند DataTable, DataReader, DataSet, آرایه‌ها، یا اشیای سفارشی.
  • پیاده‌سازی IMailMergeDataSource برای کنترل کامل بر پیمایش داده‌ها.
  • منابع داده سلسله‌مراتبی و ترکیب‌های والد‑فرزند را به‌راحتی مدیریت کنید.

مدیریت رویداد سفارشی

  • رویدادها را مانند MergeField, MergeImageField,، و MergeRegion.
  • تبدیل‌ها را اعمال کنید (مثلاً قالب‌بندی تاریخ‌ها، تولید کدهای QR، یا جایگزینی پویا مکان‌نگهدارها).

کارایی و مقیاس‌پذیری

  • بهینه‌سازی شده برای ادغام‌های بزرگ‌مقیاس، با حجم بالا.
  • نتایج را مستقیماً به دیسک یا پاسخ‌های HTTP جریان می‌دهد تا مصرف حافظه را به حداقل برساند.
  • پردازش دسته‌ای، ارزیابی به‌تاخیر افتاده فیلدها، و استفاده مجدد از نواحی بازدهی را افزایش می‌دهند.

بومی‌سازی و بین‌المللی‌سازی

  • گزارش‌های چندزبانه را با بایند کردن مقادیر بومی‌سازی‌شده تولید کنید.
  • اعمال قالب‌بندی مخصوص به فرهنگ برای اعداد، ارزها و تاریخ‌ها.
  • از زبان‌های راست به چپ و مدیریت صحیح رمزگذاری پشتیبانی می‌کند.

سازگاری و پشتیبانی از فرمت‌ها

  • از تمام فرمت‌های اصلی Word پشتیبانی می‌کند (DOCX, DOC, RTF) و به همان یا فرمت‌های دیگر از طریق APIهای تبدیل 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");

موارد استفاده رایج

  • نامه‌ها و ایمیل‌های انبوه: مکاتبات شخصی‌سازی‌شده را خودکار کنید.
  • فاکتورها & رسیدها: داده‌های مشتری و تراکنش را در قالب‌های فاکتور ادغام کنید.
  • گزارش‌ها: تولید گزارش‌های ساختاریافته با داده‌های گروه‌بندی‌شده یا شرطی.
  • برچسب‌ها و پاکت‌ها: ایجاد دارایی‌های آماده برای ارسال پستی به صورت انبوه.
  • دایرکتوری‌ها و کاتالوگ‌ها: ترکیب داده‌های سلسله‌مراتبی یا جدولی در اسناد ساختاریافته.

نکات و بهترین روش‌ها

  • استفاده کنید قواعد نام‌گذاری واضح برای فیلدهای ترکیبی به منظور بهبود قابلیت نگهداری.
  • مناطق تو در تو عمیق را به حداقل برسانید—داده‌ها را در صورت امکان صاف کنید.
  • قالب را برای تعریف و استایل‌دهی فرمت‌گذاری تنظیم کنید تا سازگاری حفظ شود.
  • منابع داده را پیش از اجرا اعتبارسنجی کنید تا از بروز خطاهای زمان اجرا جلوگیری شود.
  • استفاده کنید هندلرهای رویداد برای منطق سفارشی مانند جاسازی تصویر یا قالب‌بندی شرطی.
  • قالب‌های کنترل نسخه را به‌صورت منظم با داده‌های نمونه تست کنید.
  • پیشرفت ادغام و خطاها را برای حسابرسی و نظارت بر عملکرد ثبت کنید.

سوالات متداول

  1. ادغام نامه برای .NET چیست؟? چارچوبی برای تولید اسناد شخصی‌سازی‌شده از قالب‌ها با فیلدهای ادغام، که توسط منابع داده‌ای مانند پایگاه‌های داده یا مجموعه‌ها پر می‌شود.
  2. کدام منابع داده پشتیبانی می‌شوند؟? DataTable, DataSet, IDataReader, آرایه‌ها، و اشیاء سفارشی از طریق IMailMergeDataSource.
  3. آیا با داده‌های سلسله‌مراتبی کار می‌کند؟? بله. نواحی تو در تو به شما امکان می‌دهند ساختارهای داده‌ای والد‑فرزند را ادغام کنید.
  4. آیا می‌توان تصاویر را به‌صورت پویا وارد کرد؟? بله. استفاده کنید MergeImageField رویدادهایی برای وارد کردن تصاویر (مثلاً تصویرهای پروفایل، کدهای QR).
  5. آیا از ادغام‌های بزرگ‌مقیاس پشتیبانی می‌کند؟? بله. بهینه‌سازی شده برای پردازش دسته‌ای با حجم بالا و مصرف حافظه کم.
 فارسی