اتوماسیون تولید اسناد برای کسب‌وکارهایی که به دنبال ایجاد گزارش‌ها، فاکتورها و نامه‌های پویا هستند، ضروری است. با Aspose.Words Mail Merge for .NET، می‌توانید به‌طور مؤثر الگوهای ورد را با داده‌هایی از منابع مختلف، از جمله اشیاء، CSV، JSON و XML پر کنید. این راهنما شما را در استفاده از ادغام پستی در C# برای گردش کار اسناد خودکار و ساده شده راهنمایی می‌کند و بر ایجاد اسناد ورد پویا با C# .NET تمرکز دارد.
موضوعات پوشش داده شده:
- مروری بر ادغام پستی برای .NET
- تولید اسناد از منابع داده مختلف
- بهترین شیوه‌ها برای ادغام پستی
- سؤالات متداول
مروری بر ادغام پستی برای .NET
Aspose.Words Mail Merge for .NET به توسعه‌دهندگان اجازه می‌دهد تا اسناد شخصی‌سازی شده را از الگوهای از پیش تعریف شده که شامل فیلدهای ادغام هستند، تولید کنند. این پلاگین برای ادغام بدون مشکل در محیط‌های .NET طراحی شده است و قابلیت‌هایی را ارائه می‌دهد که شامل:
- پر کردن پویا الگوها با داده‌ها، که از تولید اسناد ورد در .NET framework پشتیبانی می‌کند.
- انجام تولید اسناد به‌صورت انبوه به‌طور مؤثر، با استفاده از راه‌حل ادغام پستی .NET برای مجموعه‌های داده بزرگ.
- اطمینان از فرمت‌بندی یکسان در خروجی‌ها، که بهترین شیوه‌های الگوی سند ورد C# را تقویت می‌کند.
ویژگی‌های کلیدی:
- پشتیبانی از چند منبع: استفاده از داده‌ها از اشیاء، پایگاه‌های داده، XML، JSON و CSV برای ایجاد اسناد ورد سفارشی با C#.
- عملکرد بالا: مدیریت مؤثر مجموعه‌های داده بزرگ و عملیات انبوه برای تولید اسناد ورد پویا با .NET Core.
- الگوهای قابل تنظیم: ایجاد الگوهایی با جاهای خالی برای درج داده، با استفاده از قابلیت‌های اتوماسیون ادغام پستی ورد .NET.
راه‌اندازی
برای شروع، Aspose.Words را با استفاده از NuGet نصب کنید:
PM> Install-Package Aspose.Words
تولید سند ورد از الگو با استفاده از اشیاء C#
بیایید با پر کردن یک الگوی ورد با استفاده از اشیاء C# شروع کنیم. ما یک سند ورد (DOC/DOCX) با جاهای خالی زیر ایجاد خواهیم کرد:
<<[sender.Name]>> می‌گوید: "<<[sender.Message]>>."
در این مثال، sender یک نمونه از کلاسی است که ما برای پر کردن الگو با استفاده از روش تولید سند ورد از پایگاه داده C# استفاده خواهیم کرد.
در مرحله بعد، ما از موتور گزارش‌گیری Aspose.Words برای تولید سند ورد از الگو و نمونه کلاس Sender با دنبال کردن مراحل زیر استفاده خواهیم کرد:
- یک نمونه از کلاس Document ایجاد کرده و آن را با مسیر الگوی ورد مقداردهی اولیه کنید.
- یک شی از کلاس Sender ایجاد و مقداردهی اولیه کنید.
- کلاس ReportingEngine را ایجاد کنید.
- الگو را با استفاده از ReportingEngine.BuildReport() که نمونه Document، منبع داده و نام منبع داده را به عنوان پارامتر می‌گیرد، پر کنید.
- سند ورد تولید شده را با استفاده از Document.Save() ذخیره کنید.
در اینجا نمونه کدی آورده شده است که نشان می‌دهد چگونه یک سند ورد از یک الگو تولید کنید در C#.
خروجی
تولید سند ورد از منبع داده XML در C#
برای تولید یک سند ورد از منبع داده XML، ما از یک الگوی ورد پیچیده‌تر با جاهای خالی زیر استفاده خواهیم کرد:
<<foreach [in persons]>>نام: <<[Name]>>, سن: <<[Age]>>, تاریخ تولد: <<[Birth]:"dd.MM.yyyy">>
<</foreach>>
میانگین سن: <<[persons.Average(p => p.Age)]>>
منبع داده XML استفاده شده در این مثال به شرح زیر است.
برای ایجاد یک سند ورد از منبع داده XML، مراحل زیر را دنبال کنید:
- یک نمونه از کلاس Document ایجاد کرده و آن را با مسیر الگوی ورد مقداردهی اولیه کنید.
- یک نمونه از کلاس XmlDataSource ایجاد کرده و آن را با مسیر فایل XML مقداردهی اولیه کنید.
- کلاس ReportingEngine را ایجاد کنید.
- از روش ReportingEngine.BuildReport() برای پر کردن الگوی ورد استفاده کنید.
- سند ورد تولید شده را با استفاده از روش Document.Save() ذخیره کنید.
در اینجا نمونه کدی آورده شده است که نشان می‌دهد چگونه یک سند ورد از منبع داده XML تولید کنید در C#.
خروجی
تولید سند ورد از منبع داده JSON در C#
در مرحله بعد، بیایید بررسی کنیم که چگونه یک سند ورد با استفاده از منبع داده JSON تولید کنیم. در این مثال، ما یک لیست از مشتریان را که به‌وسیله مدیرانشان تقسیم‌بندی شده‌اند، ایجاد خواهیم کرد. الگوی ورد به این شکل خواهد بود:
<<foreach [in managers]>>مدیر: <<[Name]>>
قراردادها:
<<foreach [in Contract]>>- <<[Client.Name]>> ($<<[Price]>>)
<</foreach>>
<</foreach>>
منبع داده JSON مربوطه که ما برای پر کردن الگو استفاده خواهیم کرد، به شرح زیر است:
برای تولید سند ورد از JSON، ما از کلاس JsonDataSource برای بارگذاری منبع داده استفاده خواهیم کرد و مراحل باقی‌مانده مانند ساختار قبلی خواهد بود. در اینجا نمونه کدی آورده شده است که نشان می‌دهد چگونه یک سند ورد از الگوی JSON تولید کنید در C#.
خروجی
تولید سند ورد از منبع داده CSV در C#
برای تولید سند ورد از منبع CSV، ما از الگوی ورد زیر استفاده خواهیم کرد:
<<foreach [in persons]>>نام: <<[Column1]>>, سن: <<[Column2]>>, تاریخ تولد: <<[Column3]:"dd.MM.yyyy">>
<</foreach>>
میانگین سن: <<[persons.Average(p => p.Column2)]>>
این الگو با استفاده از داده‌های CSV زیر پر خواهد شد:
حالا بیایید کد C# را بررسی کنیم. مراحل مشابه باقی می‌ماند به جز یک تفاوت کلیدی: ما از کلاس CsvDataSource برای بارگذاری داده‌های CSV استفاده خواهیم کرد. نمونه کد زیر نشان می‌دهد که چگونه سند ورد را از منبع داده CSV تولید کنید.
خروجی
آزمایش رایگان Aspose.Words برای .NET
شما می‌توانید Aspose.Words for .NET را با استفاده از یک مجوز موقت رایگان آزمایش کنید.
نتیجه‌گیری
در این مقاله، شما یاد گرفتید که چگونه اسناد ورد را از الگوها با استفاده از C# تولید کنید. شما بررسی کردید که چگونه می‌توان از منابع داده مختلف مانند اشیاء، XML، JSON و CSV برای تولید اسناد پویا در .NET استفاده کرد. برای کسب اطلاعات بیشتر در مورد قابلیت‌های پردازش الگوی ورد .NET، به مستندات مراجعه کنید و در صورت تمایل از طریق فروم با ما تماس بگیرید.
