✒️ABAP / Los módulos de funciones Por Cesar Rodriguez Zorrilla
ABAP Los módulos de funciones
1. Módulos de Funciones
1.1 Introducción
Los módulos de funciones son objetos que realizan operaciones
que pueden ser utilizadas en varios programas. Al crear un módulo
de función con el código que realiza una operación, se evita tener
que repetirlo en tod
os los programas que realicen esa operación
añadiendo en ellos una llamada al módulo de función. Además de
evitar que se repita el mismo código en diferentes programas, se
facilita el mantenimiento del proceso, ya que las modificaciones
que se realicen en
un módulo de función afectan a todos los
programas que lo utilicen.
SAP dispone de un gran número de módulos de función
predefinidos que se pueden utilizar en nuestros programas, a las
que se añadirán los que se desarrollen a medida.
Los módulos de funci
ón pertenecen a grupos de funciones, que los
agrupan según su funcionalidad. Los módulos de funciones de un
mismo grupo de funciones comparten las definiciones de datos
globales.
1.2 Creación de un grupo de funciones.
Para crear un grupo de función iremos
por la opción de menú del
OBJET NAVIGATOR
Ruta de acceso: ( En el menú principal de SAP ) ‘Herramientas
%uF0E0
Workbench ABAP4
%uF0E0
Resumen
%uF0E0
Object Navigator ( SE80).
Seleccionaremos ‘Grupo de funciones’ , pondremos el nombre del
grupo de funciones a Crear
Ej
‘ZCXX’.
Aparecerá una ventana el la que definir los atributos del grupo de
funciones.
Grupo de funciones:
Nombre del grupo de funciones.
Texto breve:
Descripción del grupo de funciones.
Ej: ‘Asignación de números’.
Respnsable:
Usuario responsable d
el grupo de funciones.
1.3 Datos de gestión
Los módulos de función se mantienen utilizando la biblioteca de
funciones.
Ruta de acceso: ( En el menú principal de SAP ) ‘Herramientas
%uF0E0
Workbench ABAP4
-
Desarrollo
%uF0E0
Biblioteca funciones’ (SE37).
Desde es
ta pantalla se pueden crear, modificar o visualizar todas
las partes de un módulo de función marcando las distintas
opciones de objetos parciales.
Ej.: Se creará una función que recibirá como parámetro de entrada
una sociedad y devolverá como parámetro de
salida el primer
número de cliente desocupado en la tabla de clientes ZCLIENXX
para esa sociedad.
Para crear un módulo de función se deberá especificar el nombre
en la pantalla inicial y pulsar el botón de crear
con la opción ‘Gestión’ activada.
Ej.: ‘
Z_OBTENER_NUMERO_CLIENTE_XX’.
Aparecerá una pantalla en la que se debe indicar el grupo de
funciones a la que pertenece el módulo de función junto con su la
descripción de la función.
Ej.: ‘ZCXX’..
‘ Devuelve un número de cliente libre’.
Una
vez especificado el grupo de función se deberán informar los
datos de gestión del módulo de función.
Clasificación:
%uF0A7
Aplicación: Módulo al que pertenece el programa ( FI ,
HHRR ... ).
Ej.: ‘*’ Multiaplicación.
%uF0A7
Texto breve: Descripción de la funcionalidad del
módulo de
función.
Ej.: ‘Determinación de número de cliente’.
Forma ejec.:
%uF0A7
Normal: Módulo de función normal.
%uF0A7
Apoyo Remote Function Call: Funciones de jecución remota.
Estas funciones pueden ser ejecutadas desde otros
sistemas externos a SAP.
%uF0A7
Actualizabl
e: Funciones de actualización asíncrona. Se
puede especificar el modo de tratamiento de la tarea de
actualización (Inicio inmediato, inicio inmediato sin
actualización posterior, inico retardado o lanzamiento
colectivo.
Ej.: ‘Normal’.
Al finalizar la int
roducción de los datos de gestión se deberá grabar
el módulo de función.
1.4 Parámetros de la función.
1.4.1 Parámetros Import.
Deberemos indicar la lista de parámetros de entrada de la función:
Parámetro:
Nombre de los parámetros de entrada.
Tipifica
ción:
Tipo de dato del parámetro.
Tipo Ref.
Tipo de referencia ( Solo se indicará una de estas dos
últimas ).
Valor Propuesto:
Valor por defecto cuando se declara como
opcional.
Flag opc.
Indicador de parámetro no obligatorio.
Flag.
Tras.
Indicación de que
el parámetro se recibe por
valor/referencia.
1.4.2 Parámetros de salida ( Export).
Son los parámetros de salida de función.
1.4.3 Parámetros ( changing ):
Parámetros de entrada y salida del módulo de función. Estos
parámetros devuelven el valor de sali
da al finalizar la ejecución del
módulo de función sin errores, manteniendo el valor de entrada en
caso contrario.
Ej.: Se crea el parámetro import ‘BUKRS’ con el campo de
referencia ‘ZCLIENXX
-
BUKRS’ para recibir la sociedad del cliente,
y el parámetro ex
port ‘NCLIE’ con el campo de referencia
‘ZCLIENXX
-
NCLIE’ para devolver el número de cliente.
1.5 Tablas
Además de los parámetros de entrada y salida definidos
anteriormente, también se pueden traspasar tablas por referencia
en la llamada al módulo de func
ión.
%uF0A7
Parámetro tabla
: Nombre del parámetro de tabla.
%uF0A7
Tipificaión
: Tipo de datos de la tabla
%uF0A7
Tipo ref.
: Estructura de referencia del diccionario de datos
para especificar la estructura del parámetro de tabla.
%uF0A7
Opcional
: Si se activa este flag no será
obligatorio informar
el parámetro de tabla en la llamada al módulo de función.
1.6 Excepciones
Las excepciones son una serie de errores predefinidos en los
módulos de función que pueden devolver como valor de retorno de
su ejecución en la variable del si
stema SY
-
SUBRC.
Excepción:
Se indicará un nombre descriptivo para cada
posible error predefinido que va a poder retornar el módulo
de función. La posición en la tabla de excepciones se
corresponderá con el valor que devolverá en la variable SY
-
SUBRC (la p
rimera excepción definida devolverá 1, la
siguiente 2, etc.).
Por defecto siempre existe la excepción ‘OTHERS’, aunque
aparezca definida, que se utiliza para devolver un error genérico y
devuelve en la variable SY
-
SUBRC el valor siguiente al de la última
excepción creada.
Ej.: Se crea la excepción ‘SOCIEDAD_INEXISTENTE’ que será
devuelta cuando la sociedad informada en el parámetro de entrada
correspondiente no exista en la tabla estándar de sociedades.
Para devolver una excepción desde el código del mod
ulo de
función se utiliza la sentencia RAISE <excepción>, finalizando así
la ejecución de la función y devolviendo el código asociado a la
excepción en la variable SY
-
SUBRC. En caso de devolver una
excepción no se actualiza el valor de salida de los paráme
tros
CHANGING.
Con la cláusula RAISING de la instrucción MESSAGE se puede
dar la posibilidad de que el módulo de función trate el error
mostrando el mensaje de error especificado o que devuelva la
excepción correspondiente sin mostrar el mensaje de error,
en
función de si se especifica la cláusula ‘EXCEPTIONS’ en su
llamada. Si no se expecifica la cláusula, el módulo de función
mostrará los mensajes de error que tengan la cláusula ‘RAISING’,
finalizando así la ejecución del programa que realiza la llamada,
en
caso contrario se devolverán las excepciones asociadas a los
mensajes traspasando el control de los errores al programa que
realiza la llamada al módulo de función.
1.7 Datos globales
Las definiciones globales de datos son compartidas por todos los
m
ódulos de función de un grupo de funciones. Las definiciones de
objetos globales se mantienen a través de la opción de menú
‘Pasar a
%uF0E0
Datos globales’.
Nota: Las definiciones globales y el texto fuente del módulo de
función se codifican realmente en el edi
tor ABAP/4 utilizando los
mismos comandos que en la codificación de listados.
Ej.: Se define la tabla estándar de sociedades ‘T001’ en la que se
chequeará que la sociedad recibida como parámetro es correcta, y
la tabla de clientes ‘ZCLIENXX’ para seleccio
nar los números de
cliente existentes.
Include LZCLITOP:
FUNCTION
-
POOL ZCLI.
"MESSAGE
-
ID ..
************************************************************************
* Definición de tablas
************************************************************************
TABLES: T001, " Sociedades
ZCLIENXX. " Clientes
Los parámetros definidos en el módulo de función so
n locales, por
lo tanto solo son visibles en el cuerpo principal de la función. Para
que puedan ser utilizados en las subrutinas, sin necesidad de
pasarlos como parámetros, se deberán globalizar utilizando la
opción de menú ‘Tratar
%uF0E0
Interfase
%uF0E0
Globalizar par
ám.’ en la
pantalla de mantenimiento de parámetros de entrada/salida. Para
eliminar la globalización se utiliza la opción de menú
‘Tratar
%uF0E0
Interfase
%uF0E0
Localizar parám.’.
1.8 Código fuente
Al crear una subrutina, haciendo doble click sobre el nombre en la
l
lamada, el sistema propondrá la creación de un Include que
contendrá todas las subrutinas del grupo de funciones.
Al finalizar la introducción del texto fuente se deberá grabar,
verificar y activar el módulo de función.
Ej.: Se crea la subrutina ‘CHEQUEA
R_SOCIEDAD’ en un nuevo
Include LZCLIF01 pasándole como parámetro de entrada el
parámetro de sociedad, que chequeará que la sociedad existe en
Escanear / Compartir
Sobre el autor
Publicación académica de Cesar Ismael Rodriguez Zorrilla, en su ámbito de estudios para la Carrera Consultor ABAP Nivel Inicial.
SAP Master
Cesar Ismael Rodriguez Zorrilla
Republica Dominicana - Legajo: MW21J
✒️Autor de: 120 Publicaciones Académicas
🎓Egresado de los módulos:
Certificación Académica de Cesar Rodriguez
Disponibilidad Laboral: FullTime
