Configuring the service for an inbound ALE IDoc

The configuration process described in the following steps configures the adapter and creates business objects for inbound ALE IDocs.

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 appear when you expand the adapter name node (click 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 adapter configuration properties for connecting to SAP. Properties marked with an asterisk (*) are mandatory. Be sure to set the Select Module property (under Metadata Properties) to the value of ALE.
  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, chose 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.
  9. Under Objects Discovered by query, drill down to the Discover By Name node, and then click the Filter button. You can also drill down to Discover By Description, as illustrated in the following screen.
    This image is described in the surrounding text.

    Discovering IDocs by name

  10. In the Filter Properties for Discover by Name window, enter the name of the IDoc you want to discover. You can include an asterisk (*) as a wild card character at the beginning or end of the name to indicate that you want to discover all SAP application components that contain the specified name.
  11. Click OK.
  12. Navigate to the desired Basic or Extension IDoc and click the Add button. The Configuration Parameters window appears.
    This image is described in the surrounding text.

    Configuration Parameters window

  13. In the Configuration Parameters window, do the following to add the IDoc to the list of business objects to be imported.
    1. Do not select the Create ALE wrapper check box.
    2. Select the Use SAP Field Name to generate attribute(s) check box.
    3. Do not change the value of the Enter the Release field.
    4. Click OK.
  14. Repeat step 12 and step 13 for each IDoc you want to discover and then click Next. 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. Click Next to proceed.
  17. In the Configure Objects window, enter BODEFS in the Object Location field, specify the name space, and select Inbound in the ServiceType field.
  18. Click Add. The Add window appears with a list of operations you can select to associate with this business object.
  19. Select the operation and click OK. The Configure Objects window appears with the selected operation listed under Operations.
  20. Select the operation and click OK. The Configure Objects window appears with the selected operation(s) listed under Operations.
    This image is described in the surrounding text.

    Configure Objects window

  21. Click Next.
  22. In the Generate Artifacts window, specify 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

  23. In the Generate Artifacts window, specify the folder within the module where the service description should be saved.
  24. In the J2C Authentication Data Entry field, enter SAP_Auth_Alias and select the Deploy connector with module check box.
  25. In the Generate Artifacts window, 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).
  26. Specify the connection properties and then click Finish. Properties marked with an asterisk (*) are required.

Result

The new 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 ALE 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)