Combinar correspondencia en un documento de Word

Combinar correspondencia de documentos de Word en línea

La combinación de correspondencia es la forma más sencilla de generar un conjunto de documentos que sean idénticos, salvo por cierta información, como el nombre y la dirección del destinatario. Muchas organizaciones se comunican con sus clientes o miembros mediante cartas, boletines informativos y piezas promocionales mediante la combinación de correspondencia, por lo que en este artículo analizaremos en detalle cómo combinar documentos de Word mediante la API REST de C#.

API de combinación de correspondencia

Aspose.Words Cloud ofrece la posibilidad de crear un nuevo documento de Word, abrir un documento existente o convertirlo a PDF, XPS, SVG, EPUB y otros formatos. Como nuestra API está desarrollada según la arquitectura REST, no necesita preocuparse por limitaciones de lenguaje o plataforma. Ahora, para usar la API en la aplicación C# .NET, instale Aspose.Words Cloud SDK para .NET con el siguiente comando:

 Install-Package Aspose.Words-Cloud

Después de la instalación, necesitamos registrar una cuenta gratuita en Aspose.Cloud dashboard usando GitHub o una cuenta de Google o simplemente registrarnos y obtener nuestras credenciales de cliente.

Completar una plantilla de combinación de correspondencia en C#

Siga los pasos que se indican a continuación para completar la plantilla de combinación de correspondencia utilizando un archivo de datos.

String MyClientID = "c235e685-1aab-4cda-a95b-54afd63eb87f"; // Get MyClientID from https://dashboard.aspose.cloud/
String MyClientSecret = "b8da4ee37494f2ef8da3c727f3a0acb9"; // Get MyClientSecret from https://dashboard.aspose.cloud/

// Cree una instancia de la clase Configuration y proporcione su ID de cliente personalizada y los detalles del secreto de cliente
var config = new Configuration { ClientId = MyClientID, ClientSecret = MyClientSecret };
// Inicializar el objeto WordsAPI mediante la instancia de configuración
var wordsApi = new WordsApi(config);
// primer documento de entrada
string inputDocument = "SampleMailMergeTemplate.docx";
string inputDataFile = "SampleMailMergeTemplateData.txt";
// nombre del archivo resultante
string resultantFile = "TestPostDocumentExecuteMailMerge.docx";
// Leer el contenido del archivo de datos
string data = File.ReadAllText("/Downloads/" + inputDataFile, System.Text.Encoding.UTF8);
// Cree un objeto ExecuteMailMergeRequest proporcionando detalles del archivo de entrada, el archivo de datos y la salida resultante
Requests.ExecuteMailMergeRequest request = new Requests.ExecuteMailMergeRequest(inputDocument, data, null, null, null, null, null, null, null, null, resultantFile);
// Realizar la operación de combinación de correspondencia
DocumentResponse result = wordsApi.ExecuteMailMerge(request);

Combinar correspondencia en Word con el comando cURL

Los comandos cURL también son una forma conveniente de acceder a las API REST. Dado que Aspose.Words Cloud se desarrolló sobre la arquitectura de API REST, podemos acceder fácilmente a las API a través de los comandos cURL. Ahora, como requisito previo, necesitamos generar un token de acceso JWT basado en los detalles de ID de cliente y Secreto de cliente.

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=c235e685-1aab-4cda-a95b-54afd63eb87f&client_secret=b8da4ee37494f2ef8da3c727f3a0acb9" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

Para obtener más detalles, visite Cómo obtener un token JWT usando un ID de cliente y una clave secreta de cliente.

Una vez que tenemos el token de acceso JWT, podemos usar el siguiente comando cURL para completar la plantilla de combinación de correspondencia. Cargamos los datos desde un archivo de texto.

  • La API ExecuteMailMerge realiza la operación principal.
  • SampleMailMergeTemplate.docx es la plantilla de combinación de correspondencia de entrada disponible en el almacenamiento en la nube.
  • Usamos el parámetro -F para cargar datos de entrada desde el archivo SampleMailMergeTemplateData.txt.
  • El archivo resultante proporcionado contra el parámetro destFileName se almacenará en el almacenamiento en la nube.
curl -v "https://api.aspose.cloud/v4.0/words/SampleMailMergeTemplate.docx/MailMerge?withRegions=false&destFileName=TestPostDocumentExecuteMailMerge.docx" \
-X PUT  \
-F data=@/Downloads/SampleMailMergeTemplateData.txt \
-H "Content-Type: multipart/form-data" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>"
Vista previa de combinación de correspondencia

Imagen 1: Vista previa del documento después de una operación de combinación de correspondencia.

Los archivos de muestra del ejemplo anterior están disponibles en los siguientes enlaces

Conclusión

En este artículo, analizamos en detalle cómo combinar correspondencia en documentos de Word mediante un fragmento de código de C#. Al mismo tiempo, también aprendimos los pasos para combinar correspondencia mediante comandos cURL. Tenga en cuenta que nuestro SDK está creado de acuerdo con la licencia MIT, por lo que su código fuente completo está disponible para descargar en el repositorio GitHub. Le sugerimos que explore la Documentación del producto y conozca otras funciones interesantes compatibles con la API.

Artículos relacionados

También recomendamos visitar los siguientes enlaces para conocer más sobre: