✒️ABAP / Las Ampliaciones: los User Exits y los Customer Exits Por Oscar Perez

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

Algunos programas estándares están preparados como para agregarles nueva funcionalidad a la ya existente

En algunos casos, se puede validar campos de alguna dynpro en particular; agregar campos a una pantalla con código que permita tratar esos datos nuevos; agregar una nueva opción dentro de un menú o agregar campos a tablas estándares.

Las ampliaciones se generan y codifican en módulos aparte del código estándar, con lo cual no se necesita modificarlo, manteniendo la funcionalidad original y el buen funcionamiento.

· Permiten modificar ciertos programas para adaptarlos a necesidades particulares de la empresa, añadiendo nuevas características a las existentes.

· Permiten realizar mejoras a un programa sin modificar el código original del mismo, manteniendo el buen funcionamiento y las características que tenía.

· Los cambios toman efecto con solo transportar los nuevos objetos.

· No siempre se pueden hacer todas las modificaciones de manera satisfactoria, ya que la mayoría de las ampliaciones están preparadas para una determinada tarea y momento dentro de la ejecución de un programa.

· No todos los programas estándares están preparados para añadir todos los tipos de ampliaciones.

Los tipos de ampliaciones más importantes son:

· User Exit

· Customer Exit o Exit de Cliente

· KeyWord Exit

· Field Exit o Exit de campo

· Estructuras Append

· Badis

· Enhancements

· Menú Exit

Es una subrutina definida dentro de un programa estándar ABAP que está hueca, es decir sin código, para que el usuario ponga su propio código fuente que le permita realizar tareas específicas que no están previstas por SAP.

Son las primeras ampliaciones introducidas por SAP. Son propias del módulo SAP SD de ventas y distribución. No existen en otros módulos de SAP.

Están implementados en la forma de subrutinas. Todos los User Exit están nombrados como USEREXIT_XXXXX.

El principal reto con los User Exit es encontrar el correcto, y una vez que se encuentra, debemos verificar que el mismo sirva para el propósito deseado.

El código ABAP que se insertará dentro del User Exit puede colocarse dentro de un Include que comenzará con la letra Z o sino suelto.

Para añadir o modificar código existente dentro de un User Exit, no es necesaria la clave de acceso de SAP. Por ejemplo, en el programa estándar MV45AFZZ se encuentra el siguiente User Exit que es utilizado por la transacción VA02 cada vez que lee un documento.

Ciertas aplicaciones del módulo SD todavía utilizan este tipo de ampliaciones, pero esta práctica no se está utilizando para nuevas extensiones al código SAP. En su lugar se utilizan el resto de los tipos de ampliaciones disponibles, aunque vale tener en cuenta que los User Exit serán mantenidos por SAP en las nuevas versiones del sistema.

NOTA (Audio Tip): Los User Exit son huecos que genera SAP en el sistema estándar. Estos huecos están ubicados en lugares determinados del sistema. Es importante dejar claro que no es posible generar nuevos huecos, sino que se tiene que trabajar con los existentes. Si no se encuentra un User Exit que se ajuste a los requisitos, entonces tendremos que buscar otra alternativa de solución dentro de las demás soluciones de ampliaciones posibles que ofrece SAP en su sistema.

También llamado Exit de Cliente, es un punto dentro de un programa donde se puede llamar a un programa propio. Se ejecutan desde un programa estándar haciendo una invocación a un módulo de función. Algunos programas estándares tiene dentro de su código, llamadas a módulos de funciones que pueden ser modificados por el programador.

Los Customer Exit son llamados dentro de los programas a través de un número. Este número es la terminación del nombre del módulo de función que está asociado al programa.

En la tabla MODSAP se encuentran todos los módulos de función que se utilizan en los Exit de cliente.

Tabla MODSAP: La tabla base de datos estándar MODSAP almacena todas las ampliaciones existentes en el sistema SAP. De cada ampliación se guarda: el nombre de la ampliación, el tipo de componente que puede ser "E" para Exit de funciones, "S" para Imágenes, "T" para Tablas y "C" para Código GUI y finalmente el nombre del objeto SAP (Programa, módulo de función, etc.) que se modifica.

Los módulos de función tienen una nomenclatura estándar.

Por ejemplo, EXIT_SAPMV45A_003.

La llamada a un Exit de un módulo de función es implementada de la siguiente forma en un programa estándar de ABAP:

CALL CUSTOMER-FUNCTION <3 dígitos>.

Cada uno de estos módulos es llamado por el proceso estándar en ciertos momentos y tienen por defecto algunos parámetros que son los disponibles dentro de la ampliación.

Ventajas de los Customer Exit o Exit del cliente:

· Es una buena herramienta para añadir funcionalidad nueva a un programa estándar, como puede ser una validación o la ejecución de rutinas de control sin modificar el código original.

