Enhancing existing adapters with newly discovered objects
In WebSphere® Message
Broker Version 8.0, you can take
an adapter component that was created by using the Adapter Connection
wizard, and update it with newly discovered objects from the Enterprise
Information System (EIS). This facility is known as iterative
discovery. You can either add the new objects without modifying
existing objects, or replace existing objects.
Before you start:The following
instructions assume that you have already run the Adapter Connection
wizard to discover a set of objects, as described in Connecting to an EIS by using the Adapter Connection wizard. You can run iterative discovery only
on projects that were created in WebSphere Message Broker Version 7.0 or
later versions.
- From the Application
Development view, expand the appropriate
message set project folders until you see the .inadapter or .outadapter
component.
- Right-click the adapter component, then click Iterative
discovery.
The Adapter Connection
- Iterative Discovery wizard opens. The fields in the wizard are populated
with the values that you specified when you ran it previously. You
can modify these values if anything has changed, such as a password.
- On the Find and Discover Services page,
the objects that you previously discovered and selected for import
are shown in the Objects to be imported pane.
You can discover and select new objects to import from the Objects
discovered by query pane.
- On the final page of the Adapter Connection - Iterative
Discovery wizard, choose from the following options.
- To add only the new objects that you discovered, select Add
XSDs for new objects and replace .wsdl, .import/.export.
When you click Finish, the following results
occur:
- XSD files for the additional objects are added to the adapter
component. These files are shown in the New files pane.
- Updated .wsdl and .import or .export files replace the files already
in the adapter component.
- The XSD files that are being added to the adapter component are
also imported into the message set that is associated with the adapter
component.
If you have discovered objects by using the SAP Wrapper or SAP
Work Unit options, the XSD files that correspond to the SAP wrapper
objects are replaced in the adapter component. These XSD files are
also imported into the message set, replacing any files that have
the same name. This behavior is because the wrapper objects contain
references to the new objects.
- To replace all existing objects with the objects that you have
discovered, select Replace the contents of .in/.outAdapter
with the newly discovered files. When you click Finish,
the following results occur:
- The contents of the .inadapter or .outadapter file in the adapter
component are replaced.
- All discovered XSD files are imported into the message set, replacing
any files that have the same name.
Note:
Select the Replace the contents
of .in/.outAdapter with the newly discovered files option
if you have changed any of the configuration options during rediscovery,
or if the interfaces or data structure of objects that you are discovering
have changed since the previous discovery.
If
you have discovered objects by using the BAPI result set option, the Add
XSDs for new objects and replace .wsdl, .import/.export option
is not available and you see the message: Incremental discovery
is not applicable for the selected option.
For
options that are used in rediscovering SAP objects, and the corresponding
restrictions, see SAP options for rediscovery.
- Click Finish.