Using Data Integrator Components as JBI Modules in Composite Applications

This topic provides instructions on using components migrated from eTL to Data Integrator as modules in a composite application. It covers the simplest case (no BPEL modules), the BPEL 2.0 case (orchestration without using the CAPS repository), and the BPEL 1.0 case (using 5.1.x business processes with a JBI bridge).

To Use the Data Integrator Web Service in a BPEL 2.0 Module

In this procedure, you will create a new composite application project, add files to it as JBI modules (WSDL, JAR, or EAR files depending on the case), and build the composite application.

Before You Begin

If necessary, start the NetBeans IDE and access the Projects window.

1. In the NetBeans main menu: File -> New Project.
2. In the New Project wizard: For Categories, choose CAPS -> ESB; for Projects, choose Composite Application; and then click Next.
3. In the New Composite Application wizard: Specify a project name and location, and then click Finish.

   The project tree displays a new composite application project, and the CASA Editor displays the newly created service assembly without any WSDL ports or JBI modules.

4. Right-click the composite application and select menu item Add JBI Module.

   

5. (Always required) In the Select Projects dialog box: Navigate to JavaCAPS6\.netbeans\caps\eTL\Imported Projects\, select the imported eTL project, and click Add Project JAR Files.

   

   The project tree displays the newly imported JAR file in the JBI Modules folder of the composite application, and the CASA Editor displays the JAR file in the JBI Modules column.

6. (Required only if there is a BPEL 2.0 module):
   1. Right-click the composite application and select menu item Add JBI Module.
   2. In the Select Projects dialog box: Select the corresponding BPEL module project and click Add Project JAR Files.
   3. Repeat as needed for additional BPEL 2.0 modules.

   The project tree displays the newly imported JAR file in the JBI Modules folder of the composite application.

7. (Required only if using a CAPS Repository-based project with a JBI bridge):
   1. Right-click the composite application and select menu item Add CAPS Module.
   2. In the Add CAPS Module dialog box: Browse to and select the corresponding deployment profile, select the appropriate application server (also called “logical host” in the CAPS Environment), and specify one of the following behaviors for importing the EAR file.

      • On add (now): To import the EAR file immediately. This presupposes that the EAR file has already been built and will not need to be regenerated.

      • On clean: To import or re-import the EAR file whenever the composite application is cleaned.

      • On build: To import or re-import the EAR file whenever the composite application is built.

   3. Click Finish.

   The project tree displays the newly imported EAR file in the JBI Modules folder of the composite application.

8. In the project tree: Right-click the composite application folder and select menu item Clean and Build.
9. In the Output window: Check for the confirming message BUILD SUCCESSFUL (total time N seconds)

   

   ---

   Tip - The very first time building a new composite application project can result in warning messages. If this occurs, simply rebuild the project.

   ---

Next Steps

After the composite application is built, you can create test cases for runtime testing.