تولید اسناد در C# با استفاده از Mail Merge

Wordize for .NET راه‌حل حرفه‌ای برای ایجاد خودکار اسناد شخصی‌شده با استفاده از تکنولوژی Mail Merge است. کلاس MailMerger به توسعه‌دهندگان C# این امکان را می‌دهد که قالب‌های آماده اسناد را با داده‌های منابع مختلف ترکیب کنند تا فاکتورها، قراردادها، گزارش‌ها و نامه‌های شخصی‌شده را به صورت انبوه تولید کنند.

Wordize for .NET امکان استفاده از تکنولوژی Mail Merge با قالب‌ها در هر فرمت پشتیبانی‌شده را فراهم می‌کند: Word، PDF، HTML، Markdown و سایر فرمت‌ها. این امکان ایجاد اسناد شخصی‌شده را بدون وابستگی به فرمت اصلی قالب فراهم می‌کند.

قابلیت‌های عملکردی:

تکمیل ساده اسناد - متد Execute() اسناد شخصی‌شده تولید می‌کند با ترکیب قالب‌های آماده با منابع داده خارجی
تولید محتوای پویا - متد ExecuteWithRegions() عناصر تکرارشونده قالب را پردازش می‌کند تا جداول و فهرست‌هایی با طول متغیر ایجاد کند
ادغام با منابع داده مختلف - پشتیبانی از انواع DataRow، DataTable، DataSet، آرایه‌های مقادیر
تنظیمات پیشرفته - کلاس MailMergeOptions پارامترهای تولید اسناد را مدیریت می‌کند: حذف پاراگراف‌های خالی، نواحی و فیلدهای استفاده‌نشده، برش فضاهای اضافی، ادغام نواحی تکراری و سایر پارامترها
قابلیت صادرات نتیجه به فرمت گرافیکی - متد ExecuteToImages() نتیجه را به صورت مجموعه‌ای از تصاویر برمی‌گرداند
پشتیبانی Fluent API برای راه‌اندازی تولید از طریق MailMergerContext و زنجیره‌ای از متدها که وضوح را به کد C# اضافه می‌کند

سناریوهای استفاده:

ارسال انبوه نامه‌ها و اطلاعیه‌های شخصی‌شده با داده‌های فردی گیرندگان
ایجاد فاکتورها، قراردادها و پیشنهادات شخصی‌شده با اطلاعات مخصوص هر مشتری
تولید اسناد از فرم‌های آماده: گواهی‌نامه‌ها، مدارک، دعوتنامه‌ها با داده‌های شخصی
ایجاد خودکار اسناد یکنواخت با محتوای متفاوت بر اساس پایگاه‌های داده

قابلیت‌های تولید برنامه‌نویسی اسناد شخصی‌شده با استفاده از تکنولوژی Mail Merge را در نمایش آنلاین تعاملی ارائه‌شده در این صفحه آزمایش کنید. برای این کار، قالب سند، فایل متنی حاوی داده‌ها (CSV، JSON، XML) را آپلود کنید، عملیات را اجرا کنید و نتیجه تولیدشده را برای بررسی دانلود کنید. قطعه کد C# ارائه‌شده کاملاً آماده استفاده در پروژه .NET شما است.

اجرای کد

قالب سند را آپلود کنید

منبع داده را آپلود کنید

فرمت خروجی را از لیست انتخاب کنید

 
				
				
		
using System.Data;
using Newtonsoft.Json;
using Wordize.MailMerging;

string json = File.ReadAllText("DataSource.json");
DataTable dataTable = JsonConvert.DeserializeObject(json);
MailMerger.Execute("Input.docx", "Output.pdf", SaveFormat.Pdf, dataTable);

										using System.Data;
using Newtonsoft.Json;
using Wordize.MailMerging;

string json = File.ReadAllText("DataSource.json");
DataTable dataTable = JsonConvert.DeserializeObject(json);
MailMerger.Execute("Input.docx", "Output.pdf", SaveFormat.Pdf, dataTable);

										using System.Data;
using Newtonsoft.Json;
using Wordize.MailMerging;
using Wordize.Saving;

string json = File.ReadAllText("DataSource.json");
DataTable dataTable = JsonConvert.DeserializeObject(json);
var imageStreams = MailMerger.Execute("Input.docx", new ImageSaveOptions(SaveFormat.Pdf),  dataTable);

foreach (var (stream, page) in imageStreams.Select((s, i) => (s, i)))
{
    using var _ = stream;
    stream.Position = 0;
    
    using var file = File.Create($"Output_{page + 1}.pdf");
    stream.CopyTo(file);
}

					
using System.Data;
using Wordize.MailMerging;

DataSet dataSet = new DataSet();
dataSet.ReadXml("DataSource.xml");
MailMerger.Execute("Input.docx", "Output.pdf", SaveFormat.Pdf, dataSet.Tables[0]);

										using System.Data;
using Wordize.MailMerging;

DataSet dataSet = new DataSet();
dataSet.ReadXml("DataSource.xml");
MailMerger.Execute("Input.docx", "Output.pdf", SaveFormat.Pdf, dataSet.Tables[0]);

										using System.Data;
using Wordize.MailMerging;
using Wordize.Saving;

DataSet dataSet = new DataSet();
dataSet.ReadXml("DataSource.xml");
var imageStreams = MailMerger.Execute("Input.docx", new ImageSaveOptions(SaveFormat.Pdf),  dataSet.Tables[0]);

foreach (var (stream, page) in imageStreams.Select((s, i) => (s, i)))
{
    using var _ = stream;
    stream.Position = 0;
    
    using var file = File.Create($"Output_{page + 1}.pdf");
    stream.CopyTo(file);
}

					

				اجرای کد
			

نحوه تولید اسناد شخصی‌شده در C#

Wordize for .NET را به پروژه C# خود متصل کنید
فایل داده را بخوانید، آن را در DataTable deserialize کنید و Execute() را فراخوانی کنید، با مشخص کردن قالب سند، فایل خروجی، فرمت ذخیره و منبع داده
اسناد شخصی‌شده تولیدشده را دریافت کنید