دمج البريد باستخدام PHP Cloud API

[دمج البريد في Microsoft Word هي إحدى الميزات الرائعة التي تمكن المستخدمين من تحويل الرسائل إلى مستندات تبدو وكأنها مراسلات فردية. مقارنة بعملية إعداد رسائل فردية لنقل مجموعة واحدة من المعلومات إلى العديد من الأشخاص، يوفر دمج البريد الوقت والجهد، وينتج رسائل بريدية جماعية كاملة مع ملصقات أو مظاريف، ويمكنك إرسال رسالة موحدة بتفاصيل مخصصة. تشمل المزايا الأخرى لدمج البريد

• بمجرد إعداد الدمج، يمكننا إنتاج آلاف الحروف بسرعة.
• من الأسهل بكثير مراجعة رسالة واحدة بدلاً من آلاف الرسائل الفردية.
• يمكن إرسال الرسائل إلى الأشخاص الذين يستوفون معايير محددة.
• احفظ وأعد استخدام خطاب قياسي.
• تخصيص الحروف.
• مصدر البيانات نفسه وإمكانية إعادة استخدامه - مما يقلل من خطر الأخطاء.

مع الأخذ في الاعتبار أهمية هذه الميزة، يدعم Aspose.Words Cloud ميزة دمج المراسلات بشكل مثالي. كما يسمح لك بتخصيص الرسالة وفقًا لاسم المستلم. يمكن أن يكون مصدر البيانات نوعًا من القائمة أو جدول بيانات أو قاعدة بيانات مرتبطة بالمستند. في منشور المدونة هذا، سنناقش النقاط اللازمة لملء قالب دمج المراسلات أو قالب Mustache بالبيانات باستخدام لغة PHP.

دمج البريد باستخدام القالب

لاستخدام ميزة MailMerge، نحتاج إلى استخدام مستند قالب Word وملف بيانات. هاتان حجتان إدخال لـ ExecuteMailMergeOnline

أمر crul

curl -X PUT "https://api.aspose.cloud/v4.0/words/MailMerge?withRegions=false&documentFileName=template" -H  "accept: application/octet-stream" -H  "Authorization: Bearer <JWT Token>" -H  "Content-Type: multipart/form-data" -H  "x-aspose-client: Containerize.Swagger" -d {"Template":{},"Data":{}}

طلب عنوان URL

https://api.aspose.cloud/v4.0/words/MailMerge?withRegions=false&documentFileName=template

بي اتش بي

<?php 

    include(dirname(__DIR__).'\CommonUtils.php');
    use Aspose\Words\WordsApi;
    use Aspose\Words\Model\Requests;

    try {
        // إنشاء مثيل WordsApi
        $wordsApi = new WordsApi(CommonUtils::$AppSid, CommonUtils::$AppKey, CommonUtils::$ApiBaseUrl);

        $fileName = "SampleMailMergeTemplate.docx";
        $fileData = realpath(__DIR__ . '/../..').'\resources\\' . $fileName;
        $destName = "Out_TestMailMergeWithImages.docx";
        $data = realpath(__DIR__ . '/../..').'\resources\SampleMailMergeTemplateData.txt';

        // تحميل المستند إلى التخزين السحابي
        $wordsApi->uploadFile(new Requests\UploadFileRequest(realpath(__DIR__ . '/../..').'\resources\\' . $fileName, "", CommonUtils::$MyStorage));

        // إنشاء الطلب وتنفيذ طريقة API
        $request = new Requests\ExecuteMailMergeOnlineRequest($fileData, $data, null, null, null);
        $result = $wordsApi->executeMailMergeOnline($request);
        print_r($result);
    
    } catch (Exception $e) {
        echo "Something went wrong: ", $e->getMessage(), "\n";
    }
?>

إدراج HTML أثناء دمج البريد

بصرف النظر عن المحتوى البسيط، توفر واجهة برمجة التطبيقات أيضًا الإمكانيات لإدراج HTML داخل حقول دمج المراسلات. تتيح لك واجهة برمجة التطبيقات ExecuteMailMerge إدراج HTML داخل حقول دمج المراسلات. وفقًا للمثال أدناه، سنقوم بإدراج جدول HTML وصورة داخل ملف القالب وحفظ الملف الناتج في التخزين السحابي.

أمر cURL

curl -X PUT "https://api.aspose.cloud/v4.0/words/template.doc/MailMerge?withRegions=false&mailMergeDataFile=TestExecuteMailMergeData%20%281%29.txt&useWholeParagraphAsRegion=true" -H  "accept: application/json" -H  "Authorization: Bearer <JWT Token>" -H  "Content-Type: multipart/form-data" -H  "x-aspose-client: Containerize.Swagger" -d {"data":""}

طلب عنوان URL

https://api.aspose.cloud/v4.0/words/template.doc/MailMerge?withRegions=false&mailMergeDataFile=TestExecuteMailMergeData%20%281%29.txt&useWholeParagraphAsRegion=true

بي اتش بي

<?php 

    include(dirname(__DIR__).'\CommonUtils.php');
    use Aspose\Words\WordsApi;
    use Aspose\Words\Model\Requests;

    try {
        // إنشاء مثيل WordsApi
        $wordsApi = new WordsApi(CommonUtils::$AppSid, CommonUtils::$AppKey, CommonUtils::$ApiBaseUrl);

        $fileName = "template.doc";
        $destName = "Out_PostDocumentExecuteMailMergeWithHTMLData.docx";
        $data = file_get_contents(realpath(__DIR__ . '/../..').'\resources\TestPostDocumentExecuteMailMerge.txt');

        // تحميل المستند إلى التخزين السحابي
        $wordsApi->uploadFile(new Requests\UploadFileRequest(realpath(__DIR__ . '/../..').'\resources\\' . $fileName, "", CommonUtils::$MyStorage));

        // إنشاء الطلب وتنفيذ طريقة API
        $request = new Requests\ExecuteMailMergeRequest($fileName, $data, null, CommonUtils::$MyStorage, null, null, null, null, null, false, $destName);
        $result = $wordsApi->executeMailMerge($request);
        print_r($result);
    
    } catch (Exception $e) {
        echo "Something went wrong: ", $e->getMessage(), "\n";
    }
?>

خاتمة

في هذه المقالة، ناقشنا التفاصيل حول كيفية تنفيذ عملية دمج البريد باستخدام PHP Cloud SDK. لقد استكشفنا حصريًا التفاصيل ذات الصلة بتنفيذ عملية دمج البريد باستخدام قالب وكيفية إدراج HTML أثناء عملية دمج البريد. يرجى ملاحظة أن Aspose.Words Cloud SDK for PHP تم تطويره بموجب ترخيص MIT ويتوفر كود المصدر الكامل الخاص به للتنزيل عبر GitHub. في حالة مواجهة أي مشكلات أثناء استخدام SDK، فلا تتردد في الاتصال بنا عبر منتدى دعم المنتج المجاني.

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

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

• التوقيع الرقمي على مستندات PDF عبر الإنترنت باستخدام PHP
• إرسال البريد الإلكتروني باستخدام Aspose.Email Cloud في تطبيق Heroku PHP
• محول Word إلى PDF | DOC إلى PDF | DOCX إلى PDF | Zapier