Configuring the service for a simple BAPI

The configuration process described in the following steps configures the adapter and creates business objects for different BAPI calls that are associated with a customer.

Why and when to perform this task

For information about configuring other business objects, refer to the appropriate service configuration topics.

Steps for this task

  1. Switch to the Business Integration perspective in WebSphere® Integration Developer.
  2. Right-click the frame of the Business Integration perspective window and select New > Enterprise Service Discovery from the pop-up menu. If Enterprise Service Discovery is not visible, select Other from the bottom of the pop-up menu. Then, in the window that appears, expand the Business Integration folder and select Enterprise Service Discovery and click Next.
  3. When prompted to select an adapter to use for discovering the service, select IBM WebSphere Adapter for SAP Software and click Next. If you have previously run the enterprise service discovery wizard, your connection properties have been saved and will appear when you expand the adapter name node by clicking the plus symbol (+) next to the adapter name. You can select the saved connection properties if you plan to connect to the same SAP application as when you last ran the enterprise service discovery wizard.
  4. When prompted to specify properties in the Configure Settings for Discovery Agent window, specify the connection configuration properties for connecting to SAP. Be sure to set the Select Module property (under Metadata Properties) to the value of BAPI. Properties marked with an asterisk (*) are mandatory.


    This image is described in the surrounding text.

    Specifying properties

  5. At the bottom of the window, click the Show Advanced button.
  6. When prompted to specify logging options, specify a log file location and set the Logging Level. In a test environment, choose FINEST, which provides the highest level of logging. In a production environment, choose a level lower than FINEST, so as to optimize the logging process.
  7. Click Next.
  8. In the Find and Discover Enterprise Services window, click Run Query. The objects discovered by the query are grouped into two BAPI categories: RFC and BOR.
    This image is described in the surrounding text.

    BAPI categories

  9. Under Objects Discovered by query, select RFC or BOR, drill down to the Discover By Name node, and click the Filter button. Or, you can drill down to Discover By Description.
  10. In the Filter Properties for Discover by Name window, enter BAPI_CUSTOMER*, which is the name of the BAPI in SAP plus an asterisk as a wild card character to indicate that you want to discover all SAP application components that start with BAPI_CUSTOMER.
  11. Click OK.
  12. Select the following BAPIs:
    • BAPI_CUSTOMERCRM_CREATE
    • BAPI_CUSTOMERCRM_CHANGE
    • BAPI_CUSTOMERCRM_DELETE
    • BAPI_CUSTOMER_GETLIST
  13. In the Configuration Parameters window, do the following to add the selected BAPIs to the list of business objects to be imported:
    1. Select the Use Field Name to generate attribute(s) check box.
    2. Select the Check if you want to select optional parameters for this interface check box and then select the optional parameters you want included in your business object definition. By default, enterprise service discovery generates the mandatory parameters for the selected BAPI interface, so select this check box to also include the optional parameters.
    3. Click OK.
    The selected objects appear in the bottom window frame.
    This image is described in the surrounding text.

    Business objects to be imported

  14. Repeat step 12 and step 13 for the following objects and then click Next:
    • BAPI_CUSTOMERCRM_CREATE
    • BAPI_CUSTOMERCRM_CHANGE
    • BAPI_CUSTOMERCRM_DELETE
    • BAPI_CUSTOMER_GETLIST
    The selected objects appear in the bottom window frame.
  15. If you want to remove an object from the list, select the object name and click Remove.
  16. After you have added all the objects to be discovered, click Next to proceed.
  17. In the Configure Objects window:
    1. Enter the directory name, for example BODEFS, for the object location. This specifies a directory that is relative to the project’s directory in the WebSphere Integration Developer workspace.
    2. Specify the name space.
    3. Enter the name of the business object. For example, BapiCustomer.
    4. Do not select the Check this for creating BAPI transaction object check box.

      This image is described in the surrounding text.

      Configure Objects window for multiple BAPI selection

      If in Step 12 you selected a single BAPI, for example BAPI_CUSTOMERCRM_CREATE, then instead of the previous screen, the following screen appears. Use the following screen to specify the object location and business object name and click Add to add the operation(s) you want to associate to the single BAPI.
      This image is described in the surrounding text.

    Configure Objects window for single BAPI selection

  18. Specify the appropriate JCo methods for each of the object’s operations. For example, specify the following methods:
    • For the CREATE operation, specify BAPI_CUSTOMERCRM_CREATE.
    • For the UPDATEWITHDELETE operation, specify BAPI_CUSTOMERCRM_CHANGE.
    • For the RETRIEVE operation, specify BAPI_CUSTOMER_GETLIST.
    • For the DELETE operation, specify BAPI_CUSTOMERCRM_DELETE.
  19. Click Next.
  20. In the Generate Artifacts window, click New to create a new business integration module and then specify BapiCustomer for the module name where the SCA artifacts (business objects, their properties, import file, export file, and WSDL) should be saved.
    This image is described in the surrounding text.

    Generate Artifacts window

  21. In the Generate Artifacts window, specify the folder within the module where the service description should be saved.
  22. In the J2C Authentication Data Entry field, enter SAP_Auth_Alias and select the Deploy connector with module check box.
  23. Click the Use discovered connection properties radio button to set properties at this time. (The Use connection properties specified on server button lets you configure properties later, using the WebSphere Process Server administrative console).
    This image is described in the surrounding text.

    Specifying properties

  24. Specify the connection properties and then click Finish. Properties marked with an asterisk (*) are required.

Result

The new BapiCustomer module is added to the Business Integration perspective, along with all its artifacts.

What to do next

After you configure the service, the next step is to generate reference bindings. The purpose of reference bindings is to link the adapter to other server processes.
Related concepts
Learning about business objects for the BAPI interface
Related tasks
Generating reference bindings
Enabling logging

Terms of use |

Last updated: Sun Mar 12 11:15:16 2006

(c) Copyright IBM Corporation 2005.
This information center is powered by Eclipse technology (http://www.eclipse.org)