· Para transportar y activar los Customer Exit es suficiente con el include` nuevo únicamente, sin tocar el programa original.

Desventajas de Customer Exit o Exit del cliente:

· No siempre se ajusta el Customer Exit a las necesidades del programador ya que los objetos que importa o exporta son fijos y pueden no tener todos objetos que se requieren.

· No existe una búsqueda de Customer Exit por programa con una aclaración amplia de su utilización, para buscarlos hay que realizar una búsqueda del string “CALL CUSTOMER-FUNCTION”, dentro del programa de control estándar y su funcionamiento se prueba sin saber exactamente si es el correcto para lo que se quiere hacer.

Transacciones para trabajar con Customer Exit o Exit del cliente:

· SMOD: Para administrar ampliaciones

· CMOD: Gestión de proyectos de ampliación.

Dirigirnos a la transacción SMOD y completar el nombre de la ampliación que contiene el módulo de función a utilizar por el Customer Exit.

Si no se conoce el nombre aún, hay que ir a la transacción SE16, con la tabla MODSAP, en el campo MEMBER completar con el nombre del módulo de función a buscar (como EXIT_SAPMV45A_003)
y el campo NAME dirá la ampliación que la contiene.

Si no se conoce el módulo de función especifico, se debe buscar en el código del programa estándar, las llamadas a funciones de usuario, que estarán indicadas por CALL CUSTOMER-FUNCTION ‘001’, donde el número del final puede ir cambiando si presenta más de una llamada, es decir, varios Customer Exit.

Una vez que se tiene el nombre de la ampliación (en este ejemplo: V45A0003) lo colocamos en el campo Ampliación, presionar en Visualizar y en la pantalla siguiente, hacer click en componentes. Aquí se pueden ver los objetos y tablas que pueden modificarse.

Cada uno de los módulos de funciones que se ven aquí, serán ejecutados en algún momento de la ejecución del programa al cual pertenecen (en este caso SAPMV45A).

Una vez que se sepa qué módulo de función se debe usar, se hace doble click sobre el mismo, y luego se mostrará una pantalla en la cual se pueden ver los objetos que importa y exporta esta función, como también las tablas que importa y que pueden modificarse, las cuales se utilizarán en el código fuente.

En la solapa Cód.fte se encuentra el include Z que se utiliza para agregar el código del usuario.

Nota: en las últimas versiones empieza por ZX y si no se utilizó anteriormente, deberemos crearlo, ya que no existirá.

Si el include no existe, al hacer doble click sobre el mismo, se pedirá una orden de transporte para poder generarlo. Una vez creado se pude generar el código ABAP utilizando los objetos "Import, Modific y Tablas", y posiblemente devolviendo resultados modificando los objetos que se encuentran en las solapas Export, Modif. y Tablas.

Nota (Audio tip): Tal como mencionamos dentro del include ZXVVAU05 vamos a escribir el código ABAP que colocaremos dentro del Exit. En general el código que colocaremos dentro de los Exit será destinado a realizar validaciones de los campos de entrada. En caso de cumplirse una condición determinada se emitirá en pantalla un mensaje de error que impedirá el normal funcionamiento de la transacción. Caso contrario se continuará con el procesamiento normal.

Una vez terminada la codificación la ampliación debe activarse e incluirse en un proyecto, los cuales son creados en la transacción CMOD. Allí se debe generar un proyecto Z en el cual se incluirán las ampliaciones que se desee (para agrupar, clasificar y controlar los Customer Exit, se crea un proyecto de ampliación).

Un proyecto de ampliación asocia n ampliaciones. Su activación o desactivación afecta a todas las ampliaciones asociadas.

Para crear un proyecto se utiliza la transacción CMOD. Allí se le asigna el nombre del proyecto (debe empezar con Z) y hacemos click en Crear.
Luego en la pantalla que se despliega, hacemos click en Asignación ampliación luego de dar una breve descripción. En la siguiente pantalla, introducir las ampliaciones y hacer click en Componentes para visualizarlos.

En la pantalla de componentes vamos a activar la ampliación haciendo click en el botón de activación. Cada componente son los Exit de la ampliación, y es allí donde se debe incorporar el código de validación o proceso a controlar con la ampliación.
El botón de al lado se usa para “desactivar”.

Una vez activado, el proyecto de ampliación pasara a color verde

Nota: Recordar que si el Exit no está activo, la llamada a esta función no tendrá efecto alguno.

Uno de los retos en la utilización de Customer Exit es ubicarlos y conocer el momento del proceso en el programa en el cual ocurren los mismos, con el propósito de determinar qué datos y qué particularmente se puede hacer en ese momento.

Para ayudarnos en esta investigación, lo más efectivo será crear un proyecto de ampliación, asignar la ampliación, activarla y luego colocar un BreakPoint en el módulo de funciones, para determinar los datos con los que se dispone en ese momento y el punto exacto del proceso en donde se encuentra.