سند ورد ادغام ایمیل

نامه ادغام سند word آنلاین

Mail Merge ساده ترین راه برای تولید مجموعه ای از اسناد است که به جز اطلاعات خاصی مانند نام و آدرس گیرنده یکسان هستند. بسیاری از سازمان‌ها از طریق نامه‌ها، خبرنامه‌ها و قطعات تبلیغاتی با استفاده از ادغام ایمیل با مشتریان/اعضای خود ارتباط برقرار می‌کنند، بنابراین در این مقاله، ما قصد داریم در مورد جزئیات نحوه ادغام اسناد Word با استفاده از C# REST API صحبت کنیم.

Mail Merge API

Aspose.Words Cloud قابلیت ایجاد یک سند Word جدید، باز کردن یک سند موجود یا تبدیل آن به PDF، XPS، SVG، EPUB و فرمت های مختلف دیگر را ارائه می دهد. از آنجایی که API ما بر اساس معماری REST توسعه یافته است، بنابراین لازم نیست نگران محدودیت های زبان یا پلت فرم باشید. اکنون برای استفاده از API در برنامه C# .NET، لطفا Aspose.Words Cloud SDK را برای .NET با استفاده از دستور زیر نصب کنید:

 Install-Package Aspose.Words-Cloud

پس از نصب، باید یک حساب رایگان در Aspose.Cloud داشبورد با استفاده از GitHub یا حساب Google ثبت کنیم یا به سادگی ثبت نام کنید و اعتبار مشتری خود را دریافت کنید.

پر کردن قالب Mail Merge در C#

لطفاً مراحل زیر را دنبال کنید تا با استفاده از یک فایل داده، الگوی Mail Merge را پر کنید.

String MyClientID = "c235e685-1aab-4cda-a95b-54afd63eb87f"; // Get MyClientID from https://dashboard.aspose.cloud/
String MyClientSecret = "b8da4ee37494f2ef8da3c727f3a0acb9"; // Get MyClientSecret from https://dashboard.aspose.cloud/

// یک نمونه از کلاس Configuration را در جعبه قرار دهید و Client ID شخصی و جزئیات Client Secret را ارائه دهید
var config = new Configuration { ClientId = MyClientID, ClientSecret = MyClientSecret };
// مقداردهی اولیه شی WordsAPI را با استفاده از نمونه پیکربندی
var wordsApi = new WordsApi(config);
// اولین سند ورودی
string inputDocument = "SampleMailMergeTemplate.docx";
string inputDataFile = "SampleMailMergeTemplateData.txt";
// نام فایل حاصل
string resultantFile = "TestPostDocumentExecuteMailMerge.docx";
// محتوای فایل داده را بخوانید
string data = File.ReadAllText("/Downloads/" + inputDataFile, System.Text.Encoding.UTF8);
// ایجاد شی ExecuteMailMergeRequest با ارائه فایل ورودی، فایل داده و جزئیات خروجی حاصل
Requests.ExecuteMailMergeRequest request = new Requests.ExecuteMailMergeRequest(inputDocument, data, null, null, null, null, null, null, null, null, resultantFile);
// عملیات ادغام نامه را انجام دهید
DocumentResponse result = wordsApi.ExecuteMailMerge(request);

Mail Merge Word با استفاده از دستور cURL

دستورات cURL نیز یک راه راحت برای دسترسی به API های REST هستند. از آنجایی که Aspose.Words Cloud بر روی معماری REST API توسعه یافته است، بنابراین می توانیم به راحتی از طریق دستورات cURL به API ها دسترسی داشته باشیم. اکنون، به عنوان یک پیش نیاز، باید یک توکن دسترسی JWT بر اساس Client ID و جزئیات Client Secret ایجاد کنیم.

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=c235e685-1aab-4cda-a95b-54afd63eb87f&client_secret=b8da4ee37494f2ef8da3c727f3a0acb9" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

برای جزئیات بیشتر، لطفاً به [نحوه دریافت رمز JWT با استفاده از شناسه مشتری و کلید مخفی مشتری2 مراجعه کنید.

هنگامی که نشانه دسترسی JWT را داریم، می توانیم از دستور cURL زیر برای پر کردن قالب Mail Merge استفاده کنیم. ما داده ها را از یک فایل متنی بارگذاری می کنیم.

  • API ExecuteMailMerge عملیات اصلی را انجام می دهد.
  • SampleMailMergeTemplate.docx الگوی ادغام ایمیل ورودی است که در فضای ذخیره سازی ابری موجود است.
  • ما از پارامتر -F استفاده می کنیم که داده های ورودی را از فایل SampleMailMergeTemplateData.txt آپلود می کند.
  • فایل حاصل در برابر پارامتر destFileName در فضای ذخیره سازی ابری ذخیره می شود.
curl -v "https://api.aspose.cloud/v4.0/words/SampleMailMergeTemplate.docx/MailMerge?withRegions=false&destFileName=TestPostDocumentExecuteMailMerge.docx" \
-X PUT  \
-F data=@/Downloads/SampleMailMergeTemplateData.txt \
-H "Content-Type: multipart/form-data" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>"
پیش نمایش ادغام ایمیل

تصویر 1: - پیش نمایش سند پس از عملیات ادغام ایمیل.

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

نتیجه گیری

در این مقاله، جزئیات نحوه انجام Mail Merge در اسناد Word با استفاده از قطعه کد C# را مورد بحث قرار داده ایم. در عین حال، مراحل ادغام نامه را با استفاده از دستورات cURL نیز آموخته ایم. لطفاً توجه داشته باشید که SDK ما بر اساس مجوز MIT ساخته شده است، بنابراین کد منبع کامل آن برای دانلود در مخزن GitHub در دسترس است. پیشنهاد می‌کنیم [مستندات محصول] را بررسی کنید و با سایر ویژگی‌های هیجان‌انگیز پشتیبانی شده توسط API آشنا شوید.

مقالات مرتبط

همچنین توصیه می کنیم برای کسب اطلاعات بیشتر به لینک های زیر مراجعه کنید: