Основний банер MailMerge

Злиття пошти Microsoft Word є однією чудовою функцією, яка дозволяє користувачам перетворювати листи в документи, які читаються як окреме листування. Порівняно з процесом підготовки окремих листів для передачі одного набору інформації багатьом людям, злиття економить час і зусилля, створюючи масові розсилки з ярликами або конвертами, і ви можете надіслати єдине повідомлення з індивідуальними деталями. Інші переваги злиття включають

  • Щойно злиття налаштовано, ми можемо швидко створювати тисячі листів.
  • Набагато легше перевірити лише один лист, ніж тисячі окремих листів.
  • Листи можна надсилати людям, які відповідають певним критеріям.
  • Збережіть і повторно використовуйте стандартний лист.
  • Персоналізуйте листи.
  • Те саме джерело даних і використовувати його повторно - зменшуючи ризик помилок.

Зважаючи на важливість цієї функції, Aspose.Words Cloud чудово підтримує функцію злиття. Це також дозволяє персоналізувати лист відповідно до імені одержувача. Джерелом даних може бути список, електронна таблиця або база даних, пов’язана з документом. У цій публікації блогу ми обговоримо моменти заповнення шаблону злиття або вусів даними за допомогою мови PHP.

MailMerge з використанням шаблону

Щоб скористатися функцією 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';

        // Завантажте документ у Cloud Storage
        $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 під час злиття

Окрім простого вмісту, API також надає можливості для вставки HTML у поля злиття. API 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

<?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');

        // Завантажте документ у Cloud Storage
        $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";
    }
?>
Попередній перегляд злиття після вставки HTML

Рис. 2: злиття після вставки HTML.

Висновок

У цій статті ми детально обговорили, як виконати злиття за допомогою PHP Cloud SDK. Ми ексклюзивно досліджували деталі, пов’язані з виконанням злиття за допомогою шаблону та як вставити HTML під час злиття. Зауважте, що Aspose.Words Cloud SDK для PHP розроблено за ліцензією MIT, і його повний вихідний код доступний для завантаження на GitHub. Якщо під час використання SDK у вас виникнуть проблеми, зв’яжіться з нами через безкоштовний форум підтримки продуктів.

Схожі статті

Ми також рекомендуємо відвідати такі посилання, щоб дізнатися більше про: