IBM Integration Bus, Version 9.0.0.8 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

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.

  1. From the Application Development view, expand the appropriate message set project folders until you see the .inadapter or .outadapter component.
  2. 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.

  3. 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.
  4. 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.

  5. Click Finish.

bc22210_.htm | Last updated Friday, 21 July 2017