send-mime
La función send-mime envía un correo electrónico a los destinatarios indicados (el administrador, por lo general). Antes de usar esta función, debe configurar las opciones del servidor de correo electrónico. A diferencia de la función send, el parámetro Cuerpo del mensaje de esta función le permite obtener el cuerpo del mensaje (por ejemplo, como HTML) de una secuencia.
Para crear una secuencia para el cuerpo del mensaje directamente en FlowForce, puede llamar a funciones de expresión como stream-open o stream-from-string. También puede utilizar funciones de expresión MIME para personalizar los encabezados de los mensajes de correo electrónico o de los archivos adjuntos. Para evitar que un correo electrónico termine en la carpeta de correo no deseado del destinatario, debe crear encabezados MIME de acuerdo con los requisitos del servidor o programa receptor.
Para obtener contenido HTML para el cuerpo del mensaje, se recomienda llamar a una transformación de StyleVision Server que genere resultados HTML como MIME. Para ver un ejemplo que muestra cómo implementar una transformación 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.
FlowForce Server no recopila ninguna imagen, hoja de estilo o recurso similar al que hagan referencia los archivos HTML en una secuencia MIME. Para crear el cuerpo del mensaje HTML con StyleVision Server, siga estos pasos:
1.Diseñe el cuerpo del mensaje HTML de un 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 StyleVision Server anterior, asegurándose de seleccionar la opción GenerateHtmlOutputAsMime en la página Configuración del trabajo.
4.En la página Configuración del trabajo, llame a las funciones de expresión de FlowForce Server para recuperar la secuencia MIME generada y pasarla al parámetro Cuerpo del mensaje de la función send-mime (ver 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.
Parámetros
Nombre | Tipo | Descripción |
|---|---|---|
De | cadena de texto | Parámetro obligatorio. Dirección de correo electrónico desde la que se envía el correo (por ejemplo flowforce@<nombredDeHost>). |
Para | cadena de texto | Parámetro obligatorio. La dirección de correo electrónico del destinatario. Este campo puede contener una lista separada por comas de direcciones de correo electrónico. |
Asunto | cadena de texto | Parámetro obligatorio. Asunto de un mensaje. |
Cuerpo del mensaje | secuencia | Parámetro obligatorio. Cuerpo del texto de un mensaje. |
Adjunto | secuencia de secuencias | Parámetro opcional. Archivo(s) adjunto(s) enviado(s) con un correo electrónico. Cada archivo 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 | booleano | Parámetro opcional. Este parámetro determina el resultado de un trabajo si ocurre un error. Si el parámetro de Anular en caso de error es true, la ejecución del trabajo se anula. Si el parámetro es false, FlowForce Server ignora los errores y sigue ejecutando el trabajo. El valor predeterminado es true. |
Ejemplo n°1
El trabajo que se ilustra a continuación llama a la función send-mime para enviar un correo electrónico en formato HTML.
Paso 1
El primer paso de ejecución genera resultados HTML llamando a una transformación de datos de StyleVision Server. Esta transformación se diseñó con StyleVision y, a continuación, se implementó en FlowForce Server. La función usa BiggesCities.xml como archivo de entrada. El archivo de salida es BiggestCitiesPerCity.html, que se generará como tipo MIME (la casilla GenerateHtmlOutputAsMime está seleccionada). El resultado de este paso de ejecución se denomina output y se utilizará en el siguiente paso.
Paso 2
El segundo paso de ejecución llama a la función compute para calcular la expresión nth(results(output), 0), que recoge la secuencia MIME del resultado generado por el paso anterior. El resultado del segundo paso se denomina message y se utilizará en el parámetro Cuerpo del mensaje en el último paso de ejecución.
Paso 3
El tercer paso de ejecución envía un correo electrónico con el resultado del paso anterior (message) como cuerpo del mensaje.
Ejemplo n°2
El trabajo que se ilustra a continuación llama a la función send-mime para enviar un correo electrónico en formato HTML. El correo electrónico contiene una imagen adjunta en formato .png.
El primer paso de ejecución prepara el código HTML para el cuerpo del mensaje. Para simplificar, el código HTML de este ejemplo se escribe directamente en el cuadro de texto. La forma recomendada de obtener resultados HTML es llamar a una transformación de StyleVision Server, tal y como se muestra en el ejemplo anterior. El resultado de este paso es una cadena de texto llamada body_html que se utilizará en el siguiente paso.
El segundo paso de ejecución crea el cuerpo del correo electrónico. La función stream-from-string convierte el resultado del primer paso de ejecución en una secuencia. La codificación (UTF-8) y el tipo MIME (text/html) se pasan a la función como argumentos. El resultado de este paso es message, de tipo T0 (cualquier tipo), y se utilizará en el cuerpo del mensaje en el último paso.
El tercer paso de ejecución crea un archivo adjunto del correo electrónico, también como una secuencia. El paso calcula la siguiente expresión:
add-mime-header(stream-open('C:\sample.png', 'image/png'), 'Content-Disposition', 'attachment; filename=sample.png')
La función stream-open abre la imagen como una secuencia. La función add-mime-header añade el encabezado Content-Disposition a la secuencia. El valor del encabezado Content-Disposition es 'attachment; filename=sample.png', lo que indica que sample.png se puede descargar y guardar localmente. El resultado de este paso es attachment , que se utilizará en el último paso.
El último paso envía un correo electrónico. La función send-mime utiliza el resultado del segundo paso (message) como cuerpo del mensaje. En el parámetro Adjunto, se requiere la función mime-content-encode, ya que sample.png es un archivo binario. Estos archivos deben codificarse como Base64 para que se conserven durante la transmisión.
Otro método
Otro método que puede utilizar para el trabajo descrito anteriormente consiste en utilizar la función set-mime-content-disposition en lugar de la función add-mime-header (tercer paso de ejecución más arriba). La expresión tendría este aspecto:
set-mime-content-disposition(stream-open('C:\sample.png', 'image/png'), 'attachment', 'sample.png')