Banner principale di MailMerge

La stampa unione di Microsoft Word è una caratteristica notevole che consente agli utenti di trasformare le lettere in documenti che si leggono come corrispondenza individuale. Rispetto al processo di preparazione di singole lettere per trasmettere un set di informazioni a molte persone, la stampa unione consente di risparmiare tempo e fatica, producendo mailing di massa completi di etichette o buste, e puoi inviare un messaggio unificato con dettagli personalizzati. Altri vantaggi della stampa unione includono

  • Una volta impostata la fusione, possiamo produrre rapidamente migliaia di lettere.
  • È molto più facile correggere una sola lettera che migliaia di lettere singole.
  • Le lettere possono essere inviate a persone che soddisfano criteri specifici.
  • Salva e riutilizza una lettera standard.
  • Personalizza le lettere.
  • Stessa fonte di dati e riutilizzabile, riducendo il rischio di errori.

Tenendo presente l’importanza di questa funzionalità, Aspose.Words Cloud supporta perfettamente la funzionalità di unione di posta. Consente inoltre di personalizzare la lettera in base al nome del destinatario. La fonte dati può essere una sorta di elenco, foglio di calcolo o database, è correlata al documento. In questo post del blog, discuteremo i punti per popolare il modello di unione di posta o baffi con dati utilizzando il linguaggio PHP.

Stampa unione tramite modello

Per utilizzare la funzionalità MailMerge, dobbiamo usare il documento modello di Word e un file di dati. Questi sono due argomenti di input per ExecuteMailMergeOnline

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

Richiedi URL

https://api.aspose.cloud/v4.0/words/MailMerge?withRegions=false&documentFileName=template

Codice PHP

<?php 

    include(dirname(__DIR__).'\CommonUtils.php');
    use Aspose\Words\WordsApi;
    use Aspose\Words\Model\Requests;

    try {
        // Crea istanza 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';

        // Carica il documento su Cloud Storage
        $wordsApi->uploadFile(new Requests\UploadFileRequest(realpath(__DIR__ . '/../..').'\resources\\' . $fileName, "", CommonUtils::$MyStorage));

        // Crea richiesta ed esegui metodo 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";
    }
?>
File risultante di MailMerge

Fig 1:- Anteprima dell’operazione MailMerge.

Inserisci HTML durante la stampa unione

Oltre al semplice contenuto, l’API fornisce anche la possibilità di inserire HTML nei campi Mail Merge. L’API ExecuteMailMerge consente di inserire HTML nei campi Mail Merge. Come nell’esempio seguente, inseriremo una tabella HTML e un’immagine nel file modello e salveremo il file risultante nell’archiviazione cloud.

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

Richiedi URL

https://api.aspose.cloud/v4.0/words/template.doc/MailMerge?withRegions=false&mailMergeDataFile=TestExecuteMailMergeData%20%281%29.txt&useWholeParagraphAsRegion=true

Codice PHP

<?php 

    include(dirname(__DIR__).'\CommonUtils.php');
    use Aspose\Words\WordsApi;
    use Aspose\Words\Model\Requests;

    try {
        // Crea istanza 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');

        // Carica il documento su Cloud Storage
        $wordsApi->uploadFile(new Requests\UploadFileRequest(realpath(__DIR__ . '/../..').'\resources\\' . $fileName, "", CommonUtils::$MyStorage));

        // Crea richiesta ed esegui metodo 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";
    }
?>
Anteprima di unione di posta dopo l'inserimento HTML

Fig 2:- Unione di posta dopo l’inserimento di HTML.

Conclusione

In questo articolo, abbiamo discusso i dettagli su come eseguire la stampa unione utilizzando PHP Cloud SDK. Abbiamo esplorato esclusivamente i dettagli pertinenti all’esecuzione della stampa unione utilizzando un modello e come inserire HTML durante la stampa unione. Si prega di notare che Aspose.Words Cloud SDK per PHP è sviluppato con licenza MIT e il suo codice sorgente completo è disponibile per il download su GitHub. In caso di problemi durante l’utilizzo dell’SDK, non esitate a contattarci tramite il forum di supporto prodotto gratuito.

Articoli correlati

Ti consigliamo inoltre di visitare i seguenti link per saperne di più: