1. ¿Qué es un módulo de funciones RFC?
Los módulos de funciones RFC
Consiste en una llamada a un módulo de funciones que existen un sistema SAP o no SAP, distinto al sistema del programa en donde se realiza la llamada del módulo de funciones.
Es decir, en un programa ABAP llamamos a un módulo de funciones que no existe en el sistema donde nos encontramos sino que existe en otro sistema SAP o no SAP con el que nos comunicamos.
El objetivo principal de los módulos de funciones RFC es acceder a otros ambientes del sistema para obtener datos.
La comunicación puede darse entre sistemas SAP o entre un sistema SAP y otro sistema que no sea SAP.
Para llamar a un modo de funciones RFC se debe agregar la cláusula DESTINATION al momento de declarar el módulo de funciones.
El módulo de funciones RFC llamado no existe en el sistema origen pero sí debe existir en el sistema destino.
Veamos un ejemplo simple de cuando utilizaríamos un módulo de funciones RFC:
Si necesitamos leer un registro de datos de un cliente que esta en el sistema o ambiente DTR, a través de un programa ABAP en el sistema DCR, entonces crearíamos un módulo de funciones RFC en el ambiente DTR que devuelva los registros de cliente.
Luego llamariamos a ese módulo de funciones en el ambiente DCR, utilizado un destino que previamente hemos creado a travé de la transacción estándar SM59.
En el ambiente DTR creamos el módulo de funciones RFC.
FUNCTION ZOBTENER_CLIENTES
"Leemos el registro cliente.
ENDFUNCTION.
En el ambiente DCR llamamos al módulo de funciones RFC:
CALL FUNCTION 'ZOBTENER_CLIENTES'
| DESTINATION |
V_DCR |
| EXPORTING |
KUNNR=V_CLIENTE |
| TABLES |
CUSTOMER=TI_CLIENTES |
| EXCEPCT |
NO_RECORD_FOUND=01 |
Si se produjera un error en la ejecución de un módulo de funciones RFC, entonces los mensajes de error serán devueltos por el sistema remoto y alojados en las siguientes variables de sistema:
- SY-MSGID
- SY-MSGTY
- SY-MSGNO
- SY-MSGV1
- SY-MSGV2
- SY-MSGV3
- SY-MSGV4
2. ¿Cómo crear un módulo de funciones RFC?
Un módulo de funciones RFC se crea de la misma manera que se crea un módulo de funciones normal.
Debemos acceder a la biblioteca de funciones correspondiente a la transacción estándares SE37 y completar los mismos parámetros que se completaron para crear un módulo de funciones normal, a excepción de que se debe seleccionar en la solapa Atributos la opción Módulo de acceso remoto.
Los parámetros que se crean en un módulo de funciones RFC no se pueden pasar por referencia, sino que deben pasarse por valor. Esto se logra tildando el check Transportar valores para cada parámetro en las solapas IMPORT, EXPORT y CHANGING.
Los módulos de funciones creados como RFC, pueden ser utilizados como módulos de funciones normales. Esto se logra de dos maneras diferentes:
- Utilizando la declaración CALL FUNCTION DESTINATION 'NONE'
- Utilizando la declaración de un módulo de función normal, sin el agregado de la cláusula DESTINATION.
3. Los tipos de módulos de funciones RFC
Existen tres tipos de módulos de funciones RFC:
- Sincrónicos: en donde ambos sistemas, es decir el sistema origen y el sistema de destino, deben estar disponibles al momento de la llamada del módulo de funciones. Estos módulos de funciones RFC están basados en una comunicación sincrónica.
Generalmente utilizaremos el tipo de módulos de funciones RFC sincrónico para la mayoría de nuestros desarrollos en ABAP.
- Transaccionales: en donde los sistemas de origen y de destino no necesitan estar disponibles al momento de la llamada al módulo de funciones. Un único ID de transacciones generado y los programas llamados son almacenados en el sistema junto con los datos.
Para crear un módulo de funciones RFC transaccional debemos utilizar el sufijo IN BACKGROUND TASK.
En los módulos de funciones RFC transaccionales, el sistema deja un log con el pedido de la llamada remota en las tablas base de datos estándar de SAP ARFCSSTATE y ARFCSDATA con todos los valores de los parámetros pasados en ejecución.
TABLAS ARFCSSTATE Y ARFCSDATA.
Son tablas bases de datos estándar de sistemas SAP que almacenan información relacionada a la llamada de módulos de funciones RFC transaccionales en el sistema.
Para visualizar el log utilizaremos la transacción estándar SM58.
Transacción SM58
Es la transacción estándar de sistemas SAP que nos permite visualizar el log de errores de los módulos de funciones RFC transaccionales que se ejecutaron en el sistema.
Cuando el programa que ejecuta el módulo de funciones RFC ejecuta la sentencia COMMIT WORK, entonces es cuando la llamada remota es enviada al sistema remoto para su ejecución.
Utilizaremos el tipo de módulo de funciones RFC transaccional para ciertos casos específicos de actualizaciones donde no se requiera que dichas actualizaciones se realicen en forma inmediata sino recién cuando el programa llamador ejecuta la sentencia COMMIT WORK.
- Asincrónicos: en donde el programa llamador, llama al módulo de funciones RFC e inmediatamente después termina su procesamiento. Luego el módulo de funciones RFC se ejecuta independientemente del programa llamador.
Para crear un módulo de funciones RFC asíncrono debemos utilizar el sufijo STARTING NEW TASK.