The configuration process described in the following steps configures
the adapter, creates business objects for outbound ALE IDocs, and if desired,
creates an IDoc wrapper business object for an IDoc packet of multiple individual
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
- Switch to the Business Integration perspective in WebSphere® Integration
Developer.
- Right-click the frame of the Business Integration perspective
window and select 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.
- 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.
- 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.
- At the bottom of the window, click the Show Advanced button.
- 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.
- Click Next.
- In the Find and Discover Enterprise Services window,
click Run Query.
- 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.

Drilling down to discover by description
- 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 end of the name to indicate that you want
to discover all SAP application components that start with the specified name.
- Click OK.
- Navigate to the desired Basic
or Extension IDoc and click the Add button. The Configuration
Parameters window appears.

Configuration Parameters window
- In the Configuration
Parameters window, do the following to add the IDoc to the list
of business objects to be imported.
- If you want to create an ALE wrapper object (for an IDoc packet
of multiple individual IDocs), select the Create ALE wrapper check
box.
- Select the Use SAP Field Name to generate attribute(s) check
box.
- In the Enter the Release field, specify
the SAP release number to identify the IDoc type you want the enterprise service
discovery wizard to use for creating business objects. Note that
you can specify an earlier release than the one you are currently using, if
for some reason you wish to create business objects based on earlier versions
of the IDoc type. If the earlier version of the IDoc type has fewer segments
than the current version, the enterprise service discovery wizard may create
a definition with missing segments or it may display an error indicating that
the generation of the business object definition was unsuccessful. This inconsistency
is due to different versions of SAP requiring different API calls.
- Click OK.
- 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.
- If you want to remove an object from the list, select the object
name and click Remove.
- Click Next to proceed.
- In the Configure Objects window, enter BODEFS in
the Object Location field, specify the name space, and select Outbound in
the ServiceType field.
- Click Add. The Add window appears with a
list of operations you can select to associate with this business object.
For outbound, the only operation you can select is Execute.
- Select the operation and click OK. The Configure Objects window appears with the selected operation
listed under Operations.

Configure Objects window
- Click Next.
- In the Generate Artifacts window, click New and
then specify the module name where the SCA artifacts (business objects, their
properties, import file, export file, and WSDL) should be saved.

Generate Artifacts
window
- In the Generate Artifacts window, specify
the folder within the module where the service description should be saved.
- In the J2C Authentication Data Entry field,
enter SAP_Auth_Alias and select the Deploy
connector with module check box.
- 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).
- 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.