✒️ABAP / Los módulos de funciones RFC Por Sergio Beltran Castaneda

MODULO DE FUNCION RFC

Llamada de función remota (Remote Function Call - RFC) es un procedimiento para intercambiar datos entre un cliente y un servidor. Tipicamente el cliente llama a un programa residente en el servidor y éste retorna los datos mediante una conexión TCP/IP. Se puede llamar a un módulo de funciones que esté definido en SAP R/3 y utilizarlo. Para ello el módulo de funciones debe estar definido de una forma determinada. Es una buena opción, por ejemplo, si se necesita obtener cierta información que se encuentra en otro sistema. Cuando se quiera utilizar esta funcionalidad lo primero que se debe hacer es definir una RFC entre los dos sistemas.

• El RFC es un módulo de funciones individual e independiente, que no puede comunicarse con otros RFCs.
• Utiliza conceptos orientados a procedimientos.
• Dependiendo del estatus puede sufrir cambios en la interfaz y en el funcionamiento.

Para ello se utiliza la transacción SM59. Realizamos los siguientes pasos:

1. Ejecutamos la transacción SM59.
2. Pulsamos sobre el botón "CREAR" en la barra de menú.
3. Damos un nombre a nuestra RFC.
4. Seleccionamos la opción "CONNECTION TO ABAP SYSTEM" en el campo tipo de conexión.
5. Marcamos una descripción (Pequeña explicación de la RFC).
6. Rellenamos la pestaña con los datos técnicos del sistema con el que vamos a montar el RFC.
7. Finalmente en la pestaña de logon insertamos un usuario y contraseña válidos para poder establecer la conexión.

Una vez se ha definido la RFC se utilizará el botón "Test de conexión" para comprobar que funciona correctamente.

Una vez se tiene definida la RFC entre los dos sistemas se puede llamar a los módulos de funciones que tengan acceso remoto. Para ello, simplemente se añade a la llamada de la función la cláusula "DESTINATION" y el nombre del sistema fuente.

No se puede llamar a cualquier módulo de funciones, solo aquellos que estén definidos como funciones de acceso remoto. Para ello debe tener marcada la opción "Remote-Enabled Module".

Hay dos tipos de RFC, a saber, RFC transaccional (tRFC) y RFC en cola (qRFC). En el método tRFC, es posible que los paquetes no lleguen en el orden en que se hayan enviado. En el método qRFC, los paquetes llegan en el orden en que se han enviado, ya que este método utiliza colas. La etapa ABAP Extract (soporta el método de tranferencia de datos RFC) también proporciona la opción de ejecutar el programa ABAP en el sistema SAP como un proceso en segundo plano, lo que habilita características adicionales, como el uso de una variante para proporcionar parámetros de tiempo de ejecución. El método de transferencia de datos determina cómo se envían los datos desde el servidor de la aplicación SAP al destino. Puede transferir datos utilizando métodos de transferencia de datos de archivos locales, FTP o RFC. Nota: El método de transferencia de datos CPI-C está en desuso a partir de la versión 7.0.

Configurar la transferencia de datos RFC

RFC (Llamada de función remota) es el protocolo propietario de SAP que se utiliza para intercambiar datos con los sistemas SAP. La etapa ABAP Extract actúa como un sistema externo mediante la conexión a un destino RFC configurado en el sistema SAP. La etapa puede utilizar un destino existente o crear uno nuevo automáticamente.

Transferir datos a través de FTP

Puede configurar la etapa ABAP Extract para transferir los datos extraídos utilizando el protocolo FTP como una alternativa a RFC.

Transferir datos a través de archivos locales

Si el servidor SAP no es accesible de forma remota para descargar los datos utilizando los métodos de transferencia de datos RFC o FTP, puede utilizar la opción de FTP para extraer los datos en un archivo y mover el archivo de datos manualmente a una ubicación accesible desde el sistema de archivos del servidor DataStage (herramienta ETL que permite crear y mantener fácil y rápidamente almacenes de datos procedentes de sistemas de Aplicaciones Empresariales y de otros sistemas relacionados al negocio). La etapa ABAP puede entonces cargar el archivo en un paso distinto.

Configurar programas para que se ejecuten en segundo plano

Puede configurar el programa ABAP generado para que sea ejecutado como un proceso en segundo plano por el sistema SAP. Cuando el programa ABAP se configura para el proceso en segundo plano, se habilitan características adicionales específicas de SAP, tales como el registro cronológico y los informes de estado. También puede utilizar la transacción SM37 de SAP para supervisar los trabajos en segundo plano. El nombre del trabajo es el mismo que el nombre del programa ABAP generado.

