The WebSphere Business Integration adapters use configured
resources--referred to as integration components--that are managed through the
System Manager perspective. Integration components are organized in
sets, referred to as Integration Component Libraries (ICLs). The
integration components commonly used for all adapters are connectors and
business object definitions.
To implement an adapter, you must configure the connector and designate the
business object definitions that the connector supports. You must save
both the business object definitions and the connector configurations into
Integration Component Library projects in System Manager. To do
so:
- In the System Manager perspective, right-click on the Integration
Component Libraries perspective, and choose New Integration Component
Library.
- In the New Integration Component Library dialog, provide a name for the
library in the Project name field, and choose Finish. A new
folder, with the name you have chosen, is added to the Integration Component
Libraries. The folder contains subfolders for several types of
integration components; for the purpose of implementing a connector with
WebSphere Application Server as the broker, you will require only the Business
Objects and Connectors folders.
- Select the Business Objects folder and choose File>Import. The
Import dialog displays.
- Select File System and choose Next. The Import File system dialog
displays. In the Directory drop down list, browse to a folder where you
have placed business object definition (.xsd) files that you want to
use with the connector in the interaction pattern that you have
created.
- Select the folder and choose OK. The Import dialog appears, with
check boxes next to each of the available resources. Check the box for
each .xsd file that you expect to use, and choose Finish.
- In System Manager, in the Business Objects folder under Integration
Component Libraries, right click on the Business Objects folder and refresh
the view. Icons for the imported business object definitions will
appear under the folder.
- Select the Connectors folder, then, from the Tools menu, choose Connector
Configurator. The Connector Configurator tool is activated, and the New
Connector dialog displays.
- You will use the Connector Configurator tool to set configuration
properties and specify supported business objects for your connector.
If you already have a sample or partial connector configuration file, cancel
the New Connector dialog. Then, in the Connector Configurator dialog,
choose File>Open>From file. The Open File Connector dialog
appears. Navigate to your existing sample or partial connector
configuration file, select it, and choose Open. The Connector
Configurator properties screen, named for the selected connector
configuration, displays.
- If you are creating a completely new connector configuration, select
WAS as the Integration Broker, provide a name for the new connector
configuration, select a property template (choose None if you don't
already have one), and click OK. The Connector Configurator properties
screen, named for the new connector configuration, displays.
- For any connector used with WebSphere Application Server, set
configuration values in the following tab:
- In the Standard Properties tab, set required values for the use of your
integration broker, including the queues that are used to implement the
interaction patterns. See Specifying the queues to be used by the connectorand "Configuring WebSphere MQ queues for WebSphere Application Server".
- In the Supported Business Objects tab, specify the business objects
supported for use with the connector you are implementing. See "Designating supported business objects"
- When you have completed the tabs, choose File>Save as>To
Project. The Save As dialog appears. Choose the Integration
Component Library into which you want to save this connector configuration,
enter the name you want to use for the connector, and choose Save. The
Connector Configurator validates your connector configuration and displays a
message for either success or failure. If you have no more changes to
make to the configuration properties of this connector, close the Connector
Configurator.
- In the System Manager perspective, under the Integration Component Library
project that you created, an icon for your connector configuration is now
displayed under the Connectors folder.
- Your connector is now configured as part of an Integration Components
Library, with the properties and supported business objects that you
specified. If you need to make a change in the configuration, you can
do so by double-clicking this specific connector icon to open its
configuration file in Connector Configurator. Note that if you wish to
add additional supported business objects to the configuration for this
connector, you must first save the business objects into the same Integration
Component Library in which this connector resides. Then you can open
Connector Configurator, select the Supported Business Objects tab, and click
in the Business Object Name drop down box to see the additional available
business objects.
