بنر اصلی MailMerge

ادغام ایمیل Microsoft Word’s یکی از ویژگی‌های قابل توجهی است که کاربران را قادر می‌سازد تا حروف را به اسنادی تبدیل کنند که مانند مکاتبات فردی خوانده می‌شوند. در مقایسه با فرآیند آماده‌سازی نامه‌های جداگانه برای انتقال یک مجموعه اطلاعات به افراد زیادی، ادغام ایمیل باعث صرفه‌جویی در زمان و تلاش می‌شود، ارسال‌های پستی انبوه کامل با برچسب یا پاکت نامه تولید می‌شود و می‌توانید پیامی یکپارچه با جزئیات سفارشی ارسال کنید. سایر مزایای Mail Merge عبارتند از

  • هنگامی که ادغام راه اندازی شد، می توانیم به سرعت هزاران حرف تولید کنیم.
  • تصحیح فقط یک حرف بسیار ساده تر از هزاران حرف مجزا است.
  • نامه ها را می توان برای افرادی که دارای معیارهای خاصی هستند ارسال کرد.
  • یک نامه استاندارد را ذخیره و دوباره استفاده کنید.
  • شخصی سازی نامه ها
  • همان منبع داده و استفاده مجدد - کاهش خطر خطا.

با توجه به اهمیت این ویژگی، Aspose.Words Cloud کاملاً از ویژگی Mail Merge پشتیبانی می کند. همچنین به شما امکان می دهد نامه را مطابق با نام گیرنده شخصی سازی کنید. منبع داده می تواند نوعی لیست، صفحه گسترده یا پایگاه داده باشد که به سند مربوط می شود. در این پست وبلاگ، نکاتی را برای پر کردن الگوی ادغام ایمیل یا سبیل با داده ها با استفاده از زبان PHP مورد بحث قرار خواهیم داد.

Mail Merge با استفاده از الگو

برای استفاده از ویژگی 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

<?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";
    }
?>
فایل حاصل MailMerge

شکل 1: - پیش نمایش عملیات MailMerge.

درج HTML در طول Mail Merge

جدا از محتوای ساده، API قابلیت درج HTML در فیلدهای Mail Merge را نیز فراهم می کند. API ExecuteMailMerge به شما امکان می دهد HTML را در فیلدهای Mail Merge وارد کنید. طبق مثال زیر، می‌خواهیم یک جدول و تصویر 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

<?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";
    }
?>
پیش نمایش Mail Merge پس از درج HTML

شکل 2: - ادغام نامه پس از درج HTML.

نتیجه گیری

در این مقاله، جزئیات مربوط به نحوه انجام ادغام نامه با استفاده از PHP Cloud SDK را مورد بحث قرار داده ایم. ما به طور انحصاری جزئیات مربوط به انجام ادغام نامه با استفاده از یک الگو و نحوه درج HTML در طول ادغام نامه را بررسی کرده ایم. لطفاً توجه داشته باشید که Aspose.Words Cloud SDK برای PHP تحت مجوز MIT توسعه یافته است و کد منبع کامل آن برای دانلود از طریق GitHub در دسترس است. اگر هنگام استفاده از SDK با مشکلی مواجه شدید، لطفاً از طریق [تالار گفتمان پشتیبانی محصول] رایگان با ما تماس بگیرید.

مقالات مرتبط

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