TIPOS DE RFC

Para el proceso de entrada y de salida BAPI (Business Application Programming Interfaces - son las interfaces estándar de SAP), puede especificar que el proceso se maneje de forma síncrona (en que el flujo de mensajes y el adaptador deben estar disponibles durante el proceso) o de forma asíncrona (en que el adaptador no tiene que estar disponible cuando el flujo de mensajes realiza la llamada de la función). En el proceso síncrono, el flujo de mensajes espera una respuesta del adaptador. En el proceso asíncrono, la aplicación SAP no espera una respuesta y el adaptador o tiene que estar disponible cuando la aplicación SAP realiza la llamada a la función.

Sincrónica

Sintaxis: CALL FUNCTION <función> DESTINATION <destino>

[ EXPORTING <p1> = <f1> ... <pn> = <fn> ]

[ IMPORTING <p1> = <f1> ... <pn> = <fn> ]

[ TABLES <p1> = <tabla1> ... <pn> = <tablan> ]

[ CHANGING <p1> = <f1> ... <pn> = <fn> ]

[ EXCEPTIONS <p1> = <exc1l> ... <pn> = <excn> [ OTHERS = <nn>] ].

El módulo de función se ejecuta desde una fuente externa, a través de una llamada "Remote Function Call" (RFC). <destino> puede ser un literal o una variable. Dependiendo del destino especificado el módulo de función podrá ser ejecutado en un sistema R/3 o un sistema R/2. <destino> es una clave que permite al sistema saber qué sistema remoto estamos asignado. Los destinos se definen en la transacción SM59. La forma de llegar a través de los menús es la siguiente: (Pantalla inicial de SAP) -> Herramientas -> Gestión;Gestión -> Red Destinos RFC.

Hay ciertos destinos que tienen un significado especial:

NONE -> Este destino apunta al propio sistema donde se realiza la llamada al módulo de función.

BACK -> Este destino fuerza a que el programa que realiza la llamada al módulo de función tenga que ser llamado desde un sistema diferente. Si el programa se ejecuta desde el mismo sistema se produce la excepción COMMUNICATION_FAILURE.

Las cláusulas opcionales tienen el mismo significado que el de la variante 1 (llamada básica).

CALL FUNCTION <función> STARTING NEW TASK <tarea>

[ DESTINATION <destino> ]

[ DESTINATION IN GROUP { <grupo> | DEFAULT } ]

[ PERFORMING <rutina> ON END OF TASK ]

[ EXPORTING <p1> = <f1> ... <pn> = <fn> ]

[ TABLES <p1> = <tabla1> ... <pn> = <tablan> ]

[ EXCEPTIONS <p1> = <e1> MESSAGE <m1> ... <pn> = <en> MESSAGE <mm> ].

El sistema arranca el módulo de función asíncronamente en un nuevo modo. En contraste con el formato básico, esta variante hace que el sistema continué con la ejecución del programa aunque el módulo de función no haya terminado. Las cláusulas opcionales son las siguientes:

• Con la cláusula DESTINATION el módulo de función se ejecuta externamente como una "Remote Function Call" (RFC). <destino> puede ser una variable o un literal.
• Con la cláusula DESTINATION IN GROUP el módulo de función se ejecuta en todos los servidores definidos en un grupo. Los módulos de función se ejecutarán en paralelo.
• La cláusula PERFORMING nos permite controlar los errores que se puedan producir en la ejecución del módulo de función. <rutina> determina la rutina a ejecutar.
• La cláusula EXPORTING se utiliza para pasar parámetros al módulo de función, de la misma forma que en la variante 1.
• La cláusula TABLES se utiliza para pasar tablas internas al módulo de función, de la misma forma que en la variante 1.
• La cláusula EXCEPTIONS nos permite manejar dos excepciones del sistema (en ambos casos se puede utilizar la opción MESSAGE para activar un mensaje):

1. SYSTEM_FAILURE -> Si el sistema destino no funciona.
2. COMMUNICATION_FAILURE -> Si no se puede conectarnos o comunicarnos con el sistema destino.

Transaccionales

CALL FUNCTION <función> IN BACKGROUND TASK

[ AS SEPARATE UNIT ]

[ DESTINATION <destino> ]

[ EXPORTING <p1> = <f1> ... <pn> = <fn> ]

[ TABLES <p1> = <tabla1> ... <pn> = <tablan> ]

Llamada al módulo de función de modo asíncrono. Con la cláusula AS SEPARATE UNIT el módulo de función se ejecuta en una nueva LUW. El resto de las cláusulas ya han sido comentadas anteriormente.