Show TOC Start of Content Area

Background documentation Design Recommendations for Interfaces  Locate the document in its SAP Library structure

So that BAPIs can be used intuitively, you should follow the design recommendations below:

 

This graphic is explained in the accompanying text

Parameter data should be grouped together according to business criteria.

This graphic is explained in the accompanying text

The inbound interface should be clearly structured and intuitive. Parameters should in the first instance be structured in accordance with the application.

Example

Example: Structured parameters should be structured so that they contain all the fields required for the simplest application in one logical block. Additional fields required for special cases should be grouped by application and attached to the "main block".

This graphic is explained in the accompanying text

The interface must not contain any fields that external users would not be able to interpret. You must also try to remove any internal details specific to SAP.

This graphic is explained in the accompanying text

You should check whether scalar parameters might be used in the future as (more complex) selection parameters (for example in the definition of ranges).

This graphic is explained in the accompanying text

To avoid later changes to the interface, which may be incompatible, parameters should be created as “optional” wherever possible.

This graphic is explained in the accompanying text

Whenever possible, search help (F4 help) should be provided for parameters and parameter fields. This enables the client to easily determine all the possible input values for a field by calling the BAPI Helpvalues.GetList.
See also: Providing Input Help (F4 Help)

Example

A search help is defined for the AirlineID parameter (airline ID) in the Flight.GetList method. If you call the Helpvalues.GetList method, the system finds all existing airline IDs.

This graphic is explained in the accompanying text

Dependencies between data fields and between parameters must be included in the documentation.

This graphic is explained in the accompanying text

All the information supplied with a BAPI should be able to be used easily without having to change any of the data. So export structures should be able to be reused as the input of a different BAPI.

This graphic is explained in the accompanying text

All key fields in GetDetail() and GetList() BAPIs must be displayed as text fields.

Note

If there are several texts for one key field, these texts must be stored in a separate table.

This graphic is explained in the accompanying text

When you are structuring the interface, you should consider what the BAPI is used for.

·         With BAPIs used for batch processing performance is the most important consideration in the design.

·         BAPIs used for alternative front-ends require a more flexible interface as they tend to be used in more complex processes.

 

 

 

End of Content Area