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

        // ატვირთეთ დოკუმენტი 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-ის ჩასმის შესაძლებლობას Mail Merge ველებში. ExecuteMailMerge API საშუალებას გაძლევთ ჩასვათ 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-ის გამოყენებისას რაიმე პრობლემას წააწყდებით, გთხოვთ, მოგერიდებათ დაგვიკავშირდეთ უფასო [პროდუქტის მხარდაჭერის ფორუმის] მეშვეობით 5.

დაკავშირებული სტატიები

ჩვენ ასევე გირჩევთ ეწვიოთ შემდეგ ბმულებს მეტის გასაგებად: