La combinación de correspondencia de Microsoft Word1 es una característica notable que permite a los usuarios convertir cartas en documentos que se leen como correspondencia individual. En comparación con el proceso de preparar cartas individuales para transmitir un conjunto de información a muchas personas, la combinación de correspondencia ahorra tiempo y esfuerzo, ya que produce correos masivos completos con etiquetas o sobres, y puede enviar un mensaje unificado con detalles personalizados. Otros beneficios de la combinación de correspondencia incluyen:
- Una vez configurada la fusión, podemos producir rápidamente miles de cartas.
- Es mucho más fácil corregir una sola carta que miles de cartas individuales.
- Se pueden enviar cartas a personas que cumplan criterios específicos.
- Guarde y reutilice una carta estándar.
- Personaliza letras.
- La misma fuente de datos se puede reutilizar, lo que reduce el riesgo de errores.
Teniendo en cuenta la importancia de esta función, Aspose.Words Cloud es compatible perfectamente con la función de combinación de correspondencia. También le permite personalizar la carta según el nombre del destinatario. La fuente de datos puede ser una especie de lista, hoja de cálculo o base de datos relacionada con el documento. En esta publicación del blog, analizaremos los puntos para completar la plantilla de combinación de correspondencia o bigote con datos utilizando el lenguaje PHP.
Combinar correspondencia mediante plantilla
Para utilizar la función MailMerge, necesitamos utilizar el documento de plantilla de Word y un archivo de datos. Estos son dos argumentos de entrada para 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":{}}
URL de solicitud
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 {
// Crear una instancia de 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';
// Subir documento al almacenamiento en la nube
$wordsApi->uploadFile(new Requests\UploadFileRequest(realpath(__DIR__ . '/../..').'\resources\\' . $fileName, "", CommonUtils::$MyStorage));
// Crear solicitud y ejecutar método 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:- Vista previa de la operación MailMerge.
Insertar HTML durante la combinación de correspondencia
Además de contenido simple, la API también proporciona la capacidad de insertar HTML dentro de los campos de combinación de correspondencia. La API ExecuteMailMerge le permite insertar HTML dentro de los campos de combinación de correspondencia. Como en el ejemplo siguiente, vamos a insertar una tabla HTML y una imagen dentro del archivo de plantilla y guardar el archivo resultante en el almacenamiento en la nube.
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":""}
URL de solicitud
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 {
// Crear una instancia de 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');
// Subir documento al almacenamiento en la nube
$wordsApi->uploadFile(new Requests\UploadFileRequest(realpath(__DIR__ . '/../..').'\resources\\' . $fileName, "", CommonUtils::$MyStorage));
// Crear solicitud y ejecutar método 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:- Combinación de correspondencia después de la inserción de HTML.
Conclusión
En este artículo, analizamos los detalles sobre cómo realizar la combinación de correspondencia con PHP Cloud SDK. Hemos explorado exclusivamente los detalles pertinentes a la realización de la combinación de correspondencia con una plantilla y cómo insertar HTML durante la combinación de correspondencia. Tenga en cuenta que Aspose.Words Cloud SDK para PHP está desarrollado bajo licencia MIT y su código fuente completo está disponible para descargar en GitHub. En caso de que tenga algún problema al utilizar el SDK, no dude en ponerse en contacto con nosotros a través del foro de soporte del producto gratuito.
Artículos relacionados
También recomendamos visitar los siguientes enlaces para conocer más sobre: