MailMerge fő banner

A Microsoft Word körlevél-egyesítése az egyik figyelemre méltó funkció, amely lehetővé teszi a felhasználók számára, hogy a leveleket olyan dokumentumokká alakítsák, amelyek úgy olvashatók, mint az egyéni levelezés. Összehasonlítva azzal a folyamattal, amikor az egyes leveleket úgy készítik el, hogy egy információhalmazt sok emberhez eljuttassanak, a körlevél-összevonás időt és erőfeszítést takarít meg, tömeges küldeményeket hoz létre címkékkel vagy borítékokkal, és egységes üzenetet küldhet testreszabott részletekkel. A körlevél további előnyei közé tartozik

  • Az egyesítés beállítása után gyorsan több ezer betűt állíthatunk elő.
  • Sokkal könnyebb lektorálni egyetlen betűt, mint több ezer különálló betűt.
  • Levelet olyan személyeknek lehet küldeni, akik megfelelnek meghatározott feltételeknek.
  • Mentse el és használja fel újra a szabványos levelet.
  • A betűk személyre szabása.
  • Ugyanaz az adatforrás és újrafelhasználható – csökkentve a hibák kockázatát.

E funkció fontosságát szem előtt tartva az Aspose.Words Cloud tökéletesen támogatja a Körlevél funkciót. Lehetővé teszi a levél személyre szabását is a címzett nevének megfelelően. Az adatforrás lehet egyfajta lista, táblázat vagy adatbázis, amely a dokumentumhoz kapcsolódik. Ebben a blogbejegyzésben megvitatjuk azokat a pontokat, amelyekkel a körlevél- vagy bajuszsablonokat PHP nyelven kell adatokkal feltölteni.

MailMerge sablon használatával

A MailMerge funkció használatához a Word sablon dokumentumot és egy adatfájlt kell használnunk. Ez az ExecuteMailMergeOnline két bemeneti argumentuma

cRUL parancs

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 kérése

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 példány létrehozása
        $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';

        // Töltse fel a dokumentumot a Cloud Storage szolgáltatásba
        $wordsApi->uploadFile(new Requests\UploadFileRequest(realpath(__DIR__ . '/../..').'\resources\\' . $fileName, "", CommonUtils::$MyStorage));

        // Hozzon létre kérést és hajtsa végre az api metódust
        $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 eredményfájl

  1. ábra: A MailMerge művelet előnézete.

Szúrjon be HTML-kódot a körlevélkészítés során

Az egyszerű tartalom mellett az API azt is lehetővé teszi, hogy HTML-t illesszen be a Körlevél mezőkbe. Az ExecuteMailMerge API lehetővé teszi HTML beillesztését a körlevél mezőkbe. Az alábbi példa szerint beszúrunk egy HTML-táblázatot és képet a sablonfájlba, és az eredményül kapott fájlt felhőtárhelyre mentjük.

cURL parancsot

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 kérése

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 példány létrehozása
        $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');

        // Töltse fel a dokumentumot a Cloud Storage szolgáltatásba
        $wordsApi->uploadFile(new Requests\UploadFileRequest(realpath(__DIR__ . '/../..').'\resources\\' . $fileName, "", CommonUtils::$MyStorage));

        // Hozzon létre kérést és hajtsa végre az api metódust
        $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";
    }
?>
Körlevél előnézete HTML beillesztés után

  1. ábra: Körlevél a HTML beillesztés után.

Következtetés

Ebben a cikkben megvitattuk a PHP Cloud SDK használatával történő levelezőegyesítés végrehajtásának részleteit. Kizárólag azokat a részleteket vizsgáltuk meg, amelyek a sablon használatával történő körlevél-egyesítés végrehajtására vonatkoznak, és hogyan lehet HTML-t beszúrni a körlevél-összevonás során. Kérjük, vegye figyelembe, hogy az Aspose.Words Cloud SDK for PHP-t MIT licenc alatt fejlesztették ki, és teljes forráskódja letölthető GitHub-ről. Ha bármilyen problémába ütközik az SDK használata során, forduljon hozzánk bizalommal az ingyenes terméktámogatási fórumon.

Kapcsolódó cikkek

Javasoljuk továbbá, hogy látogassa meg az alábbi linkeket, ha többet szeretne megtudni erről: