Business object data routing to ABAP handlers

Once the business object data is converted into a flat structure, the business object data is passed into SAP memory by calling the adapter's ABAP function module Y_XR_RFC_DO_VERB_NEXTGEN. Y_XR_RFC_DO_VERB_NEXTGEN does not manipulate the business object data; it simply routes it to the appropriate ABAP handler for further processing. After Y_XR_RFC_DO_VERB_NEXTGEN passes the business object data to an ABAP handler, it waits for business object data to be returned.

Note:
Remember that every business object retrieve and request is processed through Y_XR_RFC_DO_VERB_NEXTGEN.

Y_XR_RFC_DO_VERB_NEXTGEN uses a business object's verb application-specific information to determine which ABAP handler processes the business object data. At runtime, Y_XR_RFC_DO_VERB_NEXTGEN reads the verb application-specific information and passes the business object data to the specified ABAP handler.

Every ABAP handler must reserve the use of verb application-specific information for the connector. The format for the verb application-specific information is:

:function1:function2:function3

where Y_XR_RFC_DO_VERB_NEXTGEN executes function1, passing function2 and function3 as parameters. For example, Customer Update and Material Retrieve execute only function1:

For Create, Update or Delete verbs, specify :Y_XR_RFC_DYNAMIC_TRANSACTION

For the Retrieve verb, specify :Y_XR_RFC_DYNAMIC_RETRIEVE

One of the ABAP handlers provided by the adapter is function module Y_XR_IDOC_HANDLER. This ABAP handler reformats the data of the flat structure into an instance of an IDoc definition and passes that reformatted data to another ABAP handler written to handle that specific type of IDoc. The following examples illustrate the use of the IDoc handler API:

Sales Order Update = :Y_XR_IDOC_HANDLER:Y_XR_ORDER_C2

Sales Order Retrieve = :Y_XR_IDOC_HANDLER:Y_XR_ORDER_C4

In the examples, Y_XR_IDOC_HANDLER is executed and passes the second function module name as well as the business object data. Y_XR_IDOC_HANDLER executes the call to the second ABAP handler to pass the business object data in an IDoc format to the Y_XR_ORDER function module written specifically to handle Order objects. For steps on setting up verb support for the IDoc handler, see "Developing business objects using IDocs".

Note:
Y_XR_RFC_DO_VERB_NEXTGEN uses the value of function1 only. function2 and function3 may be used by the ABAP handler.

To dynamically call an ABAP handler, Y_XR_RFC_DO_VERB_NEXTGEN requires the interface of every ABAP handler to be exactly the same. This enables Y_XR_RFC_DO_VERB_NEXTGEN to send and receive business object data, as well as a return code and a return text message to any ABAP handler. For more information on the functional module interface, see "IBM WebSphere function module interface".

Copyright IBM Corp. 1997, 2003