5 Oracle Net Services Administrator's Guide BPEL Process Manager Examples

Create a BPEL Project for a BPEL Outbound Process

Do the following to create a BPEL project for outbound.

1. In JDeveloper, from the View menu, select Application Navigator.

2. In the Application Navigator, right-click the application you are working with and select New Project. The New Gallery dialog box is displayed.

3. From the Items list, select BPEL Process Project then click OK. The BPEL Project Creation Wizard-Project Settings dialog box is displayed.

   Figure 5-1 Outbound Project Settings

   
   Description of "Figure 5-1 Outbound Project Settings"
   
   

4. Do the following in BPEL Project Creation Wizard-Project Settings dialog box:

   • Enter a name for the BPEL process, for example BPELOutbound1.

   • From the Template list, select Empty BPEL Process.

5. Click Next to review the input/output schema elements or click Finish.

Create a Database Adapter to Read the Doctor Data

You create a database adapter to read the DOCTOR data. SOA exectes the SQL statment defined in the interaction and passes it to a resource adapter. The resource adapter then processes the information and returns the data. Do the following to create the database adapter.

1. Drag a PartnerLink into a service lane of the visual editor. The Create Partner Link dialog box is displayed.

   Figure 5-2 Partner Link for Database Adapter

   
   Description of "Figure 5-2 Partner Link for Database Adapter"
   
   

2. Click the Adapter Wizard button. This is the third button in the WDSL Settings section of the Create Partner Link dialog box, as shown in the figure above.

3. Enter the following information in the Adapter Configuration wizard:

   1. Step 1, Adapter Type: Select Database Adapter.

   2. Step 2, Service Name: type findDoctor

   3. Step 3, Service Connection. In this step select the data you want to work with.

      Click New to open the Create Connection wizard.

      Step 1: Select the connection type:

      Connection Name: dbConnection1

      Connection Type: Oracle (JDBC)

      Step 2: Authentication.

      Enter the User Name, Password, and Role for the connection

      Step 3: Enter the connection information.

      Enter the driver type (thin, oci), the name of the computer where JDBC is deployed, and its port number. This information should be the same as defined in the JDBC connecton facrory. See Configuring the J2CA 1.5 CICS Adapter for Outbound.

      Select Service Name and enter findDoctor.

      Click Finish to go back to the Adapter Configuration wizard.

   4. Step 4, File Directories

      Directory Names are Specified as: Select Physical Path

      Directory for Incoming Files (physical path): Enter the full path to the folder where you want the incoming files, for example C:\temp.

   5. Step 5, File Filtering:

      Includes Files with Name Pattern: Enter *xml

   6. Step 6, File Polling:

      Polling Frequency: enter 1 then select seconds from the list.

   7. Step 7, Messages:

      Schema File URL: Enter findDoctor.xsd

      Schema Element: Enter FindDoctorData

4. Click Finish.

Design a BPEL Outbound Process to Read the String

In this step, you design the BPEL process. Do the following to design the BPEL outbound process:

1. From the Component Palette-Process Activities pane, drag a Receive, Assign, and Invoke activity into the editor for the process you created in the Create a BPEL Project for a BPEL Outbound Process step.

   Figure 5-3 Outbound Process

   
   Description of "Figure 5-3 Outbound Process"
   
   

2. In the Visual Editor, connect the Recieve_1 activity to the findDoctor database adapter. The Edit Receive dialog box is displayed.

   Figure 5-4 Outbound Receive Properties

   
   Description of "Figure 5-4 Outbound Receive Properties"
   
   

3. Do the following in the Edit Receive dialog box:

   • Enter a name for the Receive activity, in this example it is Receive_1.

   • Make sure to create the variable. Click the first button to the right of the Variable field, then click OK in the Create Variable dialog box that is displayed.

   • Make sure that the Create Instance check box is selected.

   • Click OK to close the dialog box and accept the information.

Create a Partner Link to the Database Adapter

In this step, create a partner link to the database adapter you defined when you created the IMD/DB configuration in Oracle Studio. Do the following to create a partner link.

1. Drag a PartnerLink into a service lane of the visual editor. The Create Partner Link dialog box is displayed.

   Figure 5-5 Partner Link to CICS Outbound

   
   Description of "Figure 5-5 Partner Link to CICS Outbound"
   
   

2. From the Create Partner Link dialog box, click the Service Explorer button. This button is the second form the left and is shown in the figure in the previous step. The Service Explorer dialog box is displayed.

3. In the Service Explorer, expand the connection you are using, then expand adapters and then applications, and continue to browse until you find the WDSL file you are using. Select the file and click OK.

   The WSDL File field in the Create Partner Link dialog box displays the path to the WSDL file you selected. The Partner Link Type field displays the Partner Link defined in the WSDL file.

4. Enter the following information in the Create Partner Link dialog box:

   • In the Partner Role list, select FINDDOCTORRole.

   • In the My Role list, select Not Specified.

Edit the Invoke_1 Activity

Edit the Invoke_1 activity that you added to the Visual Editor so that it will invoke the FINDDOCTOR service. Do the following to edit the Invoke_1 activity.

1. Double-click the Invoke_1 activity to edit it. The Invoke dialog box is displayed.

   Figure 5-6 Invoke Dialog Box

   
   Description of "Figure 5-6 Invoke Dialog Box"
   
   

2. In the Invoke dialog box, make sure that the Partner Role Web Service Interface section has the following values:

   • Partner Link: FINDDOCTOR

   • Operation: FINDDOCTOR

3. Click the Automatically Create Input Variable button. It is the first icon to the right of the Input Variable field as shown in the figure in the previous step. The Create Variable dialog appears with the input variable.

4. The Input Variable should be Invoke_1_FINDDOCTOR_InputVariable. Click OK.

5. Click the Automatically Create Input Variable button for the Output Variable field.

6. The Output Variable should be Invoke_1_FINDDOCTOR_OutputVariable. Click OK.

Edit the Assign_1 Activity

You use the assign activity to assign a value to the resource adapter. Do the following to edit the Assign_1 activity.

1. Double-click the Assign_1 activity to edit it. The Assign dialog box is displayed.

   Figure 5-7 Assign Dialog Box

   
   Description of "Figure 5-7 Assign Dialog Box"
   
   

2. Click the Create list and select Copy Operation. The Create Copy Operation dialog box is displayed.

   Figure 5-8 Create Copy

   
   Description of "Figure 5-8 Create Copy"
   
   

3. On the From side, expand Variables then expand Read_1_SelectDoctor_InputVariable, then expand nsx:findDoctor and select Record1.

4. On the To side, expand Variables then expand Read_1_SelectDoctor_InputVariable, then expand input:findDoctor, then expand nsx:Record1 and select Record1_data.

5. Click OK. The Copy Operation tab in the Assign window updates to show the rule.

The following figure shows how the final process looks:

Figure 5-9 Final Outbound Process

Description of "Figure 5-9 Final Outbound Process"