✒️ABAP Las Ampliaciones: los User Exits y los Customer Exits

Unidad 3: Ampliaciones y Notas en SAP.

Lección 1: Ampliaciones User Exits y Customer Exits.

1.- ¿Que es una Ampliación?

Son diferentes herramientas que presenta SAP para realizar mejoras, modificaciones o agregados a un programa estándar del sistema.

Hay programas estándar que ya están preparados para permitir funcionalidad adicional. Las ampliaciones siempre se codifican y generan en módulos a parte del código estándar. Con ello se evita interferir en el normal funcionamiento de las funcionalidades originales.

Las ampliaciones principalmente presentan estas ventajas:

• Permite la modificación y adaptación de los programas a necesidades particulares de la empresa, añadiendo funcionalidad.
• Las mejoras en los programas no implican modificar código original por lo que se mantiene el correcto funcionamiento de lo ya existente.
• Los cambios se tendrán en cuenta una vez transportados los nuevos objetos.

También como todo tienen algunas desventajas.

• No siempre las modificaciones se realizan adecuadamente. En la mayoría de ampliaciones, hay limitaciones respecto a lo que puede hacerse y el momento en que se hace.
• No todos los tipos de ampliaciones son de aplicación en todos los programas estándar.

SAP presenta los siguientes tipos de ampliaciones principales:

• User Exits.
• Customer Exits,
• Keyword Exits
• Field Exits.
• Estructuras Append.
• Badis.
• Enhancenents.
• Menu Exits,

2.- User Exits.

Es una subrutina dentro de un programa estándar ABAP. Inicialmente están vacías, ya que la idea es que se informe en ellas el código que se requiera para la realización de una funcionalidad no prevista en el estándar SAP.

Son el tipo de ampliaciones mas antiguas de SAP y están restringidas al modulo de SD. Se identifican como USEREXIT _ <nombre del user exit>. Adoptando la forma de un FORM: FORM USEREXIT_ <nombre user exit> ... ENDFORM.

La dificultad está en encontrar que user exit es el correcto por su posición en el código y que además sea útil a nuestro propósito. No es necesario tener clave de desarrollador para poder poner código en un user exit. El código puede escribirse directamente en la user exit o en un include Z incorporado al mismo.

Aunque SAP aún les da soporte porque ciertas aplicaciones de SD las utilizan no es ya una técnica en uso en nuevas ampliaciones.

No es posible la creación de user exits adicionales a las existentes en el sistema.

3.- Customer Exits.

Es un punto dentro del programa en donde se puede llamar a un programa propio. Dentro de los programas estándar se accede a ellos mediante un módulo de función. Adicionalmente hay programas estándar que presentan módulos de función modificables por usuario. Este tipo de ampliaciones se identifican por un número que es la terminación del nombre del módulo de función que esta asociado al programa.

La tabla estándar MODSAP almacena todos los módulos de función que se utilizan en los COSTUMER EXIT. De hecho en dicha tabla se almacenan todas las ampliaciones que tenemos en el sistema.

Según su tipo podemos distinguir:

• E. Exit de funciones.
• S. Exit para imágenes.
• T. Exit de Tablas.
• C. Exit para código GUI.

La clave de dicha tabla es nombre de ampliación, tipo y nombre del objeto SAP al que modifica. El modulo de función de una Customer Exit tiene la siguiente nomenclatura: EXIT_<nombre del programa>_<nº función>. Su llamada CALL CUSTOMER-FUNCTION <Nº customer function>

Los módulos siempre son llamados por el proceso estándar en unos momentos prefijados y con unos parámetros determinados que son los que ofrece la aplicación.

Entre las ventajas principales:

• Herramienta útil para agregar nueva funcionalidad a un estándar sin que ello implique la modificación del código original.
• Es suficiente el include correspondiente para transportar y activar un Customer Exit.

Las desventajas son:

• Las Customer Exit no siempre se ajustan a las necesidades del programador ya que los parámetros son fijos.
• No son de fácil identificación porque no existe una búsqueda por programa. Hay que buscar dentro del programa de control estándar el string CALL CUSTOMER-FUNCTION. No siendo posible conocer su funcionamiento de antemano.

El manejo de las Customer Exits se realiza mediante dos transacciones:

• SMOD. Administración ampliaciones.
• CMOD. Gestión proyectos ampliaciones.

4.- Realización de un Customer Exit.

• Vamos a SMOD allí debemos informar el nombre de la ampliación que contiene el módulo de función que utilizará el Customer Exit.. Podemos buscar el nombre de dos maneras:

1. Buscar en la tabla MODSAP, si conocemos el nombre del módulo, este en el campo MEMBER de la tabla. La ampliación que corresponde esta en el campo NAME.

2. Si tampoco conocemos el módulo de función buscaremos en el programa estándar todas las llamadas CALL CUSTOMER-FUNCTION. Así podremos ver todas las customer exit llamadas por una transacción.

3. Teniendo el nombre informado en SMOD pulsamos visualizar. Desde aquí se pueden visualizar atributos, componentes y documentación de la ampliación. En la siguiente pantalla presionamos el botón componentes o ya de entrada marcamos esa opción, entonces se mostrara todos los módulos de función que tiene la ampliación en una nueva pantalla.

4. Entramos en el módulo que nos interesa mediante doble click con el ratón. En una nueva pantalla se nos mostraran los parámetros de entrada y salida así como las tablas. En la pestaña Cód. fte. habrá una include Z aunque en las últimas versiones de SAP será ZX o no existirá si es la primera vez. Si queremos crearlo haremos doble click sobre la include y la asignaremos a una orden de transporte. Ahora ya podemos escribir el código de la ampliación necesario en la include utilizando los objetos que constan en los parámetros de importación y en las tablas.

En general el código de los exits suele destinarse a validaciones de campos de entrada. Si la validación no se supera se informara en pantalla el correspondiente mensaje en caso contrario la transacción continuara con el procesamiento normal.

5. Para agrupar, clasificar y controlar los Customer Exits crearemos un proyecto de ampliación con la transacción CMOD. En el proyecto incorporaremos las ampliaciones que consideremos necesarias. Al igual que las ampliaciones el proyecto debe activarse. Si desactivamos un proyecto activo quedan inactivas todas las ampliaciones que contiene, por tanto estas no se aplicarían. Desde la pantalla de componentes podemos activar y desactivar exits individuales.

El nombre del proyecto de ampliación empezará por Z.

Para asignar ampliaciones o bien marcamos la opción de Asignación ampliaciones cliente o bien en la siguiente pantalla pulsamos el botón Asignación ampliación.

Desde pantalla de ampliaciones que forman parte del proyecto, podemos acceder a los componentes de cada una de ellas mediante el botón componentes.

Si un Exit no está activo entonces la llamada correspondiente no tendrá efecto alguno.

5.- Test de Customer Exits.

La mayor dificultad para utilizar Customer Exits es saber donde se ubican dentro del programa y el momento en que entran en juego, Lo mas efectivo para desentrañar todo esto es crear un proyecto de ampliación, insertar la ampliación en el mismo, activarla y luego colocar un break point en el módulo de funciones correspondiente.