{"id":14276,"date":"2020-02-14T15:12:27","date_gmt":"2020-02-14T23:12:27","guid":{"rendered":"http:\/\/clartechsolutions.com\/?p=14276"},"modified":"2023-03-01T18:09:07","modified_gmt":"2023-03-01T18:09:07","slug":"enviar-email-desde-una-aplicacion-en-apex","status":"publish","type":"post","link":"https:\/\/kiusi.com\/en\/enviar-email-desde-una-aplicacion-en-apex\/","title":{"rendered":"Enviar Email desde una Aplicaci\u00f3n en APEX"},"content":{"rendered":"

Podemos usar el paquete APEX_MAIL para enviar email desde nuestra aplicaci\u00f3n en Oracle Application Express.<\/p>\n

El paquete APEX_MAIL est\u00e1 construido sobre el paquete UTL_SMTP suministrado por Oracle. Debido a esta dependencia, el paquete UTL_SMTP debe estar instalado y en funcionamiento para usar APEX_MAIL.<\/p>\n

Como este paquete esta instalado en la instancia gratuita de APEX en la nube podemos nosotros probarlo.<\/p>\n

Para esta demostraci\u00f3n vamos a usar la aplicaci\u00f3n Demo de Application Express “Sample Database Application”. Si no la tenemos instalada en nuestro espacio de trabajo podemos acceder a la galer\u00eda de aplicaciones y de all\u00ed instalarla.<\/p>\n

Vamos a enviar un email con la confirmaci\u00f3n de la orden a los clientes, el cual ese email esta en la tabla DEMO_CUSTOMERS. El email contendr\u00e1 el enlace a la Orden realizada en APEX.<\/p>\n

Abrimos la pagina 14 de la aplicaci\u00f3n y creamos un proceso debajo de Place Order.<\/p>\n

El c\u00f3digo PL\/SQL es el que sigue:<\/p>\n

DECLARE\n\nVbody CLOB;\nVbody_html CLOB;\nVcust_email varchar2(100);\nVcust_name varchar2(100);\n\nBEGIN\n  select cust_email into Vcust_email from DEMO_CUSTOMERS \n  where customer_id = :P11_CUSTOMER_ID;\n  select CUST_FIRST_NAME into Vcust_name from DEMO_CUSTOMERS \n  where customer_id = :P11_CUSTOMER_ID;\n  Vbody := 'Para ver el contenido de este mensaje, utilice un cliente de correo \n  habilitado para HTML.'||utl_tcp.crlf;\n\n  Vbody_html := '<html>\n  <head>\n  <style type="text\/css">\n  body{font-family: Arial, Helvetica, sans-serif; font-size:10pt;margin:30px;\n  background-color:#ffffff;}\n  span.sig{font-size: 20px; font-weight:bold; color:#1C72CE;}\n  <\/style>\n  <\/head>\n  <body>'||utl_tcp.crlf;\n\n  Vbody_html := Vbody_html || 'Hola '|| Vcust_name ||','||utl_tcp.crlf||utl_tcp.crlf;\n  Vbody_html := Vbody_html ||'<p> Su orden ha sido confirmada \n  al cual puede acceder haciendo clic <a href="\/en\/'||APEX_UTIL.HOST_URL('SCRIPT')||  'f\/?p='||:APP_ID|| ':29'||':0::::P29_ORDER_ID:'||:P14_ORDER_ID ||'"> \n  aquí. <\/a><\/p>' ||utl_tcp.crlf;\n\n  Vbody_html := Vbody_html ||'<p> Saludos,<\/p>'||utl_tcp.crlf;\n  Vbody_html := Vbody_html ||' <span class="sig">Sample Demo Team<\/span><br \/>'||utl_tcp.crlf;\n  apex_mail.send(\n     p_to => Vcust_email, \n     p_from => 'miemailvalido@midominio.com', \n     p_body => Vbody,\n     p_body_html => Vbody_html,\n     p_subj => 'Confirmación de la Orden');\nEND;<\/pre>\n
Mensaje de Confirmaci\u00f3n:<\/strong> *** El email de confirmaci\u00f3n de la Orden fue enviado al cliente.<\/p>\n
Mensaje de Error:<\/strong> *** Error! Hay alg\u00fan problema enviando el email al cliente.<\/p>\n
Cuando se presione el Bot\u00f3n:<\/strong> PLACE_ORDER<\/p>\n
Como podemos ver en el c\u00f3digo PL\/SQL tenemos la declaraci\u00f3n de algunas variables. Podemos usar el tipo VARCHAR para las variable Vbody y Vbody_html.<\/p>\n
Pasar un valor a Vbody, pero no a Vbody_html da como resultado un mensaje de texto sin formato. Pasar un valor a Vbody y a Vbody_html produce un mensaje de varias partes que incluye texto sin formato y contenido HTML. La configuraci\u00f3n y las capacidades del cliente de correo electr\u00f3nico del destinatario determinan lo que se muestra. Aunque la mayor\u00eda de los clientes de correo electr\u00f3nico modernos pueden leer un correo electr\u00f3nico con formato HTML, recordemos que algunos usuarios deshabilitan esta funcionalidad para solucionar problemas de seguridad. Entonces va a depender del recipiente del email c\u00f3mo ver\u00e1 el mensaje, si tiene o no activado para ver contenido HTML o solo texto plano.<\/p>\n
Con el primer select buscamos la direcci\u00f3n de email de la orden del cliente y el segundo select guardamos el nombre del cliente en una variable.<\/p>\n
Es importante recordar que ninguna l\u00ednea individual puede superar los 1000 caracteres. La especificaci\u00f3n SMTP\/MIME dicta que ninguna l\u00ednea individual debe exceder los 1000 caracteres. Para cumplir con esta restricci\u00f3n, debemos agregar un retorno de carro o caracteres de avance de l\u00ednea para dividir los par\u00e1metros Vbody o Vbody_html en fragmentos de 1000 caracteres o menos. De lo contrario, se generan mensajes de correo electr\u00f3nico err\u00f3neos, incluidos mensajes parciales o mensajes con signos de exclamaci\u00f3n extra\u00f1os. Por eso usamos utl_tcp.crlf para este prop\u00f3sito.<\/p>\n
Por \u00faltimo se env\u00eda el email usando el procedimiento APEX_MAIL.SEND<\/strong> el cual tiene los siguientes par\u00e1metros:<\/p>\n
p_to:<\/strong>  Direcci\u00f3n de correo electr\u00f3nico v\u00e1lida a la que se env\u00eda el correo electr\u00f3nico (obligatorio). Para varias direcciones de correo electr\u00f3nico, usamos una lista separada por comas.<\/p>\n
p_from:<\/strong> Direcci\u00f3n de correo electr\u00f3nico desde la cual se env\u00eda el correo electr\u00f3nico (obligatorio). Esta direcci\u00f3n de correo electr\u00f3nico debe ser una direcci\u00f3n v\u00e1lida. De lo contrario, el mensaje no se env\u00eda<\/strong>.<\/p>\n
p_body:<\/strong> Cuerpo del correo electr\u00f3nico en texto plano, no HTML (requerido). Si se pasa un valor a Vbody_html, este es el \u00fanico texto que ve el destinatario. Si no se pasa un valor a Vbody_html, este texto solo se muestra para clientes de correo electr\u00f3nico que no admiten HTML o tienen HTML deshabilitado. Debemos incluir un retorno de carro o avance de l\u00ednea (CRLF) cada 1000 caracteres.<\/p>\n
p_body_html:<\/strong> Cuerpo del correo electrónico en formato HTML. Este debe ser un documento HTML completo que incluya las etiquetas <html> and <body>. Una sola línea no puede superar los 1000 caracteres sin un retorno de carro o avance de línea (CRLF).<\/p>\n
p_subj:<\/strong> Asunto del correo electr\u00f3nico.<\/p>\n
p_cc:<\/strong> Direcciones de correo electr\u00f3nico v\u00e1lidas a las que se copia el correo electr\u00f3nico. Para varias direcciones de correo electr\u00f3nico, usamos una lista separada por comas.<\/p>\n
p_bcc:<\/strong> Direcciones de correo electr\u00f3nico v\u00e1lidas a las que se copia en forma oculta el correo electr\u00f3nico. Para varias direcciones de correo electr\u00f3nico, usamos una lista separada por comas.<\/p>\n
p_replyto:<\/strong> Direcci\u00f3n del encabezado del correo de respuesta. Podemos usar este par\u00e1metro de la siguiente manera:<\/p>\n