دمج المراسلات في مستند Word

دمج المراسلات في مستندات الوورد عبر الإنترنت

دمج المراسلات هو أسهل طريقة لإنشاء مجموعة من المستندات المتطابقة باستثناء معلومات معينة مثل اسم وعنوان المستلم. تتواصل العديد من المؤسسات مع عملائها/أعضائها من خلال الرسائل والنشرات الإخبارية والمواد الترويجية باستخدام دمج المراسلات، لذلك في هذه المقالة، سنناقش التفاصيل حول كيفية دمج مستندات Word باستخدام واجهة برمجة تطبيقات C# REST.

واجهة برمجة تطبيقات دمج البريد

توفر Aspose.Words Cloud الإمكانيات اللازمة لإنشاء مستند Word جديد أو فتح مستند موجود أو تحويله إلى PDF أو XPS أو SVG أو EPUB أو تنسيقات أخرى متنوعة. ونظرًا لأن واجهة برمجة التطبيقات الخاصة بنا تم تطويرها وفقًا لبنية REST، فلا داعي للقلق بشأن قيود اللغة أو المنصة. والآن لاستخدام واجهة برمجة التطبيقات في تطبيق C# .NET، يُرجى تثبيت Aspose.Words Cloud SDK لـ .NET باستخدام الأمر التالي:

 Install-Package Aspose.Words-Cloud

بعد التثبيت، نحتاج إلى تسجيل حساب مجاني على لوحة تحكم Aspose.Cloud باستخدام حساب GitHub أو Google أو ببساطة التسجيل والحصول على بيانات اعتماد العميل الخاصة بك.

ملء قالب دمج البريد في C#

يرجى اتباع الخطوات الموضحة أدناه لملء قالب دمج المراسلات باستخدام ملف البيانات.

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

// إنشاء مثيل لفئة التكوين وتوفير تفاصيل معرف العميل والسر الخاص بالعميل
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);

دمج المراسلات في Word باستخدام الأمر cURL

تُعد أوامر cURL أيضًا طريقة ملائمة للوصول إلى واجهات برمجة التطبيقات REST. نظرًا لأن Aspose.Words Cloud تم تطويره على بنية واجهة برمجة التطبيقات REST، فيمكننا الوصول بسهولة إلى واجهات برمجة التطبيقات عبر أوامر cURL. الآن، كشرط أساسي، نحتاج إلى إنشاء رمز وصول JWT استنادًا إلى تفاصيل معرف العميل والسر الخاص بالعميل.

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 باستخدام معرف العميل ومفتاح العميل السري.

بمجرد حصولنا على رمز وصول JWT، يمكننا استخدام أمر cURL التالي لملء قالب الدمج البريدي. نقوم بتحميل البيانات من ملف نصي.

  • تنفذ واجهة برمجة التطبيقات 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:- معاينة المستند بعد عملية دمج البريد.

ملفات العينة من المثال أعلاه متاحة على الروابط التالية

خاتمة

في هذه المقالة، ناقشنا التفاصيل حول كيفية تنفيذ دمج المراسلات في مستندات Word باستخدام مقتطف من التعليمات البرمجية بلغة C#. وفي الوقت نفسه، تعلمنا أيضًا خطوات دمج المراسلات باستخدام أوامر cURL. يرجى ملاحظة أن مجموعة أدوات التطوير البرمجية الخاصة بنا مبنية وفقًا لترخيص MIT، لذا فإن الكود المصدر الكامل متاح للتنزيل عبر مستودع GitHub. نقترح عليك استكشاف وثائق المنتج والتعرف على الميزات الأخرى المثيرة التي تدعمها واجهة برمجة التطبيقات.

مقالات ذات صلة

وننصحك أيضًا بزيارة الروابط التالية لمعرفة المزيد عن: