Configuración del envio de correo electrónico desde   Sap.

Hoy vamos a hablar de  un tema antiguo y que aparece mucho en los foros, aunque, como casi siempre, con poca documentación en castellano. Me refiero a la configuración para permitir enviar correo electrónico 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 programación 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.

Configuración del Sistema.

En la nota 455140 del OSS se detallan paso por paso las tareas de configuración del sistema.

Ejemplo de envio de correo desde cualquier transacción:

1. Parametros del perfil de la instancia: a través de la transacción RZ10, incluiremos con el parámetro icm/server_port_X (donde X es un número secuencial para los diferentes puertos que configuremos: http, https, smtp, etc) el número de puerto TCP/IP (25 por defecto) y el protocolo (SMTP).

2. Activación de servicios: a través de la transacción 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. Configuración del Sap Connect: a través de este paso conectamos el nivel de aplicación (por ejemplo Sap Office) con el nivel ICM (nivel técnico). La gestión de esta configuración se realiza desde la transacción SCOT. Hay que realizar la configuración en cada mandante. Siempre se crea de forma automática 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 conversión de codigos de pagina (juegos de caracteres) y los tipos de dirección 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 transacción SCOT también 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. Monitorización del envio de correos externos: con la transacción SOST podemos gestionar los correos que tenemos en cola para envio externo: ver correos pendientes y enviados, visualizar los mensajes, analizar errores, etc.

5. Asignación de cuentas de correo a los usuarios del sistema: estas cuentas serán las utilidas con remitentes de los correos que salgan al exterior. Desde la transacción 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 configuración, ya podremos enviar correos de la forma habitual:

Sap Office: desde la transacción SBWP podremos crear nuestros mensajes, que podrán incluir usuarios Sap (que recibiran los mensajes en el propio Sap a través de la misma transacción) o bien a destinatarios externos (indicado su cuenta de correo electrónico).

Aplicaciones: en todos los informes donde tengamos disponible la opción 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 in SAP Note 190669 - Sending lists using SAPconnect, it uses SO_DOCUMENT_SEND_API1

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

ZSSO_DOCUMENT_SEND_API1_46 and ZSSO_DOCUMENT_SEND_API1_610: provided as attachment in SAP 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_API1

Basicamente, tenemos programas que utilizan los módulos de función (SO), que están obsoletos (aunque se pueden utilizar) y aquellos que utilizan la programación 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 : configuración 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 : configuración 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 función).