Habilite JavaScript para visualizar esta página.

Altova FlowForce Server 2020 Advanced Edition

Ruta completa: /system/mail/send-mime

 

Enviar un correo electrónico al destinatario indicado, que suele ser el administrador.

 

Nota: Nota: antes de usar esta función debe comprobar si las opciones del servidor de correo electrónico están configuradas correctamente (véase Definir parámetros de correo electrónico).

 

Esta función devuelve TRUE si la ejecución finaliza correctamente. Si hay un error de ejecución, el resultado dependerá del valor del parámetro Anular en caso de error:

 

Si el parámetro Anular en caso de error es TRUE (predeterminado), la ejecución del trabajo se anula. Cuando esto ocurra, podrá seguir controlando errores por medio de bloques protegidos (véase Control de errores).

Si el parámetro Anular en caso de error es FALSE, la función devuelve FALSE.

 

Al contrario que con la función send, el parámetro cuerpo del mensaje de esta función espera una expresión que produzca una secuencia en lugar de una cadena de texto. Esto permite obtener el cuerpo del mensaje (por ejemplo, como HTML) de una secuencia.

 

Para obtener contenido HTML para el cuerpo del mensaje es recomendable llamar a una transformación de StyleVision Server que produzca resultados HTML como MIME. FlowForce Server no recopila ninguna imagen, hoja de cálculo ni recursos parecidos a los que puedan hacer referencia los archivos HTML contenidos en una secuencia MIME independiente.

 

Para producir un cuerpo de mensaje HTML independiente con StyleVision Server siga estos pasos:

 

1. Diseñe el cuerpo del correo electrónico en Altova StyleVision. El diseño puede contener imágenes y hojas de cálculo locales.

2. Implemente la transformación de StyleVision en FlowForce Server. En FlowForce la transformación se convierte en una función integrada de FlowForce que se puede ejecutar en StyleVision Server.

3. Cree un trabajo que llame a la transformación de StyleVision Server antes mencionada y asegúrese de seleccionar la opción GenerateHtmlOutputAsMime en la página de configuración del trabajo.

4. En la página de configuración del trabajo, llame a las funciones de expresión de FlowForce Server para que recojan la secuencia MIME generada y la pasen al parámetro "Cuerpo del mensaje" de la función send-mime (véase el ejemplo 1,más abajo).

 

Si hay recursos externos a los que el archivo HTML hace referencia que no se pueden incrustar en la secuencia MIME, se añadirán al correo electrónico como archivos adjuntos.

 

A continuación se muestra un trabajo de ejemplo que produce resultados HTML como una secuencia MIME. Para ver un ejemplo paso a paso de cómo implementar transformaciones de datos de StyleVision en FlowForce Server consulte Crear un trabajo a partir de una transformación de StyleVision. Para más información sobre la integración con StyleVision Server consulte Integración con otros servidores de Altova.

 

Para crear la secuencia para el cuerpo del mensaje directamente en FlowForce también puede llamar a funciones de expresión como stream-open o stream-from-string. Asimismo puede usar funciones de expresión MIME para personalizar el correo electrónico o los encabezados de mensaje de los adjuntos.

 

Para evitar que el correo electrónico acabe en la carpeta de correo no deseado del destinatario debe construir los encabezados MIME de forma que puedan llegar correctamente al servidor o programa de destino.

 

Parámetros

Nombre

Tipo

Descripción

De

string

Dirección de correo electrónico desde la que se envía el correo (por ejemplo flowforce@<hostname>).

Para

string

Dirección de correo electrónico del destinatario. Obligatorio.

Asunto

string

Texto del asunto del mensaje. Obligatorio.

Cuerpo del mensaje

stream

El texto del cuerpo del mensaje, como expresión de FlowForce que devuelve un tipo de secuencia.

Adjunto

sequence of stream

Archivo adjunto que se debe enviar en el correo electrónico. Cada adjunto debe ser una expresión de FlowForce que produce una secuencia. Llame a funciones de secuencia para crear secuencias a partir de cadenas de texto o archivos. Llame a funciones de expresión MIME para añadir, modificar o eliminar encabezados MIME.

Anular en caso de error

boolean

Este parámetro binario determina el valor que se debe devolver si falla el trabajo. Si este parámetro es FALSE, la función devolverá FALSE también. Si este parámetro es TRUE, la ejecución del trabajo se anulará. El valor predeterminado es TRUE.

 

Ejemplos

Ejemplo 1: El trabajo que se ilustra a continuación invoca a la función send-mime para enviar un correo electrónico en formato HTML.

 

El primer paso de ejecución genera resultados HTML llamando a transformaciones de StyleVision Server. Esta transformación se diseñó con StyleVision y después se implementó en FlowForce Server, como se muestra en el apartado Crear un trabajo a partir de una transformación de StyleVision. Observe que la casilla GenerateHtmlOutputAsMime está marcada. Además, el resultado del primer pasos de ejecución se llamó "output" (necesitaremos esta cadena de texto en un paso posterior; para referirse a ella, teclee "output" dentro de una expresión.

 

El segundo paso de ejecución llama a la función compute para calcular una expresión de FlowForce. La expresión nth(results(output), 0) recoge la secuencia MIME con índice 0 (en este caso, OutHtml) del resultado generado por el paso anterior.

 

Por último, el tercer paso de ejecución envía el mensaje del correo electrónico. El campo "Cuerpo del mensaje" también contiene una expresión de FlowForce, que en este caso es el resultado calculado anteriormente en el paso 2.

 

fs_send_mime_example1

Ejemplo 2: El trabajo que se ilustra a continuación invoca a la función send-mime para enviar un correo electrónico en formato HTML que también contiene un archivo adjunto que es una imagen en formato .png.

 

El primer paso de ejecución prepara el cuerpo del mensaje. Para simplificar hemos introducido el código HTML de este ejemplo directamente en la caja de texto. La forma recomendada de obtener resultados HTML es llamar a una transformación de StyleVision, como se muestra en el ejemplo anterior.

 

El campo "Cuerpo del mensaje" contiene una expresión de FlowForce. La expresión convierte el resultado del primer paso de ejecución (de tipo cadena) en una secuencia. Se llama a la función stream-from-string justamente para obtener ese resultado. La codificación y el tipo de MIME deseados se pasan a la función como argumentos.

 

La imagen adjunta se toma de una ruta local: C:\sample.png.

fs_send_mime_example_cut

Observe que hemos cortado la imagen anterior para que encaje en una página de impresión. El campo "Adjunto" contiene la siguiente expresión:

 

add-mime-header(stream-open('C:\sample.png', 'image/png'), 'Content-Disposition', 'attachment; filename=''sample.png')

 

La expresión anterior hace lo siguiente:

 

La función stream-open abre la imagen como secuencia

La función add-mime-header añade el encabezado "Content-Disposition" a la secuencia. De esta forma, la imagen adjunta tendrá el nombre que queremos ("sample.png").

© 2019 Altova GmbH