Modification Concept (Customer Functions) 

This section provides an overview on the customer functions and change options in processing that affect the interface.

Inbound Processing (Receipt of IDocs from Subsystem)

The following modifications are possible:

The following describes individual modification options.

Once an IDoc has been received and saved, a framework function module in the SAP application is triggered which takes over the processing of the IDoc. This provides the first option where you can generate your own processing function module. In order to call this up you will have to enter it in an ALE Customizing table (transaction WE42 : Process codes inbound ® Inbound with ALE service ® Processing by function module). You can then specify the defined process code in the inbound partner profile. Available framework function modules are assigned according to the following message categories:

Inbound Framework Function Module

Message type

Function module

Significance

SHIPPL

IDOC_INPUT_SHIPPL

Shipment document

 

The framework function module filters out the user data per IDoc and calls up your own processing function module in the application for every IDoc in a loop. All data is then saved together in the database.

A customer function is implemented before and after processing each IDoc and after saving all shipment data.

You can use the customer function before processing the IDoc to manipulate data in the IDoc before it is transferred to the application functions. After IDoc processing, the customer function allows you to process your own segments.

Customer functions for the transportation planning interface can be found in function group XV56 in the R/3 system with the description EXIT_SAPLV56I_0xx. You can use transaction SMOD to access enhancements. The names begin with ‘V56I’. The documentation for each function module describes how to use the available customer functions. Activating customer functions takes place in transaction CMOD. Consult the R/3 System online documentation for instructions on how to use SMOD and CMOD.

Customer Functions Inbound Shipment

EXIT_SAPLV56I_010

Modification of IDoc segments

EXIT_SAPLV56I_011

Modification of shipment tables

EXIT_SAPLV56I_012

Save your own shipment tables

 

When creating your own function module or using customer functions, you must make sure that you do not set Commit work, because the function module branches back into the ALE service level after processing. Application errors are copied, IDoc status is set and rollbacks may be listed in the ALE service level. After Commit work, a rollback can no longer be carried out if an error occurs. This could lead to partially-posted IDocs and therefore to inconsistencies during error processing.

Keep in mind that further I/Os that occur in the customer functions can reduce performance.

You can define your own IDoc segments in IDoc maintenance (WE30). Refer to the corresponding documentation for the ALE group.

You can define your own IDoc the same way you maintain your own segments. This IDoc needs to be assigned to a new output type. For this output type, you must set a partner profile. You must also maintain the tables for entry in transaction WE42.

You have the following modification options for the individual modification scenarios:

Outbound Processing (Transmitting IDocs to a Subsystem)

The following modifications are possible:

The following describes individual modification options.

The formatting for the transmission of IDocs is carried out in the application. The IDoc is assembled, the partner is determined and the configurations are made for the ALE layer. IDoc assembly is carried out in the application function modules.

This is your first opportunity to carry out modifications by creating your own function modules. To ensure that this is called up by the application, you have to link it to the required application menu yourself.

 

The following function modules from function group V561 are used in the transportation planning interface for constructing and transmitting standard IDocs:

Function modules outbound processing

IDOC_OUTPUT_CFPREQ

Individual planning requests (when transmitting using message control)

IDOC_OUTPUT_SHIPPL

Shipment status

IDOC_OUTPUT_STATUS_TPS

Error status

 

For the outbound function modules for transmission of planning requests, the following customer functions are available for adding your own IDoc segments and/or changing the standard IDoc construction. The following list displays all available customer functions for outbound processing of planning requests. The function groups and transactions displayed for inbound processing are also valid for customer functions in outbound processing.

Customer Functions for Outbound Planning Requests

EXIT_SAPLV56I_001

Modification of the delivery header segment in the IDoc

EXIT_SAPLV56I_002

Modification of the delivery item segments in the IDoc

EXIT_SAPLV56I_003

Modification of the packing data segments in the IDoc

EXIT_SAPLV56I_004

Modification of the entire IDoc before transmission

EXIT_SAPLV56I_005

Modification of material cumulation

EXIT_SAPLV56I_006

User-specific location substitution

EXIT_SAPLV56I_007

Deactivation of the conversion block for deliveries

EXIT_SAPLV56I_020

Change in IDoc control record

 

As mentioned in inbound processing, you define your own IDoc segments in IDoc maintenance. A customer-specific IDoc can also be defined for outbound processing. Apart from IDoc definition, you only need to maintain the partner profile for outbound processing here.

You have the following modification options for the individual modification scenarios: