SAP AZUR Payment Engine

Project Meeting Persistency Layer Training

May 10th, 2006

AGENDA

1.

La arquitectura de Payment Engine

2.

Tables

3.

Persistency layer for customizing tables

4.

Methods

5.

Persistency layer for transactional tables

6.

Methods

7.

Q&A

SAP AG 2004, Accenture 2004

p 2, Confidential

La Arquitectura de Payment Engine

Payment Engine usa una arquitectura por

niveles
Process Layer

Entity Layer

Persistency Layer

Table

SAP AG 2004, Accenture 2004

p 3, Confidential

Tables

Podemos separar las tablas de Payment Engine en dos grupos:

- Tablas de Customizing (todas aquellas de tipo /PE1/T_...)
- Tablas Transaccionales (las de tipo /PE1/DB_...)
Las tablas de customizing contienen los datos que tienen que ser actualizados a travs de
la transaccin SIMGH. Esto implica que para todas ellas hay que definir una vista con su
correspondiente mantenimiento.
Las tablas de datos transaccionales se actualizan a travs del proceso normal dentro de
Payment Engine.
La implementacin y el acceso de las clases de persistencia dependen intrnsecamente del
tipo de tabla que estemos construyendo.

SAP AG 2004, Accenture 2004

p 4, Confidential

Persistency Layer for Customizing Tables

Algunos ejemplos de tablas de customizing son /PE1/T_POTYPE, /PE1/T_TRANSTYPE

Todas las clases de customizing tienen la nomenclatura:
/PE1/CL_COMPONENT_T_NAME para CORE
/PE1C1/CL_COMPONENT_T_NAME para CDP
La clase de persistencia de dichas tablas se tienen los siguientes atributos:
S_RCL_INSTREF
S_BUFFER
S_FLG_TABLE_FULLY_READ
CON_GROWING_BUFFER
CON_FULL_BUFFER
CON_NO_BUFFER
S_ACCESS_TYPE
CON_CLASSNAME

SAP AG 2004, Accenture 2004

p 5, Confidential

Persistency Layer for Customizing Tables

La clase de persistencia de dichas tablas se compone de los siguientes mtodos:

* CLASS_CONSTRUCTOR
* CONSTRUCTOR
* S_INSTANCE
* SET_ACCESS_TYPE
* GET_ACCESS_TYPE
* READ
* READ_ALL
* S_ON_CUSTOMIZING_CHANGED

SAP AG 2004, Accenture 2004

p 6, Confidential

Class Constructor

SET HANDLER s_on_customizing_changed.

Customising classes should have a method called
S_ON_CUSTOMIZING_CHANGED which contains the code to clear the buffers.
Across all the customizing persistency classes, these methods are registered to
the event CUSTOMIZING_CHANGED. This event is currently triggered every 10
COMMIT WORKS in the system, however this will probably change so the
customising is only refreshed at the beginning of a process, rather than during a
process.

SAP AG 2004, Accenture 2004

p 7, Confidential

CONSTRUCTOR

CLEAR: s_buffer,
s_flg_table_fully_read.

Este mtodo se llama cada vez que se crea una nueva instancia de
la clase.

SAP AG 2004, Accenture 2004

p 8, Confidential

S_INSTANCE

Devuelve una nueva instancia del objeto cuando no ha sido creada antes
IF s_rcl_instref IS INITIAL.
CREATE OBJECT s_rcl_instref.
ENDIF.
r_instref = s_rcl_instref.

SAP AG 2004, Accenture 2004

p 9, Confidential

SET_ACCESS_TYPE

Asigna uno de los valores vlidos para el atributo s_access_type de forma que
se controlen las opciones de buffering de acceso a la tabla

IF i_access_type EQ con_growing_buffer OR
i_access_type EQ con_full_buffer

OR

i_access_type EQ con_no_buffer.
s_access_type = i_access_type.

SAP AG 2004, Accenture 2004

p 10, Confidential

GET_ACCESS_TYPE

Recupera las opciones de buffering de acceso a la tabla

r_access_type = s_access_type.

SAP AG 2004, Accenture 2004

p 11, Confidential

READ (Growing Buffer)

