✒️ABAP / Los módulos de funciones Por Miguel Acosta Acosta
ABAP Los módulos de funciones
MODULOS DE FUNCION.
1.- Qué son los Módulos de Función.
Son funciones que han sido creadas y almacenadas en SAP y que pueden ser utilizadas por cualquier porgrama ABAP.
Para acceder a estas funciones se utiliza la transacción SE37, esta transacción permite crear, modificar y visualizar los módulos de funciones existentes en el sistema.
Tienen una interfaz definida, ya que su diseño facilita el paso de parámetros tanto de entrada como de salida.
CALL FUNCTION <nombre_función>
EXPORTING <parámetros_de_entrada>
IMPORTING <parámetros_de-salida>
TABLES <tablas>
EXCEPTION <excepciones>.
El siguiente ejemplo ejecuta la función POPUP_TO_CONFIRM, que se utiliza para pedir confirmación al usuario antes de tomar una acción determinada.
"En el menú del editor ABAP existe el botón Modelo (Pattern en inglés) que permite crear dentro de un programa el esqueleto de cualquier función creada a través de la transacción SE37. simplemente ingresando el nombre de la función que necesitemos."
CALL FUNCTION 'POPUP_TO_CONFIRM'
EXPORTING
titlebar = 'Aplicación de Bancos'
text-question = 'Desea borrar el registro ?'
text_button_1 = 'Si'
text_button_2 = 'No'
dsiplay_cancel_button = ''
EXCEPTIONS
text_not_found = 1
OTHERS = 2.
La ejecución de este programa dará como resultado la siguiente salida:
Una ventana POPUP con el título "Aplicación de bancos"
La pregunta "Desea borrar el registro ?"
y los botones 'Si' y 'No'.
2.- Cómo crear un Módulo de Función.
Se utiliza la transacción SE37.
. Ingresar el nombre Z_TEST_CLIENTES y presionamos el botón "Crear".
En la siguiente ventana de diálogo en donde debemos escribir el nombre del grupo de funciones al que pertenece la función y una descripción breve de la función que se quiere crear.
Al presionar "Grabar", el sistema nos informa que previamente a la creación del módulo de funciones, debemos crear el "Grupo de funciones" asociado.
El grupo de funciones.- Es un repositorio que agrupa y que se utiliza principalmente para compartir subrutinas y declaraciones de variables entre las distintas funciones pertenecientes al grupo.
En el menù horizontal:
Pasar a
Gestión Gr.funciones
Crear grupo.
Aquí ingresamos el nombre de nuestro grupo de función y presionamos el botón Grabar como vemos a continuación.
Luego aparece el siguiente mensaje que nos indica que el grupo de funciones ha sido creado correctamente.
Si se quiere definir variables que se puedan utilizar todas las funciones pertenecientes a nuestro grupo de funciones. Debemos dirigirnos en al menù de la transacción SE37
pasar a
Datos Globales
Se despliega la pantalla para definir las variables globales.
Si se quiere declarar subrutinas que puedan ser utilizadas por todas as funciones del grupo.
En el menù de las transacciòn SE37
Pasar a
Programa de control (Goto/MainProgram)
Allì descomentamos el primero de los include que està especificado para Subprogramas, le cambiamos el nombre para que comience con Z, Lo creamos haciendo doble clic sobre èl y luego colocamos las subrutinas en èl.
Finalmente, volvemos a la transacciòn SE37 con nuestro grupo de funciones creado, presionamos "Crear", ingresamos el grupo de funciòn y la descripciòn de la funciòn, grabamos y veremos la funciòn Z_TEST_CÑIENTES creada tal como muestra el siguiente gràfico.
Decripciòn de las solapas:
. Atributos.- Se especifica la descripciòn de la funciòn y el tipo de funciòn que puede ser normal, RFC o Update mòdule.
. Import.- Se especifican los paràmetros de entrada de la funciòn.
. Export.- Especificar los paràmetros de salida de la funciòn.
. Modificaciones(Changing): Se especifican los paràmetros de salida que cambiaràn de valor con la ejecuciòn de la funciòn.
. Tablas (Tables).- Se especifican las tablas que se utilizan en la funciòn.
. Excepciones.- Se especifican las excepciones de la funciòn. Una excepciòn es un error que se produce al ejecutar la funciòn y qye ha sido catalogado cuando se creò el mòdulo de funciòn de modo de poder identificar ràpidamente el motivo del error.
. Còdigo fuente (Source Code).- Se pondrà el còdigo ABAP.
Y como paràmetro de salida, en la solapa "Modificaciones" definimos la estructura de usuarios de la tabla que creamos en la unidad 2 ZTABLA_USUARIOS.
Si se quiere pasar como paràmetro una tabla interna en lugar de una estructura, entonces debemos crear un "tipo tabla" a travès de la transacciòn SE11, por ejemplo ZTT_USUARIOS, el cual va a tener la estructura de la tabla ZTABLA_USUARIOS.
Luego pondremos còdigo en la solapa "Còdigo fuente" para recuperar de la tabla ZTABLA_USUARIOS, los dato del usuario al que pertenezca el DNI de entrada. Finalmente activamos y se podrà probar la funciòn.
Escanear / Compartir
Sobre el autor
Publicación académica de Miguel Angel Acosta Acosta, en su ámbito de estudios para la Carrera Consultor ABAP Nivel Inicial.
SAP Expert
Miguel Angel Acosta Acosta
Profesión: Ingeniero de Sistemas - Ecuador - Legajo: TF64C
✒️Autor de: 238 Publicaciones Académicas
🎓Egresado de los módulos:
- Carrera Consultor SAP SD Nivel Avanzado
- Carrera Consultor SAP SD Nivel Inicial
- Master ABAP for HANA
- Carrera Consultor ABAP Nivel Avanzado
- Carrera Consultor ABAP Nivel Inicial
Disponibilidad Laboral: FullTime
Presentación:
Profesional de ingeniería de sistemas en computación e informática, con experiencia en la implantación y soporte de proyectos informáticos para empresas del sector industrial y financiero.
Certificación Académica de Miguel Acosta
