הבאנר הראשי של 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":{}}

בקש כתובת אתר

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":""}

בקש כתובת אתר

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.

מאמרים קשורים

אנו ממליצים גם לבקר בקישורים הבאים כדי ללמוד עוד על: