Sintaxis de Mail Merge Plantilla a partir de Mustache
Aspose.Words le permite crear plantillas con sintaxis mustache además de las plantillas familiares. A Mustache es una variante alternativa de la sintaxis de la plantilla que consta de nombres de etiquetas encerrados y respaldados por un objeto modelo que contiene los datos de la plantilla.
La sintaxis Mustache es la única opción que se puede usar con plantillas que no contienen campos, como las plantillas HTML y TXT. Con las plantillas de Word, tiene dos opciones para usar campos o sintaxis Mustache.
La sintaxis Mustache admite la etiqueta foreach, que es una alternativa para usar Mail Merge con regiones. Entonces, el beneficio es que puede usar la sintaxis mustache si por alguna razón no puede o simplemente no desea usar campos de combinación y regiones de combinación.
También puede combinar los campos Mail Merge con algunos campos adicionales utilizando la etiqueta foreach como se muestra en la imagen a continuación.
Crear una plantilla Mustache
El primer punto importante a aclarar es que Mustache no es un motor de plantillas. Mustache es otra variante de sintaxis que está disponible para cualquier plantilla en un formato de carga compatible con Aspose.Words. Por lo tanto, puede crear dicha plantilla tanto mediante programación como a través de una interfaz, solo necesita incluir cierta sintaxis y cumplir con la especificación Mustache.
Supongamos que necesita enviar el mismo correo electrónico a 50 destinatarios para personalizar el saludo con sus nombres correspondientes. Puede reemplazar el nombre del destinatario por un marcador de posición como el siguiente:
Dear {{FirstName}}
I hereby…
La pregunta aquí: ¿cómo puede crear 50 correos electrónicos a partir de 1 sola plantilla Mustache? Para responder a eso, debe realizar un Mail Merge con regiones para llenar las llaves para los marcadores de posición en la plantilla con datos reales y generar un documento de salida.
Trabajar con la sintaxis Mustache
Mustache se representa como un orden sin lógica, ya que carece de declaraciones de flujo de control específicas, como for bucles y if y else condiciones. Pero puede usar las etiquetas de sección procesando listas y lambdas para lograr una evaluación condicional y un bucle. Entonces, para incluir la sintaxis Mustache dentro de la operación Mail Merge, deberá usar la propiedad UseNonMergeFields y establecer su valor en True.
El siguiente ejemplo de código muestra cómo reemplazar las etiquetas Mustache con datos específicos:
Puede notar la diferencia entre el documento antes de ejecutar Mail Merge con regiones junto con la aplicación de la propiedad UseNonMergeFields:
{{#foreach list}} comienza una sección “foreach” mientras que {{/foreach list}} la finaliza.
Y después de aplicar el Mail Merge con regiones:
Use los campos IF para Hacer que Mail Merge Sea Inteligente
Aspose.Words le permite usar Mail Merge campos y Mustache etiquetas con la instrucción IF. Los campos IF se pueden usar en cualquier documento Mail Merge para suprimir espacios y comas no deseados si un campo está en blanco.
La fórmula del campo IF se muestra a continuación:
{ IF [Condition] [Display Result 1] [Display Result 2] }
Aquí, la Condición puede ser un campo de combinación o una etiqueta Mustache.
Por ejemplo, puede usar los campos IF si necesita insertar “su”, “ella”, " él " o “ella” según el género de la siguiente manera:
{ IF { MERGEFIELD Gender } = “MALE” “texto verdadero” " texto falso"}
{ IF “{{ GENDER }}” = “MALE” “texto verdadero” " texto falso"}
El siguiente ejemplo de código muestra cómo realizar una operación Mail Merge con Mustache etiquetas y IF campos:
Puede notar la diferencia entre el documento antes de aplicar la propiedad UseNonMergeFields:
Y después de aplicar la propiedad UseNonMergeFields:
