✒️ABAP / Las subrutinas Por Gustavo Rondon Hernandez

Las subrutinas

1 | ¿Qué son las subrutinas?

Subrutinas

Son secciones de código que pueden ser utilizadas más de una vez dentro de un mismo programa y también pueden ser utilizadas por otros programas que las referencien.

La idea de pasar el código de los programas a subrutinas, es para que los programas sean más fáciles de leer y de mantener.

Modularizar

Se Ilama así a Ia acción de pasar el código de un programa a subrutinas, para mejorar Ia lectura y el mantenimiento del mismo.

Lo ideal es que una subrutina no tenga más de 50 líneas de código.

La modularización ayuda a encontrar más fácilmente los errores en los programas. Esto se debe a que al debaguear un programa solo nos preocupamos que el resultado de una subrutina sea el esperado sin entrar en detalle de cómo se llega a ese resultado.

En ABAP una subrutina se declara con la palabra reservada PERFORM seguida del nombre de la subrutina Veamos un ejemplo:

PERFORM seleccionar_datos.

Aquí creamos una subrutina para modularizar la selección de los datos. Si hacemos doble clic en el nombre de la subrutina, el sistema nos propondrá crear la subrutina.

Contestaremos Sí y el sistema nos preguntará donde deseamos crear la definición de la subrutina, las opciones som crear un nuevo include o crearlas en el mismo programa de control. En este caso la crearemos en el programa de control..

Luego el sistema generará el siguiente bloque de código en nuestro programa para que lo completemos con el código que corresponda.

Tal como podemos ver en la imagen anterior, dentro de la plantilla de comentarios que se crea cuando generamos una subrutina, podemos especificar el objetivo de la subrutina y más abajo de este podemos detallar los parámetros de entrada y de salida de la subrutina junto con una descripción de cada uno de ellos.

Por ejemplo, para la subrutina SELECCIONAR_DATOS podríamos escribir el texto "Seleccionamos los datos de la tabla de usuarios ZTABLA_USUARIOS" y también vamos a especificar el parámetro de salida P TI USUARIOS que será la tabla interna que contendrá los registros de la tabla base de datos de usuarios ZTABLA_USUARIOS.

sabias que: El nombre que se le asigne a una subrutina debe ser lo más representativo posible del resultado que produce la subrutina.

La longitud del nombre de una subrutina no puede exceder los 30 caracteres.

2 | Los tipos de subrutinas

Existen dos tipos de subrutinas:

• Intemas: cuando la subrutina se encuentra dentro del mismo programa que la llama o en un )nclude de subrutinas, el cuál se encuentra declarado en el programa de control. Este sería el caso de la subrutina SELECCIONAR_DATOS que creamos anteriormente en nuestro programa ZTEST_SUBRUTINAS.
• Externas: cuando la subrutina se encuentra en un programa distinto al que la llama. Para llamar a una subrutina externa desde otro programa vamos a escribir la sentencia PERFORM de la siguiente forma:

PERFORM <nombre_subrutina> IN PROGRAM <nombre_programa_subrutina>..

Veamos un ejemplo sobre como ejecutaríamos la subrutina SELECCIONAR_DATOS desde otro programa ABAP.

3 | El paso de parámetros a subrutinas

Podemos pasar datos entre el programa principal y una subrutina a través de parámetros.

Los parámetros de una subrutina pueden ser de tres tipos:

• De entrada: cuando se utilizan para pasar datos del programa principal a la subrutina.
• De salida: cuando se utilizan para pasar datos de la subrutina al programa principal.
• De entrada y salida: cuando se utilizan para pasar datos de la subrutina al programa principal y también viceversa

Para pasar los parámetros en las subrutinas vamos a utilizar tres palabras reservadas que son las siguientes:

USING para declarar parámetros de entrada que serán utilizados en la subrutina.

CHANGING para declarar parámetros de entrada/salida que serán utilizados en la subrutina

