مقدمه

خودکار کردن ایجاد اسناد شخصی‌سازی شده—مانند گزارشات، نامه‌ها و فاکتورها—می‌تواند هم زمان و هم تلاش شما را صرفه‌جویی کند. با ادغام نامه C# powered by Aspose.Words برای .NET، می‌توانید این کار را به‌طور یکپارچه انجام دهید. این راهنما شما را در استفاده از پلاگین ادغام نامه Aspose.Words برای انجام تولید اسناد کارآمد و مقیاس‌پذیر در برنامه‌های .NET خود راهنمایی خواهد کرد—بدون نیاز به MS Word یا Office Interop. در پایان، شما برای ادغام ادغام نامه C# برای اتوماسیون گزارشات و ساده‌سازی گردش کار گزارشات خود آماده خواهید بود.

محتویات:

ادغام نامه چیست؟

ادغام نامه یک روش قدرتمند برای تولید دینامیک اسناد با پر کردن الگوها با داده‌ها از منابع مختلف است. با Aspose.Words، می‌توانید کارهایی مانند:

  • تولید نامه‌ها و فاکتورهای شخصی‌سازی شده.
  • ایجاد گزارشات انبوه با استفاده از فرمت‌های ساختاری مانند XML، JSON یا پایگاه‌های داده، که امکان تولید دینامیک گزارشات با C# و Aspose.Words را فراهم می‌کند.

منابع داده برای ادغام نامه

Aspose.Words از انواع مختلف منابع داده پشتیبانی می‌کند، از جمله:

  • اشیاء: پر کردن الگوها با استفاده از نمونه‌های کلاس.
  • XML: بارگذاری داده‌های ساختاری برای فیلدهای دینامیک.
  • JSON: ادغام آسان با APIهای مدرن.
  • CSV: استفاده از داده‌های جدولی برای تولید انبوه اسناد.
  • DataTable/DataSet: استفاده از ADO.NET برای ادغام پایگاه داده.

آماده‌سازی الگو برای ادغام نامه

الگوی ادغام نامه سندی است که شامل فیلدهای ادغام است که در حین اجرا با داده‌ها از منبع داده مشخص شما پر می‌شود. الگو می‌تواند در فرمت DOC یا DOCX باشد و نیازی به سبک خاصی ندارد. مراحل زیر را برای ایجاد یک الگوی ادغام نامه دنبال کنید:

  1. سند خود را باز کنید یا یک سند جدید در MS Word ایجاد کنید.
  2. مکان‌نما را در جایی که می‌خواهید یک فیلد ادغام وارد کنید قرار دهید.
  3. از منوی درج، گزینه فیلد را انتخاب کنید.
  4. از لیست نام‌های فیلد، MergeField را انتخاب کنید.
  5. یک نام برای فیلد ادغام در کادر نام فیلد مشخص کنید و روی OK کلیک کنید.
  6. سند را ذخیره کنید.

تصویر زیر یک الگوی نمونه را نشان می‌دهد.

Mail Merge Template

API ادغام نامه .NET - نصب

شما می‌توانید Aspose.Words برای .NET را از طریق روش‌های مختلف نصب کنید:

اجرای ادغام نامه در سند Word با استفاده از C#

پس از آماده شدن الگو، می‌توانید ادغام نامه را برای تولید اسناد اجرا کنید. مراحل زیر را برای اجرای ادغام نامه بر روی الگوی آماده‌شده خود دنبال کنید:

  1. سند الگو را با استفاده از کلاس Document بارگذاری کنید.
  2. گزینه‌های مورد نیاز ادغام نامه را تنظیم کنید، مانند Document.MailMerge.TrimWhitespaces.
  3. ادغام نامه را با استفاده از متد Document.MailMerge.Execute() اجرا کنید و منبع داده را به عنوان پارامتر وارد کنید.
  4. سند تولید شده را با استفاده از متد Document.Save(String) ذخیره کنید.

در اینجا یک نمونه کد نشان داده شده است که چگونه تولید گزارش را در C# با استفاده از یک آرایه از مقادیر خودکار کنید:

سند Word پس از ادغام نامه

Execute Mail Merge in C#

اجرای ادغام نامه با استفاده از منبع داده XML در C#

فایل‌های XML معمولاً برای ذخیره و انتقال داده‌ها استفاده می‌شوند. Aspose.Words برای .NET از XML به عنوان منبع داده برای عملیات ادغام نامه پشتیبانی می‌کند. به سادگی XML را به یک شیء DataSet بخوانید و ادغام نامه را اجرا کنید. در زیر یک فایل XML نمونه برای مورد استفاده ما آورده شده است.

<customers>
    <customer Name="John Ben Jan" ID="1" Domain="History" City="Boston"/>
    <customer Name="Lisa Lane" ID="2" Domain="Chemistry" City="LA"/>
    <customer Name="Dagomir Zits" ID="3" Domain="Heraldry" City="Milwaukee"/>
    <customer Name="Sara Careira Santy" ID="4" Domain="IT" City="Miami"/>
</customers>