Para growing buffer la lectura se realiza entrada por entrada.

En primer lugar se chequea si la entrada requerida est en el buffer.
Si no aparece en el buffer entonces se procede a su bsqueda en la base de datos y se
aade dicha entrada al buffer.
Si tampoco estuviera en la base de datos, entonces se lanza una excepcin.

SAP AG 2004, Accenture 2004

p 12, Confidential

READ (Full Buffer)

Para full buffer primero se chequea que la tabla no haya sido leda anteriormente. En caso
negativo se lee la base de datos y se vuelca su contenido en el buffer. Tambin debemos
marcar el flag de fully_read de forma que la proxima vez no se lea de nuevo la tabla
completa.
En caso de que la tabla ya haya sido leida en su totalidad anteriormente, pasamos a leer
directamente del buffer. Si en este caso no encontramos la entrada se lanza una
excepcin.

SAP AG 2004, Accenture 2004

p 13, Confidential

Read (No Buffer)

En caso de no tener buffer la lectura se realiza siempre directamente de la base de datos.

Si no se encuentra la entrada se lanza una excepcin.

SAP AG 2004, Accenture 2004

p 14, Confidential

Read Method

Variantes:
- Puede darse el caso de que la tabla de customizing utilize un buffer basado
en clearing area. En ese caso el buffer se realiza por clearing area, de forma
que cuando se realiza un fully buffer de una tabla se leen todas las entradas
correspondientes a la clearing area que se est manejando.
-Existe tambin la posibilidad de tener una tabla de texto asociada a la tabla de
customizing. En este caso hay que controlar que las entradas
correspondientes a la tabla que han sido leidas tambin se lean.

SAP AG 2004, Accenture 2004

p 15, Confidential

READ ALL

En este caso se devuelven todas las entradas existentes en la tabla. Por este
motivo no se puede hacer distincin entre growing buffer y full buffer, ya que
ambos leeran el buffer en su totalidad.
Si el acceso se realiza sin buffer se leer todo el contenido de la tabla.
En caso de separacin por clearing area se devolvern las entradas
correspondientes a la clearing area en la que se est trabajando.

SAP AG 2004, Accenture 2004

p 16, Confidential

S_ON_CUSTOMIZING_CHANGED

CLEAR: s_buffer,
s_flg_table_fully_read.

SAP AG 2004, Accenture 2004

p 17, Confidential

Persistency Layer for Transactional Tables

Algunos ejemplos de tablas deson /PE1/DB_ORDER, /PE1/DB_ITEM
Todas las clases de customizing tienen la nomenclatura:
/PE1/CL_COMPONENT_D_NAME para CORE
/PE1C1/CL_COMPONENT_D_NAME para CDP
La clase de persistencia de dichas tablas se tienen los siguientes atributos:

S_REF_INSTREF

S_BUFFER

CON_COMPONENT_KEY

CON_CLASSNAME

S_TABLE_NAME

S_TOTAL_COUNT

S_COUNTER

SAP AG 2004, Accenture 2004

p 18, Confidential

Persistency Layer for Transactional Tables

La clase de persistencia de dichas tablas se compone de los siguientes mtodos:

S_INSTANCE
S_GET_COMPONENT_KEY
CLASS_CONSTRUCTOR
CONSTRUCTOR
UPDATE_XX_BUFFER
INSERT
DELETE
UPDATE
READ
S_MEMORY_SYNCH
LOCK
UNLOCK

SAP AG 2004, Accenture 2004

p 19, Confidential

S_GET_COMPONENT_KEY

Get component key devuelve la constante CON_COMPONENT_KEY que es la

clave del componente al que pertenece la clase y la funcin que desempea.

SAP AG 2004, Accenture 2004

p 20, Confidential

CONSTRUCTOR

Actualiza el contador de la clase y llama al mtodo UPDATE_XX_BUFFER

SAP AG 2004, Accenture 2004

p 21, Confidential

INSERT

Se asegura de que la entrada no exista ya ni en el buffer ni en la tabla.

