La fonction de publipostage de Microsoft Word est une fonctionnalité remarquable qui permet aux utilisateurs de transformer des lettres en documents qui se lisent comme une correspondance individuelle. Par rapport au processus de préparation de lettres individuelles pour transmettre un ensemble d’informations à plusieurs personnes, la fonction de publipostage permet de gagner du temps et des efforts, de produire des publipostages en masse avec des étiquettes ou des enveloppes, et d’envoyer un message unifié avec des détails personnalisés. Parmi les autres avantages de la fonction de publipostage, on peut citer
- Une fois la fusion mise en place, nous pouvons produire rapidement des milliers de lettres.
- Il est bien plus facile de relire une seule lettre que des milliers de lettres individuelles.
- Des lettres peuvent être envoyées à des personnes répondant à des critères spécifiques.
- Sauvegardez et réutilisez une lettre standard.
- Personnaliser les lettres.
- La même source de données peut être réutilisée, ce qui réduit le risque d’erreurs.
Compte tenu de l’importance de cette fonctionnalité, Aspose.Words Cloud prend parfaitement en charge la fonction de publipostage. Il vous permet également de personnaliser la lettre en fonction du nom du destinataire. La source de données peut être une sorte de liste, de feuille de calcul ou de base de données, liée au document. Dans cet article de blog, nous discuterons des points à prendre en compte pour remplir le modèle de publipostage ou de moustache avec des données à l’aide du langage PHP.
Publipostage à l’aide d’un modèle
Pour utiliser la fonction MailMerge, nous devons utiliser le document modèle Word et un fichier de données. Ce sont deux arguments d’entrée pour ExecuteMailMergeOnline
Commande 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 de la demande
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 {
// Créer une instance 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';
// Télécharger le document sur le stockage cloud
$wordsApi->uploadFile(new Requests\UploadFileRequest(realpath(__DIR__ . '/../..').'\resources\\' . $fileName, "", CommonUtils::$MyStorage));
// Créer une requête et exécuter une méthode 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";
}
?>
Fig 1 : Aperçu de l’opération MailMerge.
Insérer du code HTML pendant le publipostage
Outre le contenu simple, l’API offre également la possibilité d’insérer du code HTML dans les champs de publipostage. L’API ExecuteMailMerge vous permet d’insérer du code HTML dans les champs de publipostage. Comme dans l’exemple ci-dessous, nous allons insérer un tableau et une image HTML dans le fichier modèle et enregistrer le fichier résultant dans un stockage cloud.
Commande 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 de la demande
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 {
// Créer une instance 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');
// Télécharger le document sur le stockage cloud
$wordsApi->uploadFile(new Requests\UploadFileRequest(realpath(__DIR__ . '/../..').'\resources\\' . $fileName, "", CommonUtils::$MyStorage));
// Créer une requête et exécuter une méthode 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";
}
?>
Fig 2 : Fusion de courrier après insertion HTML.
Conclusion
Dans cet article, nous avons abordé en détail la manière d’effectuer un publipostage à l’aide de PHP Cloud SDK. Nous avons exploré en exclusivité les détails relatifs à l’exécution d’un publipostage à l’aide d’un modèle et à l’insertion de code HTML lors du publipostage. Veuillez noter qu’Aspose.Words Cloud SDK pour PHP est développé sous licence MIT et que son code source complet est disponible en téléchargement sur GitHub. Si vous rencontrez des problèmes lors de l’utilisation du SDK, n’hésitez pas à nous contacter via le forum d’assistance produit gratuit.
Articles connexes
Nous vous recommandons également de visiter les liens suivants pour en savoir plus sur :