Creating a business integration module

Create a business integration module and configure service descriptions using the enterprise service discovery wizard.

Why and when to perform this task

You complete the configuration process using the enterprise service discovery wizard in WebSphere® Integration Developer. As you perform the following steps, you enter all the information necessary to configure the adapter for the first time. The output from the enterprise service discovery wizard is saved to a business integration module, which contains the business objects, the import file (which describes outbound processing, as defined by the Managed Connection Factory and Interaction Specification), the export file (which describes inbound event processing, as defined by the Activation Specification), and the Web Services Description Language (WSDL) file.
Note: During deployment, if you specify J2C activation specification properties when you initially configure the service, those property settings will remain in place (in other words, you cannot update the properties later, after you install the application, through the WebSphere Process Server administrative console). If, for any reason, you want to set the J2C activation specification properties after installing the application via the administrative console, then you should refrain from setting them during deployment. Note that J2C connection factory properties can be set during deployment and then updated via the administrative console after you install the application.

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 an option under New, expand Others > Business Integration to locate it.
  3. When prompted to select a resource adapter, select IBM WebSphere Adapter for PeopleSoft Enterprise and then click Next.
  4. Specify connection configuration properties on the Configure Settings for Discovery Agent window. For a full list and descriptions of these properties, see "Connection properties" under "References" in this documentation. Properties marked with an asterisk are mandatory. When finished, click Next.
    This screen capture is described in surrounding text.
  5. In the Find and Discover Enterprise Serviceswindow, click Run Query.


    This screen capture is described in surrounding text.

    The business objects at the server are returned and placed in the Objects discovered by query pane. Importing and selecting these objects determines the artifacts that will be represented in the component. Select the objects you want and click Add to build the collection of objects.
  6. If you selected the Configure Additional BO Properties check box on the Configure Settings for Discovery Agent window, the Configuration Parameters window appears, where you can do the following:


    This screen capture is described in surrounding text.

    1. In the Logical Delete field, select one attribute from the interface component to identify it as a SoftDelete key. All attributes of the interface component are available except child collection attributes.
    2. In the Logical Delete Value field, select a value for the attribute you have identified for use as a SoftDelete key. The choice you make here is used to update records in the component when a delete operation is performed. For example, if you selected status in the logical delete field, and then you select closed in the logical delete value field, records in the component will have their status value updated to closed when the adapter performs a delete operation.
    3. In the Find Keys field, select attributes from the interface component to use as FindKeys. All attributes of the interface component are available except child collection attributes. You can select multiple attributes.
  7. In the Configure Objects window, specify properties for the objects that will be imported by the discovery agent. Mandatory properties are marked with an asterisk.


    This screen capture is described in surrounding text.

    If you specify an Outbound Service Type, an outbound service description will be generated. If you specify an Inbound Service Type, an outbound service description will be generated. The Service Functions you select determine the operations on the EIS server your component will invoke.

  8. In the Generate Artifacts window, specify values for properties for the project that will be added to the workspace. Mandatory Resource Adapter, Managed Connection factory, and Activation specification properties are marked with an asterisk. Make sure to select Use discovered connection properties , and the enter a value for the J2C Authentication Data Entry field. See Creating an authentication alias. Click New to create a new business integration module.
    This screen capture is described in surrounding text.
  9. In the window that opens, specify the module name where the SCA artifacts (business objects, their properties, import file, export file, and WSDL) will be saved.


    This screen capture is described in surrounding text.

  10. Click Finish.
Related reference
Connection properties

Terms of use |

Last updated: Sun Mar 12 11:24:20 2006

(c) Copyright IBM Corporation 2005.
This information center is powered by Eclipse technology (http://www.eclipse.org)