✒️ABAP / Los módulos de funciones Por Miguel Sierra Cardona
ABAP Los módulos de funciones
¿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 programa ABAP.
Para acceder a estas funciones se utiliza la transacción SE37. La Biblioteca de funciones correspondiente a la transacción estándar SE37 se utiliza para la creación, modificación y visualización de los módulos de funciones existentes en el sistema.
Tiene 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_entrada>
IMPORTING <parámetros_salida>
TABLES <tablas>
EXCEPTIONS <excepciones>.
Nota: En el menú del editor ABAP existe el botón Modelo (Pattern) 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 se necesita.
Ejemplo función POPUP TO CONFIRM que utiliza la confirmación al usuario antes de tomar una acción determinada:
CALL FUNCTION 'POP_UP_TOCONFIRM'
EXPORTING
titlebar = 'Aplicación de bancos'
text_qestion = 'Desea borrar el registro?'
text_button_1 = 'Si'
text_button_2 = 'No'
display_cancelbutton = ' '
EXCEPTIONS
text_not_found = 1
OTHERS = 2.
¿Cómo crear un Módulo de Función?
Para crear un módulo de función se debe acceder a la transacción SE37. Allí se escribe el nombre de función que será Z_TEST_CLIENTES y se presiona el botón Crear.
Inmediatamente se verá una ventana de diálogo donde se debe escribir el nombre del grupo de funciones al que pertenece la función y una descripción breve a la función que se quiere crear.
Al presionar Grabar el sistema informa que previamente a la creación del módulo de funciones, se debe crear el Grupo de funciones asociado.
Grupo de funciones
Es un repositorio que agrupa funciones y que se utiliza principalmente para compartir subrutinas y declaraciones de variables entre las distintas funciones pertenecientes al grupo.
Para crear un grupo de funciones, se debe seleccionar en el menú de la transacción SE37 la ruta:
Pasar a / Gestión gr.funciones / Crear grupo (Goto/Functions Groups/Create Group)
Se ingresa el nombre del grupo y se da clic en Grabar. Luego aparece en pantalla el mensaje que indica que el grupo de funciones ha sido creado correctamente.
Si se quiere definir variables que se puedan utilizar en todas las funciones pertenecientes al grupo de funciones, se debe dirigir al menú de la transacción SE37 a:
Pasar a / Datos Globales (Goto/GlobalData)
Si se quiere declarar subrutinas que se puedan utilizar en todas las funciones pertenecientes al grupo de funciones, se debe dirigir al menú de la transacción SE37 a:
Pasar a / Programa de Control (Goto/MainProgram)
Se descomenta el include especificado para Subprogramas, se le cambia el nombre para que comience con >, se crea haciendo doble clic sobre él y luego se coloca las subrutinas en él.
Finalmente, se vuelve a la transacción SE37 con el grupo de funciones creado, se presiona Crear, se ingresa el grupo de función y la descripción de la función, se graba y se observa la función creada.
Utilidad de cada una de las solapas que se visualizan:
- Atributos (Attributes): Se especifica la descripción de la función y el tipo de función que puede ser Normal, RFC o Update module.
- Import: Se especifica los parámetros de entrada de la función.
- Export: Se especifica los parámetros de salida de la función.
- Modificaciones (Changing): Se especifica los parámetros de salida que cambiarán de valor con la ejecución de la función.
- Tablas (Tables): Se especifica las tablas que se utilizan en la función. En la versión actual de SAP no se deben especificar en esta solapa las Tablas Internas, estas deben ser modificadas en la solapa Modificaciones.
- Excepciones (Exceptions): Se especifica las excepciones de la función. Una excepción es un error que se produce al ejecutar la función y que se cataloga cuando se crea el módulo de función de modo de poder identificar rápidamente el motivo del error.
- Código Fuente (Source Code): Se pone el código ABAP de la función.
Si se quisiera pasar como parámetro una tabla interna, se debe crear un Tipo Tabla a través de la transacción SE11. Luego se debe colocar el código en la solapa Código Fuente para recuperar la tabla.
Finalmente se procede a activar. Se debe activar todos los objetos relacionados.
Escanear / Compartir
Sobre el autor
Publicación académica de Miguel Mauricio Sierra Cardona, en su ámbito de estudios para la Carrera Consultor ABAP Nivel Inicial.
SAP Senior
Miguel Mauricio Sierra Cardona
Profesión: Ingeniero de Desarrollo E Innovación - Colombia - Legajo: GN43E
✒️Autor de: 61 Publicaciones Académicas
🎓Egresado del módulo:
Certificación Académica de Miguel Sierra
Disponibilidad Laboral: FullTime
