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 work unit interface

Selecting business objects and services for BAPI work unit processing

To specify which BAPI functions you want to call and which data 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 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 the BAPI functions for the work unit, use the following procedure.


Procedure

  1. In the Specify the Discovery Properties window, indicate which BAPI 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. Then skip ahead to step 4.

  2. From the Filter Properties window, specify information about the 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 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 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 the original character case of SAP field names to generate business object attribute names check box. By default (when the check box is not selected), the field descriptions are used to generate properties.

    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 functions that match the search criteria, and you have selected the functions you want to work with. The Specify Composite Properties window is displayed.


What to do next

Provide information about the business objects (such as the name of the top-level object and associated operation).

Configure a module for the BAPI work unit interface