If a business object type consists of sub-objects, you can implement the following standardized BAPIs to add or remove sub-objects:

• Add<name of sub-object>

• Remove<name of sub-object>

The BAPIs Add<Name of sub-object>() and Remove<Name of sub-object>() are instance methods.

You should keep the following points in mind when defining the import parameters:

• The import parameters in the function module of both BAPIs must contain the key fields of the corresponding business object type. The names of the parameters must be identical to the names of the object keys in the BOR and must have the same data elements.

• Parameters are also required for the data that uniquely identifies the sub-object in question.

• The BAPI must also have a TestRun parameter that enables it to execute test runs. If this parameter is filled with the value "X", the BAPI executes normally, but does not write the results to the update task. In this way, after the BAPI BapiService.TransactionCommit executes, all results, such as the application log, for example, can be evaluated, but the BAPI has not modified the database.

You should keep the following points in mind when defining the export parameters of a Remove<name of sub-object>() BAPI:

• To report messages from the method call back to the calling program, you should create only the export parameter Return. To ensure the results of a Remove<name of sub-object>() BAPI, called either synchronously or asynchronously, are monitored extensively, the following conventions for filling the Return parameter must be observed:

• If the BAPI executes successfully, in other words, the desired sub-object is deleted, the following standardized T100 message must be passed in the Return parameter:

• The field MESSAGE_V1 contains the external name of the business object, such as SalesOrder, whose sub-object was deleted.

• The key under which the object, whose sub-object has been deleted, is accessed, is returned in MESSAGE_V2. This is the external key when external number assignment is used, or the internal key when internal number assignment is used. If the object has several key fields, the values of these key fields must be concatenated in MESSAGE_V2. The sequence in which the key fields are defined in the BOR must be adhered to for the concatenation. Moreover, the maximum length must be used for each key field. This may require the use of padding.

• If an error occurs during the execution of the Remove<name of sub-object>() BAPI, in addition to the application-specific error messages the following standardized message must be passed in the Return parameter:

• In addition to the standardized message, further messages can be written in the Return parameter. It is of particular importance when errors occur that messages describing the errors in detail are returned. You should, therefore, use all of the fields of the structure BAPIRET2. You should, in particular, fill the fields Parameter, Row and Field.

You should keep the following points in mind when defining the export parameters of an Add<name of sub-object>() BAPI:

• To report messages from the method call back to the calling program, you should create the parameter Return. To ensure the results of an Add<name of sub-object>() BAPI, called either synchronously or asynchronously, are monitored extensively, the following conventions for filling the Return parameter must be observed:

• If the BAPI executes successfully, in other words, the desired sub-object is created, the following standardized message must be passed in the Return parameter:

• If an error occurs during the execution of the Add<name of sub-object>() BAPI, in addition to the application-specific error messages the following standardized message must be passed in the Return parameter:

• In addition to the standardized message, further messages can be written in the Return parameter. It is of particular importance when errors occur that messages describing the errors in detail are returned. You should, therefore, use all of the fields of the structure BAPIRET2. You should, in particular, fill the fields Parameter, Row and Field.