✒️ABAP / Las subrutinas Por José Saavedra Rodríguez

UNIDAD 4: SUBRUTINAS, FUNCIONES Y BATCH

Subrutinas

1 ¿Qué son las subrutinas?

Las Subrutinas son secciones de código que pueden ser utilizadas más de una vez.

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

Se llama Modularizar a la acción de pasar el código de un programa a subrutinas para mejorar la lectura y 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 debuguear un programa solo nos preocupamos de que el resultado de una subrutina sea el esperado, sin entrar en detalle de como se llega a ese resultado.

Una subrutina se declara con la palabra reservada PERFORM seguida del nombre de la subrutina:

<< imagen 1.1 >>

Se crea la 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 misma con la siguiente ventana de diálogo:

<< imagen 1.2 >>

Al contestar afirmativamente el sistema nos preguntará dónde queremos generar la subrutina. Las opciones son:

- Crear un nuevo include de datos.

- Crearlas en el mismo programa de control.

Si contestamos que en el mismo programa de control, el sistema generará el siguiente bloque de código en nuestro programa para que lo completemos con el código que corresponda:

<< imagen 1.3 >>

Es importante que el nombre que se le asigne a la subrtina sea lo más representativo posible del resultado que produce la propia subrutina. La longitud del nombre no puede exceder los 30 caracteres.

2 Tipos de subrutinas

Existen dos tipos de subrutinas:

- Internas: cuando la subrutina está dentro del mismo programa que la llama.

- Externas: cuando la subrutina está en un programa distinto al que las llama. Este puede ser el caso cuando llamemos a una subrutina que se encuentra en un include subrutinas o de otro programa.

3 Subrutinas internas

Para crear una subrutina interna usamos la palabra clave PERFORM seguida del nombre de la subrutina. Esto crea un bloque FORM-ENDFORM donde colocamos nuestro código.

Se pueden pasar datos entre los programas principales y una subrutina a través de parámetros. Los parámetros definidos en el programa principal (a la derecha de la palabra reservada PERFORM) se llaman parámetros actuales. Los parámetros definidos en la subrutina (a la derecha de la palabra reservada FORM) se llaman parámetros formales.

Los parámetros pueden ser de tres tipos:

- Parámetros de entrada: cuando se utilizan para pasar datos del programa principal a la subrutina.

- Parámetros de salida: cuando se utilizan para devolver datos desde la subrutina al programa principal.

- De entrada y de salida: cuando se utilizan para pasar datos de la subrutina al programa principal y viceversa.

4 Paso de parámetros a subrutinas

Para pasar los parámetros utilizaremos 3 opciones: TABLES, USING, CHANGING. Estas opciones se deben escribir en el orden mostrado, tal y como vemos en el siguiente gráfico:

<< imagen 4.1 >>

En el bloque FORM-ENDFORM debemos especificar el tipo de los parámetros formales (los que son propios del programa origen). De esta forma nos aseguramos que solo se pasen parámetros del tipo que corresponde a la subrutina.

En el siguiente ejemplo vemos como pasamos una tabla interna, una estructura y una variable de tipo caracter a una subrutina:

<< imagen 4.2 >>

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

Existen tres formas de pasar parámetros:

- Paso por valor: durante la llamada a la subrutina los parámetros formales son creados como copia de los parámetros actuales. Los cambios en los parámetros formales no afectan a los parámetros actuales. Se utiliza la palabra reservada value para identificar que el parémtro se pasa por valor.

<< imagen 4.3 >>

Tras finalizar el ejemplo anterior, v_f1 = 'B'

Audio: Como vemos en la imagen anterior, el nombre del parámetro actual v_f1, es decir el que se especifica a la derecha de la palabra reservada PERFORM, es diferente al nombre del parámetro formal pf1, es decir el que se especifica a la derecha de la palabra reservada FORM en la declaración de la subrutina. Basta con que ambos parámetros se encuentre en el mismo orden y que su tipo sea el mismo para que ABAP los interprete correctamente. Para pasar parámetros por valor utilizamos en la declaración de la subrutina la palabra reservada value, y se encierra el parámetro entre paréntesis. Cuando se pasan parámetros por valor tenemos que tener bien claro que las modificaciones que se realicen en el parámetro dentro de la subrutina, no tendrán efecto alguno fuera de la subrutina en el programa principal. Ahora bien, expliquemos por qué la salida por pantalla es "B". Al momento de declarar en el programa principal la variable v_f1 le asignamos el valor "B". Luego ejecutamos la subrutina "paso por valor", pasando la variable v_f1 como parémetro por valor. Dentro de la subrutina vemos que el nombre del parámetro por valor cambia y que se le asigna al mismo una "X". Tal y como mencionamos anteriormente, debido al paso por valor, a la salida de la subrutina el parámetro v_f1 vuelve a tener el mismo valor que tenía antes de ingresar a la misma. Finalmente la impresión del contenido de la variable en pantalla 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 el valor de los parámetros formales (en la subrutina), el contenido del campo del programa que realiza la llamada también cambia:

<< imagen 4.4 >>

La salida en este caso será A B y X X.

Notar que USING y CHANGING tienen el mismo efecto, que es pasar parámetros (de tipo distinto a tablas) a la subrutina. Los parámetros pasados aquí son por referencia, y por tanto si se asignan nuevos valores en la subrutina, estos también cambiarán para el programa que llama. El cuando usar uno u otro es indiferente de cara al resultado, pero por razones de documentación se recomienda usar USING para los parámetros que no se modificarán (de entrada) y CHANGING para los parámetros que si se modificarán en la subrutina (de salida).

Audio: Como vemos en la imagen anterior, los nombres de los parámetros actuales v_g1 y v_g2 (es decir los que se especifican a la derecha de la palabra reservada PERFORM) son diferentes de los nombres de los parámetros formales p_g1 y p_g2 (es decir los que se especifican a la derecha de la palabra reservada FORM) en la declaración de la rutina "paso por referencia". Basta con que los parámetros se encuentren en el mismo orden y sean del mismo tipo para que ABAP los interprete correctamente. Cuando se pasan parámetros por referencia tenemos que tener bien claro que las modifcaciones que se realicen en los parámetros dentro de la subrutina, si tendrán efecto fuera de la subrutina en el programa principal. Ahora bien, expliquemos por qué la salida por pantalla es "A B", y "X X". Al momento de declarar en el programa principal las variables v_g1 y v_g2 les asignamos los valores "A y B" que imprimimos por pantalla. A continuación ejecutamos la subrutina "paso por referencia" pasando ambas variables como parámetors por referencia. Dentro de la subrutina vemos que los nombres de los parámetros cambian por p_g1 y p_g2, y que a ambos parámetros se les asigna una "X". A la salida de la ejecución de la subrutina, en el programa principal, los parámetros conservan el valor asignado en la subrutina debido al paso de parámetros por referencia, es decir, el valor "X". Finalmente la impresión de contenido de las variables en pantalla será "X X".

- Paso por valor y resultado: 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 son copiados a los parámetros actuales al final de la subrutina.

<< imagen 4.5 >>

La salida para la variable v_h1 es "B".

5 Subrutinas externas

Si quisiéramos llamar a una subrutina que está en un programa distinto al que estamos procesando, debemos utilizar la siguiente sintaxis:

<< imagen 5.1 >>

También podemos agregar includes de subrutinas a nuestro programa usando la palabra INCLUDE de la siguiente forma:

<< imagen 5.2 >>

Favorito:

Está publicación ha sido agregada a sus favoritos por: Lorena Amoretti