IBM BPM, V8.0.1, All platforms > Authoring services in Integration Designer > Services and service-related functions > Access external services with adapters > Configure and using adapters > IBM WebSphere Adapters > SAP Software > Configure the module for deployment > Configure the module for inbound processing > Configure a module for BAPI inbound processing

Selecting business objects and services for BAPI inbound processing

To specify which function you want to process, you provide information in the external service wizard.

Make sure you have set the connection properties for the external service wizard.

Specify search criteria that the external service wizard uses to discover functions on the SAP server. The external service wizard returns a list of functions that meet the search criteria.

To specify the search criteria and select one or more functions, use the following procedure.


Procedure

  1. In the Find Objects in the Enterprise System window, indicate which BAPI or set of BAPIs you want to work with.

    1. Click RFC to enable the filter

      button.

    2. Click the filter button.

      Instead of using the filter capability, you can expand RFC and select the function from the list, or you can expand BOR, expand the functional grouping (for example, Cross-Application Components), and select the BAPI. You can now also filter BOR child objects. Then skip ahead to step 4.

  2. From the Filter Properties window, specify information about the BAPI or BAPIs you want to discover:

    1. Select Discover objects by name or Discover objects by description from the Object attribute to use for discovery list.
    2. Type a search string (for example, BAPI_CUSTOMER*) representing the BAPI you want to call.

      This is the name of the BAPI in SAP plus an asterisk as a wild card character to indicate that you want a list of all SAP application components that start with the phrase BAPI_CUSTOMER.

    3. Indicate the number of functions you want returned by changing the value in the Maximum number of objects to retrieve field or by accepting the default value.

    4. Click OK.

  3. Select the BAPI or BAPIs.

    1. Expand RFC (filtered).

    2. From the Discovered object list, select one or more BAPIs that you want to use.

  4. Click the arrow button to add the BAPI or BAPIs to the Selected objects list.

  5. In the Configuration Parameters window...for each BAPI to add it to the list of business objects to be imported:

    1. Optionally, select the Use SAP field names to generate attribute names of business objects check box to generate business object attribute names using the original SAP field names without casing. If you want to generate business object attribute names using the original SAP field name casing, check the Use the original character case of SAP field names to generate business object attribute names check box. By default (when the Use SAP field names to generate attribute names of business objects check box is not selected), field descriptions are used to generate properties.

      This option is not available when you select the Generate business objects according to SAP naming conventions option in the Specify the Discovery Properties window.

    2. Optionally, select the Process Date fields as String check box. This allows the adapter to retrieve SAP-specific date formats which are otherwise non-standard in Java™ by using the String type instead of the Date type format.

      To use this feature, ensure that the above check box is selected while running the external service wizard. As the date fields are converted to string type, ensure that all downstream dependencies (if any) are taken care of.

    3. If the BAPI has optional parameters associated with it, select the Select optional parameters to include as child objects check box, expand Optional parameters, and select the type of parameters (import, export, or table) that you want to work with.

      By default, the external service wizard generates all the parameters required for the selected BAPI, so select this check box and then clear the check boxes for any parameters you do not want to include in your business object.

      If you are adding BAPI_CUSTOMER_GETDETAIL function module, you have the option of adding the following parameters:

      Optional Import Parameters

      • PI_PASS_BUFFER
      • PI_DIVISION
      • PI_DISTR_CHAN

      Optional Export Parameters

      • PE_ADDRESS
      • RETURN

      Refer to the SAP documentation for a list and description of the optional parameters.

    4. Click OK to add the BAPI to the list of business objects to be imported.

    If you want to remove an object from the list, select the object name and click the left arrow.

  6. Click Next


Results

The external service wizard has returned the function or list of functions that match the search criteria, and you have selected the function or functions you want to work with. The Specify Composite Properties window is displayed.


What to do next

Provide information about the business object (such as the operation associated with the object and the SAP remote function call type).

Configure a module for BAPI inbound processing


Next topic: Configure the selected objects


Related concepts:

Business object structure for a simple BAPI


Related reference:

BAPI business object application-specific information

Supported data operations on BAPI business objects

Naming conventions for BAPI business objects