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 outbound processing > Configure a module for the BAPI interface

Selecting business objects and services for BAPI outbound processing

To specify the BAPI function or functions that you want to call and the data you want to process, you provide information in the external service wizard.

Ensure that you have set the connection properties for the external service wizard.

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

To specify the search criteria and select one or more BAPI 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 icon.

    2. Click the filter button. The Filter Properties window is displayed.

      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. 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 default 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) to show the objects that match the search criteria of BAPI_CUSTOMER*.

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

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

  5. In the Configuration Properties 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 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 name of the top-level object and associated operation).

Configure a module for the BAPI interface


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