TABLES para declarar parámetros de entrada/salida que son tablas, las cuales serán utilizadas en la subrutina.

Las palabras reservadas que acabamos de mencionar deben ser escritas en el orden que mostramos a continuación en la siguiente imagen:

PERFORM <nombre subrutina> TABLES <tabla interna>

USING <parámetro de entrada>

CHANGING <parámetro_de_entrada_y salida>.

A los parámetros definidos dentro del programa principal, en la declaración de la subrutina, a la derecha de la palabra PERFORM se los llama parámetros actuales.

En el ejemplo que mostramos a continuación, V_HAY_DATOS es un parámetro actual.

A los parámetros que se especifican en la definición de la subrutina, a la derecha de la palabra FORM se lo llama parámetros formales.

En el ejemplo que mostramos a continuación, P_HAY_DATOS es un parámetro formal.

Ahora bien, en el bloque FORM-ENDFORM debemos especificar el tipo de los parámetros formales.

De esta manera nos aseguramos que solo se pasen parámetros del tipo que corresponde a la subrutina.

Recuerda: Cuando una subrutina es llamada, los parámetros deben ser pasados en el mismo orden en el que fueron declarados, lo tanto, se debe respetar esta misma secuencia en el bloque FORM-ENDFORM.

Existen tres formas de pasar parámetros:

• Paso por valor: durante la llamada a la subrutina, los parámetros formales son creados como copias de los parámetros actuales. Los cambios en los parámetros formales no afectan a los parámetros actuales.

La salida por pantalla luego de la ejecución del código anterior será B.

• Paso por referencia: durante la llamada a la subrutina, solo la dirección de los parámetros actuales se transfieren a los parámetros formales. Dentro de la subrutina, se trabaja con el campo del programa que hace la llamada.

Si cambiamos los parámetros formales, el contenido del campo del programa que hace la llamada también cambia.

La salida por pantalla luego de la ejecución del código anterior será A B y X X.

• Paso por valor y resultado: durante la llamada a la subrutina, los parámetros formales son creados como copias de lo parámetros actuales. Los cambios en los parámetros formales son copiados a los parámetros actuales al final de la subrutina.

La salida por pantalla luego de la ejecución del código anterior será Hl es: B.

4 | Las declaraciones de datos globales y locales

Cuando declaramos datos en un programa ABAP, es decir variables, estructuras, tablas internas u otros tipos de datos:

podemos hacerlo de dos formas diferentes:

• Globalmente.
• Localmente.

Hasta este momento siempre que declaramos datos en los programas con los que trabajamos, realizamos las declaraciones luego de la ejecución de la sentencia REPORT y antes de la declaración del evento START-OF-SELECTION.

Los declaración de datos que realizamos en este lugar de un programa son llamadas declaraciones globales, lo cual significa que estas declaraciones pueden ser utilizadas en cualquier lugar del programa y con esto nos referimos a que pueden ser utilizadas tanto en el programa principal como en cualquiera de las subrutinas que el programa contenga.

Las declaraciones globales de datos tienen una ventaja y una desventaja.

Como ventaja podemos decir que se facilita el armado del programa ya que no tenemos que estar pensando en donde particularmente va a ser utilizada una declaración de datos, sino que simplemente la declaramos globalmente y la utilizamos en donde corresponda.

Como desventaja podemos decir que al realizar todas las declaraciones de datos en forma global no estamos generando un código ABAP tan eficiente en cuanto a la modularización, lo cual en algún punto puede complicar el mantenimiento futuro del programa.

Otra posibilidad con la que contamos consiste en realizar declaraciones locales, es decir dentro de una subrutina podríamos declarar exclusivamente los datos que vamos a utilizar, de modo de modularizar lo más posible el código y consumir la menor cantidad de recursos del sistema, evitando declarar globalmente datos que solo serán utilizados localmente y de esta forma hacemos más eficiente el uso de la memoria de un programa ABAP.