Inserta una entrada en el buffer e incrementa el contador. Tambin rellena los
datos administrativos (CRUSR, CRDAT, CRTIM). La entrada tendr un status
en el buffer I
El contenido del campo GUID tambin se rellena aqu.
En caso de que el contador haya alcanzado su valor mximo llama a la funcin
UPDATE_XX_BUFFER.

SAP AG 2004, Accenture 2004

p 22, Confidential

UPDATE

Se asegura de que la entrada exista o bien en el buffer o en la tabla.

Actualiza la entrada en el buffer sin modificar el contador. Tambin rellena los
datos administrativos (CHUSR, CHDAT, CHTIM). La entrada tendr una
entrada en el buffer U.
El contenido del campo GUID no se modifica.
En caso de que el contador haya alcanzado su valor mximo llama a la funcin
UPDATE_XX_BUFFER.

SAP AG 2004, Accenture 2004

p 23, Confidential

DELETE

Se asegura de que la entrada exista o bien en el buffer o en la tabla.

Actualiza la entrada en el buffer sin modificar el contador. La entrada tendr
una entrada en el buffer D.
Si la entrada ya exista en el buffer con un status I o U actualizamos el
contador.
En caso de que el contador haya alcanzado su valor mximo llama a la funcin
UPDATE_XX_BUFFER.

SAP AG 2004, Accenture 2004

p 24, Confidential

READ

Los mecanismos de lectura varan mucho en funcin de las necesidades y de

la funcionalidad de la tabla.
Normalmente estas tablas van a ser leidas utilizando largas sentencias de
seleccin que permitirn busquedas concretas en la tabla. Manejarn
parmetros como el tamao del paquete, gestn de lecturas de tabla y buffer,
as como de lecturas anteriores.

SAP AG 2004, Accenture 2004

p 25, Confidential

S_MEMORY_SYNCH

Maneja el evento TRANSACTION FINISHED.

Limpia el buffer que hemos utilizado.

SAP AG 2004, Accenture 2004

p 26, Confidential

LOCK

Mtodo que gestiona el bloqueo de entradas en la tabla. Para ello es necesario

definir un objeto de bloqueo. Esto solo se hace cuando la tabla es
transaccional.
No siempre se define un mtodo aparte para el bloqueo. Segn la clase se
puede hacer directamente desde los mtodos INSERT, UPDATE o DELETE.

SAP AG 2004, Accenture 2004

p 27, Confidential

UNLOCK

Mtodo que gestiona el bloqueo de entradas en la tabla. Para ello es necesario

definir un objeto de bloqueo. Esto solo se hace cuando la tabla es
transaccional.
No siempre se define un mtodo aparte para el bloqueo. Segn la clase se
puede hacer directamente desde los mtodos INSERT, UPDATE o DELETE.

SAP AG 2004, Accenture 2004

p 28, Confidential

UPDATE_XX_BUFFER

Mtodo manejador del evento UPDATE_XX_BUFFER.

Dicho mtodo actualizar las entradas del buffer en bse de datos cuando el
evento sea disparado. Dicho evento se dispara cuando el sistema realiza un
COMMIT. La actualizacin se realiza de la siguiente forma:
Para cada una de las posibles acciones (U, I y D), se recorre el buffer. De
esta forma se llama a cada una de las funciones encargadas de realizar dicha
accin para cada una de las entradas.
La llamada a las funciones se realiza de forma inmediata o en UPDATE TASK en
funcin del standardheader.

SAP AG 2004, Accenture 2004

p 29, Confidential

UPDATE_XX_BUFFER
* check the update flag for the function call

ELSE. "X, E: update task

l_flg_update_task = i_rcl_standardheader>get_flg_update_task( ).

CALL FUNCTION function_name IN UPDATE

TASK

* Do the desired operation to the database

IF l_flg_update_task = con_no.
* calling the desired function
CALL FUNCTION function_name
EXPORTING

EXPORTING
i_tab_data = l_tab_data
EXCEPTIONS
failed

inconsistent = 2

i_tab_data = l_tab_data

OTHERS

EXCEPTIONS
failed

=1

ENDIF.

inconsistent = 2
OTHERS

=1

= 3.

SAP AG 2004, Accenture 2004

p 30, Confidential

= 3.

Q&A

SAP AG 2004, Accenture 2004

p 31, Confidential