Modification Concepts: IDoc Inbound Processing (SAP Library

Modification Concepts: IDoc Inbound Processing

Use

The following modification scenarios are available to you:

You use the standard IDoc but want to define the processing yourself.

You create a user-defined processing module, which you copy from the standard function module for the respective message type and adjust accordingly.

You use the standard IDoc but want to adjust the standard IDoc processing. That is to say, you want to modify error processing or want to interpret the contents of the IDocs to suit your individual needs.

You activate the customer exits in the standard function module:

If you want to influence error processing, you activate the customer exit for Own error status.
If you want to influence IDoc processing, you activate the customer exit for Own updates.

You use a modified IDoc with user-defined segments and want to execute a particular process for the data from these segments.

You define your own IDoc segments in the standard IDoc and use the customer exit for Own update to process the data from the user-defined segments.

You use a modified IDoc with customized segments and want to define IDoc processing yourself.

You define customized IDoc segments in the standard IDoc and create a customized processing function module.

You use a user-defined IDoc with a new message type and have to implement processing of the IDoc on your own.

You define a user-defined IDoc and create a user-defined processing function module. You can use the standard auxiliary function module to create the function module.

Features

Adjusting the Standard Function Module

As soon as the SAP system has received the IDoc and saved it, the system calls a main function module of the application, which takes over the processing of the IDoc.

At this point, you have the first opportunity to intervene in the IDoc processing, by creating a user-defined function module.

You enter this function module in the SAP menu under Tools ® Business Communication ® IDoc-Basis ® Development ® Inbound Processing Settings ® Message/Application Object.

There, you can also enter an additional partner profile for a certain message variant or message function from the external system in order to differentiate processing in the SAP system.

Main function modules for inbound IDoc processing

Message Type	Function module	Use
WMBBIN	L_IDOC_INPUT_WMBBIN	Blocking storage bin
WMCATO	L_IDOC_INPUT_WMCATO	Canceling TO
WMINFO	L_IDOC_INPUT_WMINFO	Information
WMINVE	L_IDOC_INPUT_WMINVE	System inventory records
WMMBXY	L_IDOC_INPUT_WMMBXY	Goods movements
WMSUMO	L_IDOC_INPUT_WMSUMO	Moving a storage unit
WMTOCO	L_IDOC_INPUT_WMTOCO	Confirming TO
WMTORD	L_IDOC_INPUT_WMTORD_MULTIPLE	Transfer orders (TO)
WMTREQ	L_IDOC_INPUT_WMTREQ	Releasing group

The main function module filters out the data for each IDoc and calls the actual processing function module of the application in a loop.

Activating Customer Exits

A customer exit is implemented both before and after the call of this function module.

You can use the customer exit after the function module call to update a user-defined error status or to change the set error status.

You can use the customer exit before the call of the function module, for example to execute user-defined updates or to valuate user-defined segments, which you have added in the IDoc definition.

Note

Take the names of the customer exits from the source code of the main function module.

If you create a function module or use customer exits, note that no COMMIT WORK command is set, as this can lead to errors in IDoc processing and to inconsistencies in error processing. The system returns to the ALE layer following processing, where the system updates any application errors that have occured, sets the IDoc status, and may even execute database rollbacks.

Note

Note, that additional I/Os which occur in the customer exit, can affect performance.

Defining User-Defined IDoc Segments

You defined your own IDoc segments by choosing Tools ® Business Communication ® IDoc Basis ® Development ® IDoc Types. For more information, see Segment Editor.

Creating User-Defined Processing Function Modules

The SAP system offers function modules for general use for the following tasks for using user-defined main function modules:

Auxiliary function modules for inbound IDoc processing

Function module	Task
L_IDOC_CONTINUE_SAVE	Continuously save application objects for subsequent activities
L_IDOC_CREATED_OBJECTS_SAVE	Continuously save the documents created from an IDoc
L_IDOC_ERROR_SAVE	Continuously save IDocs with errors
L_IDOC_INPUT_REFRESH	Initialization for IDoc processing (table refresh)
L_IDOC_OK_SAVE	Continuously save processed IDocs
L_IDOC_RETURN_CREATE	Determine and construct status record for the IDoc
L_IDOC_ROLLBACK_SAVE	Update IDoc tables after necessary rollback
L_IDOC_STATUS_CREATE	Determine and construct status record for the IDoc
L_IDOC_TIDOC_FETCH	Fetch internal table for the purpose of status update

Defining User-Defined IDocs

If you define user-defined IDocs (interim structure) via Tools ® Business Communication ® IDoc Basis ® Development ® IDoc Types, assign this IDoc to a new message type. For more information, see Defining New IDoc Types.

You create a partner profile for this message type.

You define the tables for inbound processing for this IDoc under Tools ® ALE ® ALE Development ® IDoc ® Inbound Processing.

Standard task TS00008099 is available for error processing.