Configuracin del envio de correo electrnico desdeSap.Hoy vamos a hablar de un tema antiguo y que aparece mucho en los foros, aunque, como casi siempre, con poca documentacin en castellano. Me refiero a la configuracin para permitir enviar correo electrnico desde un sistema Sap al exterior.

Desde la version 6.10 y superiores, el kernel de Sap contiene de forma nativa funciones para el procesamiento del correo via SMTP (incluidas en el ICM Internet Connection Manager). Vamos a ver la forma de preparar para que el sistema envie correo al exterior y algunos ejemplos de programacin para generar estos envios desde nuestros propios desarrollos.

Nota: hemos de tener un servidor de correo interno (propio) o externo que permita el reenvio SMTP.

Configuracin del Sistema.En la nota455140 del OSS se detallan paso por paso las tareas de configuracin del sistema.

Ejemplo de envio de correo desde cualquier transaccin:

1. Parametros del perfil de la instancia: a travs de la transaccin RZ10, incluiremos con el parmetro icm/server_port_X (donde X es un nmero secuencial para los diferentes puertos que configuremos: http, https, smtp, etc) el nmero de puerto TCP/IP (25 por defecto) y el protocolo (SMTP).

2. Activacin de servicios: a travs de la transaccin SICF, comprobaremos que tenemos nuestro nodo SMTP configurado y activado. Aqu se relaciona el servicio con el puerto del ICM que hemos configurado en el paso anterior.

3. Configuracin del Sap Connect: a travs de este paso conectamos el nivel de aplicacin (por ejemplo Sap Office) con el nivel ICM (nivel tcnico). La gestin de esta configuracin se realiza desde la transaccin SCOT. Hay que realizar la configuracin en cada mandante. Siempre se crea de forma automtica un nodo SMTP, que tendremos que ajustar para indicarle los parametros del servidor de correo saliente que utilizaremos para enviar los correos desde la pasarela Sap.

Haciendo donde clic en el nodo SMTP configuraremos la IP y el puerto del servidor de correo saliente, si hay que realizar alguna conversin de codigos de pagina (juegos de caracteres) y los tipos de direccin soportados (en este caso Internet).

A nivel de detalle, configuraremos los dominios a los que se pueden enviar correos (* sera a todos), y los formatos de envio de los documentos enviados de Sap (al enviar formulario o listados por correo, aqu indicamos en que formato se construiran los anexos que los contengan: pdf, txt, htm, etc).

La transaccin SCOT tambin nos permite monitorizar los correos que estan en cola e iniciar los procesos de envio (y planificar el Job de envio automatico de correos, que se ejecutara con la regularidad deseada para que los correos vayan saliendo de la cola interna a la cola del servidor de correo).

4. Monitorizacin del envio de correos externos: con la transaccin SOST podemos gestionar los correos que tenemos en cola para envio externo: ver correos pendientes y enviados, visualizar los mensajes, analizar errores, etc.

5. Asignacin de cuentas de correo a los usuarios del sistema: estas cuentas sern las utilidas con remitentes de los correos que salgan al exterior. Desde la transaccin SU01, habra que indicar en todos los usuarios que vayan a enviar correo su cuenta, que sea utiliza como remitente de los correos que se envien.

Envio de correo desde las aplicaciones.

Una vez realizada toda la configuracin, ya podremos enviar correos de la forma habitual:

Sap Office: desde la transaccin SBWP podremos crear nuestros mensajes, que podrn incluir usuarios Sap (que recibiran los mensajes en el propio Sap a travs de la misma transaccin) o bien a destinatarios externos (indicado su cuenta de correo electrnico).

Aplicaciones: en todos los informes donde tengamos disponible la opcin de men Lista > Enviar, podremos crear un mensaje en el cual se anexara como documento el listado o tabla ALV que estemos procesando.

Envio de correo desde nuestros desarrollos.

Tenemos multitud de formas de poder enviar correos en nuestros programas. En la Wiki del SDN de Sap hay una completa lista.

Templates de ejemplo proporcionados por Sap:

SAP provides the following programs, which are in fact templates because they can't be executed as is (email is hardcoded for example):

BCS_EXAMPLE_1: send a simple text provided as an internal table of text lines to joe.doe@crazy-company.com

BCS_EXAMPLE_2: send a simple text provided as an internal table of text lines and text attachment in form of text lines itab to fax DE 09999-123456

BCS_EXAMPLE_3: send a simple text provided in an internal table of text lines and an additional note to SY-UNAME

BCS_EXAMPLE_4: send a simple text provided in an internal table of text lines recipients are selected in dialogue (default joe.doe@crazy-company.com)

BCS_EXAMPLE_5: a simple text provided in an internal table of text lines and an attached MS word document provided in internal table SOLIX_TAB (document retrieval has to be coded) to joe.doe@crazy-company.com

BCS_EXAMPLE_6: enter customer, carrier (flight demo data) and email, and generate corresponding FP_TEST_03 adobe form, and send it as attachment to the email

SENDLIST_BCS: provided as attachment inSAP Note 190669 - Sending lists using SAPconnect, it uses SO_DOCUMENT_SEND_API1

SENDLIST_BCS: provided as attachment inSAP Note 190669 - Sending lists using SAPconnect, it uses CL_BCS

ZSSO_DOCUMENT_SEND_API1_46 and ZSSO_DOCUMENT_SEND_API1_610: provided as attachment inSAP Note 609696 - SAPoffice: Error in documentation (SO_DOCUMENT_SEND_API1). There are 2 versions, one for 4.6C, and one for 6.10 and above, the difference between the 2 is only the addition of COMMIT_WORK parameter for 6.10 version. Both call SO_DOCUMENT_SEND_API1.

RSWNSENDMAIL1: demo of SO_NEW_DOCUMENT_ATT_SEND_API1.

Ejemplos de programas del SDN, utilizando los siguientes elementos:

CL_BCS SO_DOCUMENT_SEND_API1 SO_NEW_DOCUMENT_ATT_SEND_API1 SO_NEW_DOCUMENT_SEND_API1Basicamente, tenemos programas que utilizan los mdulos de funcin (SO), que estn obsoletos (aunque se pueden utilizar) y aquellos que utilizan la programacin orientada a objetos (con la clase CL_BCS). Os recomiendo acceder a los links si quereis profundizar en los temas y analizar los ejemplos de desarrollo.

Referencias:

Postalmethods.com: configuracin del envio de correo saliente desde Sap.

Thomas Jung: envio de correo desde Abap en version 6.10 y superiores.

Thomas Jung: envio de correo desde Abap en versiones 4.6D e inferiores.

Thomas Jung: recepcion de correo en Sap y su procesamiento en Abap.

Dataxstream.com: configuracin de Sap connect.

Snippets: envio de correo desde Abap usando programacion orientada a objetos.

Wiki SDN: resumen de elementos Abap para envio de correo electronico (modulos de funcin).