MailMerge ana başlığı

Microsoft Word’ün posta birleştirme özelliği, kullanıcıların mektupları bireysel yazışmalar gibi okunan belgelere dönüştürmesini sağlayan dikkat çekici bir özelliktir. Birçok kişiye tek bir bilgi kümesi iletmek için bireysel mektuplar hazırlama süreciyle karşılaştırıldığında, posta birleştirme zamandan ve emekten tasarruf sağlar, etiketler veya zarflarla tamamlanmış toplu postalar üretir ve özelleştirilmiş ayrıntılarla birleşik bir mesaj gönderebilirsiniz. Posta Birleştirmenin diğer avantajları şunlardır:

  • Birleştirme işlemi tamamlandıktan sonra hızlı bir şekilde binlerce harf üretebiliriz.
  • Binlerce ayrı mektubu okumaktansa tek bir mektubu düzeltmek çok daha kolaydır.
  • Belirli kriterleri karşılayan kişilere mektup gönderilebilir.
  • Standart bir mektubu kaydedin ve yeniden kullanın.
  • Mektupları kişiselleştirin.
  • Aynı veri kaynağının tekrar kullanılabilmesi - hata riskini azaltır.

Bu özelliğin önemini göz önünde bulundurarak, Aspose.Words Cloud Posta Birleştirme özelliğini mükemmel bir şekilde destekler. Ayrıca mektubu alıcının adına göre kişiselleştirmenize olanak tanır. Veri kaynağı bir tür liste, elektronik tablo veya veritabanı olabilir, belgeyle ilişkilidir. Bu blog yazısında, PHP dilini kullanarak posta birleştirme veya bıyık şablonunu verilerle doldurma noktalarını tartışacağız.

Şablon kullanarak MailMerge

MailMerge özelliğini kullanmak için Word şablon belgesini ve bir veri dosyasını kullanmamız gerekir. Bunlar ExecuteMailMergeOnline için iki giriş argümanıdır

cRUL komutu

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

İstek URL’si

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 örneği oluşturun
        $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';

        // Belgeyi Cloud Depolamaya Yükle
        $wordsApi->uploadFile(new Requests\UploadFileRequest(realpath(__DIR__ . '/../..').'\resources\\' . $fileName, "", CommonUtils::$MyStorage));

        // İstek oluştur ve API metodunu çalıştır
        $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 sonuç dosyası

Şekil 1:- MailMerge işleminin önizlemesi.

Posta Birleştirme sırasında HTML Ekle

Basit içerik dışında, API ayrıca Posta Birleştirme alanlarına HTML ekleme yetenekleri de sağlar. ExecuteMailMerge API, Posta Birleştirme alanlarına HTML eklemenizi sağlar. Aşağıdaki örneğe göre, şablon dosyasına bir HTML tablosu ve resim ekleyeceğiz ve ortaya çıkan dosyayı bulut depolama alanına kaydedeceğiz.

cURL komutu

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

İstek URL’si

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 örneği oluşturun
        $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');

        // Belgeyi Cloud Depolamaya Yükle
        $wordsApi->uploadFile(new Requests\UploadFileRequest(realpath(__DIR__ . '/../..').'\resources\\' . $fileName, "", CommonUtils::$MyStorage));

        // İstek oluştur ve API metodunu çalıştır
        $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 eklemesinden sonra Posta Birleştirme önizlemesi

Şekil 2:- HTML eklemeden sonra Posta Birleştirme.

Çözüm

Bu makalede, PHP Cloud SDK kullanarak posta birleştirmenin nasıl gerçekleştirileceğiyle ilgili ayrıntıları ele aldık. Şablon kullanarak posta birleştirmenin nasıl gerçekleştirileceği ve posta birleştirme sırasında HTML’nin nasıl ekleneceğiyle ilgili ayrıntıları özel olarak inceledik. Lütfen Aspose.Words for PHP Cloud SDK’nın MIT lisansı altında geliştirildiğini ve tam kaynak kodunun GitHub üzerinden indirilebileceğini unutmayın. SDK’yı kullanırken herhangi bir sorunla karşılaşırsanız lütfen ücretsiz ürün destek forumu aracılığıyla bizimle iletişime geçmekten çekinmeyin.

İlgili Makaleler

Daha fazla bilgi edinmek için aşağıdaki bağlantıları da ziyaret etmenizi öneririz: