Usually enhancement takes place when the content in IDocs provided by SAP are not sufficient for the

business process. IDoc extension can take place whenever dictionary table has a new structure
appended required by the business process.

In brief IDoc extension takes place when extra fields are required for the business process.

Let us take a scenario and understand the process of IDoc extension.

In this scenario say visitor is different from the actual customer who has came to the sales office in
behalf of the customer to obtain the quotation or inquiry etc. Or an authorized agent qualified by
the actual customer to order for items. So a field by name NAMEVI (Visitor) is added to Customer
master data. As there is no provision given by SAP to handle this, we need to extend an IDoc.

The standard message type and IDoc type provided by SAP are DEBMAS and DEBMAS05.

Consider the data in the table below for extending the IDoc. These details can be understood in
different sections in the process of extending it.

Basic IDoc type DEBMAS05

Version 4.7

IDoc extension DEBMASEXT

Custom segment Z1KNA1

Fields in Custom Segment Visitor

Parent of Custom Segment E1KNA11

Outbound process

Step1. Customize kna1 table by appending a structure provided by SAP (ZAKNA1)

Component Component Type

VISITOR NAMEVI

Step2: Write a module pool program to update some existing customers to add data for Visitor.

Step3: Create a custom segment

Transaction Code: WE31

Segment type: Z1KNA11 Click (create). Provide short text

 Field Name Data element

VISITOR NAMEVI

Save

Step4: Create IDoc extension

Transaction WE30

Object Name DEBMASEXT

Choose Extension

Click and it leads to next screen.

Linked basic type: DEBMAS05

Provide description and enter

Observe all the segments to be copied into your IDoc extension from linked basic

type.
Select E1KNA11 and click (create segment) to obtain a popup window

Provide the required values and observe child segment Z1KNA11 to be added to

parent segment E1KNA11.

Step5: Release segment and IDoc extension

Transaction: WE31

Segment type: Z1KNA11

Path: Edit Set release

Step6: Assign Basic type to extension / messages

Transaction: WE82

Click , then

Select DEBMAS message type against DEBMAS06 basic type

Click provide the information

Message Type Basic Type Extension Version

DEBMAS DEBMAS06 DEBMASEXT 4.7

Delete the earlier one from which it was copied.

Save.

Observe the result as follows

Step 7: Check and Transport IDoc extension

Transaction: WE30

Object name: DEBMASEXT

Path: Development object -> Check

Ensure that there are no errors or warnings

Now transport

Path: Development -> Transport

Step8: Find suitable user exit for writing code to support IDoc extension

Transaction: SE84.

Click Enhancements

In short text provide *customer*

Find suitable enhancement to be VSV00001

Alternative way

Transaction: SMOD

Click F4 help for Enhancement

Path: F4help -> SAP Applications -> Logistics general -> Logistics Basic Data ->

Business partners -> Vendor Master.

Find the enhancement as VSV00002, which is an approximate user exit.

Now search for different extensions like VSV00001. Then see for its components.

Identify the appropriate user exit to be EXIT_SAPLVV01_001 (Create Export of

Additional Customer Master Segments). This user exit can be used in outbound ALE

process, meant for filling the data into custom segments.

You have to identify here another user exit as EXIT_SAPLVV02_001, which is

helpful for inbound ALE process. This user exit can be used to read the segments

and post it to Application repository.

Step9: Develop a project to encapsulate enhancements and components.

Transaction: CMOD.

Enhancement: custex and click Create to provide attributes.

Click Enhancement Assignments.

Provide VSV00001, short text and save.

From the initial screen of the transaction, select components and click change.

Find 4 components to be added.

Activate them.

Select user exit EXIT_SAPLVV01_001 for outbound process and double click it. It leads to
function builder.

Double click on provided include program ZXVSVU01 and press enter.

Now, write supporting code for IDoc extension, i.e., populating custom segments in IDoc.

Check the code and activate.

Code in ZXVSVU01

*&---------------------------------------------------------------------*

*& Include ZXVSVU01 *

*&---------------------------------------------------------------------*

*In this scenario, the E1KNA11 has been extended to accommodate

*User-defined fields in the customer table kna1. The name of the

*extended

*segment is z1kna11. There is one custom field: visitor

*&---------------------------------------------------------------------*

*Data declarations

DATA: kna1m like e1kna1m,

kna11 like e1kna11,

 z1kna11 like z1kna11,

w_kna1 like kna1.

* make sure you are processing correct message type

check message_type eq 'DEBMAS'.

* make sure data is added after the correct segment

check segment_name eq 'E1KNA1M'.

* since customer number is not passed in this user exit, you need to go

* through the data records to find the customer number

loop at idoc_data.

case idoc_data-segnam.

when 'E1KNA1M'.

move idoc_data-sdata to kna1m.

when 'E1KNA11'.

move idoc_data-sdata to kna11.

endcase. " case idoc_data-segname.

endloop. " loop at idoc_data.

* select data from the user-defined fields in kna11.

select single *

from kna1 " Customer master table

into w_kna1

where kunnr = kna1m-kunnr.

if sy-subrc eq 0.

* set the idoc extension name for control record

idoc_cimtype = 'DEBMASEX'.

* clear custom fields from kna1 to extended segment

clear z1kna11.

* copy custom fields from kna1 to extended segment

move-corresponding w_kna1 to z1kna11. " field name must be same

* condense all fields of extended segment

condense: z1kna11-visitor.

* populate segment name in the data record, copy data contents into it

* and append the data record to existing data records in

move 'Z1KNA11' TO IDOC_data-segnam. " administrative section

move z1kna11 to idoc_data-sdata. " data section

append idoc_data.

endif. " if sy-subrc eq 0.

Step 10:

Define Logical System

Assign client to Logical System

Maintain RFC Destination

Maintain Customer Distribution Model

Generate Partner Profiles

Distribute Customer Distribution Model

INBOUND PROCESS

Step 11: Append the custom structure to the table KNA1 similar to the process done

in outbound process.

Step 12.

Define Logical System

Assign client to Logical System

Generate Partner Profiles

Step 13. Execute the transaction to Send Customers from Outbound system.

Step 14. Now in the Inbound system, create the project in the similar way as done at

outbound side.

In the user exit EXIT_SAPLVV02_001, find include ZXVSVU02. Write the code to

support IDoc extension.

Code in ZXVSVU02

*&---------------------------------------------------------------------*

*& Include ZXVSVU02 *

*&---------------------------------------------------------------------*

data: kna1m like e1kna1m,

kna11 like e1kna11,

z1kna11 like z1kna11.

data fs_kna1 type kna1.

message i000(0) with 'INBOUND PROCESS CALLED'.

LOOP AT IDOC_data.

case idoc_data-segnam.

when 'E1KNA1M'.

kna1m = idoc_data-sdata.

when 'E1KNA11'.

kna11 = idoc_data-sdata.

when 'Z1KNA11'.

z1kna11 = idoc_data-sdata.

select single *

from kna1

into fs_kna1
 where kunnr = kna1m-kunnr.

if sy-subrc eq 0.

update kna1

set visitor = z1kna11-visitor

where kunnr = kna1m-kunnr.

else.

idoc_status-docnum = idoc_control-docnum.

idoc_status-status = '51'.

idoc_status-msgty = 'E'.

idoc_status-msgid = 'ZE'.

idoc_status-msgno = '005'.

idoc_status-msgv1 = kna1m-kunnr.

append idoc_status.

endif. " if sy-subrc eq 0.

endcase. " case idoc_data-segnam.

endloop. " LOOP AT IDOC_data.

Step 15. Assign FM to extension/Message type

Transaction: WE57

Path: Change New Entries

Select IDOC_INPUT_DEBITOR against DEBMAS06 basic type, to fill extra

information as shown below.

Function Module Basic Type Message Type Extension

IDOC_INPUT_DEBITOR DEBMAS06 DEBMAS DEBMASEXT

Step 16. Execute the transaction to Get Customers.