¿Qué es la combinación de correspondencia?
La combinación de correspondencia es un método para leer datos de una fuente y reemplazar las variables correspondientes en otro documento. Generalmente requiere dos archivos: uno para almacenar los campos de combinación (las variables que contienen los datos a insertar) y otro que contiene las instrucciones para formatear los datos de las variables y la información que será idéntica en todos los resultados de la combinación.
Por ejemplo, los datos se leen de una base de datos, JSON, CSV, hojas de cálculo de Excel, Google Sheets u otros formatos de datos estructurados y se insertan en una plantilla de documento existente para correos electrónicos, facturas o cualquier otro documento que requiera la introducción de datos dinámicos. Las plantillas suelen ser documentos de Word, PDF, correos electrónicos, cartas modelo, etc.
¿Cómo crear una plantilla usando la sintaxis Mustache?
Crear plantillas de Word con Mustache requiere cierto conocimiento de códigos básicos. Si bien Mustache no es una sintaxis de plantillas propiamente dicha, puede ser útil para crear plantillas avanzadas que se pueden usar para la combinación de correspondencia. Veamos el siguiente ejemplo para comprender cómo la sintaxis de Mustache puede ayudarnos a crear excelentes plantillas.
En la plantilla de factura anterior, se puede apreciar que está diseñada completamente con la sintaxis Mustache. Esta plantilla de Word utiliza Mustache para diseñar encabezados, cuerpo, pie de página e incluso tablas dinámicas.
Veamos cómo cada sintaxis ayuda a completar los datos para generar una factura dinámica.
Encabezamiento
{} - Marca el inicio de un encabezado. Sintaxis que se debe agregar dentro de la región del encabezado {{/foreach header}} - Cierra el encabezado
Cuerpo - Obligatorio
{} - Marca el comienzo del contenido en el cuerpo del documento {{/foreach body}} - Marca el final del cuerpo del documento
Pie de página
{} - Establece el inicio del pie de página del documento. La sintaxis debe agregarse dentro de la región del pie de página. {{/foreach footer}} - Establece el final del pie de página del documento.
Puedes pasar los datos a la plantilla Mustache como JSON para la factura de ejemplo anterior. A continuación, se muestran los datos de ejemplo para generar documentos para la plantilla anterior.
{ "Documentos": [ { "encabezado": { "docType": "Copia original" }, "cuerpo": { "Columna1": "Cantidad", "Columna2": "Descripción", "Columna3": "Precio unitario", "Columna4": "Total", "Factura": { "número": 14957, "fecha": "25-02-2022", "instrucciones": "Instrucción Factura 1", "subtotal": 200150, "impuesto": "18%", "fecha de vencimiento": "25-03-2022", "envío": "200" }, "Facturador": { "teléfono": "989797", "fax": "998463", "correo electrónico": "[email protected]", "web": "www.doc1.com", "dirección": { "empresa": "Organización 1", "calle": "Calle 1", "ciudad": "Ciudad 1", "código postal": "123456" } }, "Destinatario": { "nombre": "recibo 1", "dirección": { "calle": "testveien 3 ", "ciudad": "Ciudad 1", "código postal": "0555", "país": "País 1" } }, "Producto": [ { "cantidad": 1, "descripción": "artículo 1", "precio unitario": 45, "precio total": 867 }, { "cantidad": 2, "descripción": "artículo 2", "precio unitario": 123, "precio total": 3464 }, { "cantidad": 3, "descripción": "artículo 3", "precio unitario": 323, "precio total": 6564 } ] }, "pie de página": { "teléfono": "teléfono123", "fax": "fax123", "correo electrónico": "[email protected]", "web": "www.123.com" }
} ] }
Sentencias IF en plantillas
Microsoft Word permite usar campos de combinación de correspondencia y etiquetas Mustache con la instrucción IF . Son útiles al generar documentos con valores condicionales. El campo de combinación IF evita espacios no deseados cuando no se cumple una condición o el valor está vacío.
{ SI [Condición] [Valor de visualización 1] [Valor de visualización 2] }
P.ej
Ejemplos para empezar
Descargar la plantilla de ejemplo Descargar el archivo JSON de datos de ejemplo