5 Integration With BPEL Service Components in the Oracle SOA Suite

Generating WSDL for Request/Response Service

Perform the following steps to generate a WSDL for request/response service:

1. Start Application Explorer and connect to a defined MySAP target (a J2CA configuration).

   For more information on defining a target and connecting to SAP R/3, see "Defining a Target to SAP R/3".

2. Expand the MySAP target to which you are connected.

3. Expand Remote Function Modules, Financial Accounting, 0002 -- Company Code Business Object, and then select BAPI_COMPANYCODE_GETDETAIL, as shown in Figure 5-10.

   Figure 5-10 Connected MySAP_Target

   
   Description of "Figure 5-10 Connected MySAP_Target"
   
   

4. Right-click the BAPI_COMPANYCODE_GETDETAIL node.

   A menu is displayed, as shown in Figure 5-11.

   Figure 5-11 BAPI_COMPANYCODE_GETDETAIL Node

   
   Description of "Figure 5-11 BAPI_COMPANYCODE_GETDETAIL Node"
   
   

5. Click Create Outbound JCA Service (Request/Response).

   The Export WSDL dialog is displayed, as shown in Figure 5-12.

   Figure 5-12 Export WSDL Dialog

   
   Description of "Figure 5-12 Export WSDL Dialog"
   
   

6. Click OK.

You can now create an empty composite for SOA, which is the first step that is required to define a BPEL outbound process in JDeveloper.

Creating an Empty Composite for SOA

Perform the following steps to create an empty composite for SOA:

1. Create a new SOA application.

2. Enter a name for the new SOA Application and click Next, as shown in Figure 5-13.

   Figure 5-13 Name Your Application Page

   
   Description of "Figure 5-13 Name Your Application Page"
   
   

   The Name your project page is displayed, as shown in Figure 5-14.

   Figure 5-14 Name Your Project Page

   
   Description of "Figure 5-14 Name Your Project Page"
   
   

3. Enter a project name (for example, CompanyCode_GD) and click Next.

   The Configure SOA settings page is displayed, as shown in Figure 5-15.

   Figure 5-15 Configure SOA Settings Page

   
   Description of "Figure 5-15 Configure SOA Settings Page"
   
   

4. From the Composite Template list, select Empty Composite and click Finish.

Defining a BPEL Outbound Process

This section describes how to define a BPEL outbound process, which consists of the following stages:

1. Configuring a Third Party Adapter Service Component

2. Configuring an Outbound BPEL Process Component

Configuring a Third Party Adapter Service Component

Perform the following steps to create a third party adapter service component:

1. Drag and drop the Third Party Adapter component from the Service Adapters pane to the External References pane, as shown in Figure 5-16.

   Figure 5-16 Third Party Adapter Component

   
   Description of "Figure 5-16 Third Party Adapter Component "
   
   

   The Create Third Party Adapter Service dialog is displayed, as shown in Figure 5-17.

   Figure 5-17 Create Third Party Adapter Service Dialog

   
   Description of "Figure 5-17 Create Third Party Adapter Service Dialog"
   
   

2. Enter a name for the third party adapter service.

3. Ensure that Reference is selected from the Type list (default).

4. Click the Find existing WSDLs icon, which is located to the right of the WSDL URL field.

   The SOA Resource Browser dialog is displayed, as shown in Figure 5-18.

   Figure 5-18 SOA Resource Browser Dialog

   
   Description of "Figure 5-18 SOA Resource Browser Dialog"
   
   

5. Browse and select an outbound WSDL file from the following directory:

   <ADAPTER_HOME>\soa\thirdparty\ApplicationAdapters\wsdls
   

6. Click OK.

   The Localize Files dialog is displayed, as shown in Figure 5-19.

   Figure 5-19 Localize Files Dialog

   
   Description of "Figure 5-19 Localize Files Dialog"
   
   

7. Click OK.

   The outbound WSDL file and associated request and response XML schema files (.xsd) are imported to the project folder that has been created.

   You are returned to the Create Third Party Adapter Service dialog, as shown in Figure 5-20.

   Figure 5-20 Create Third Party Adapter Service Dialog

   
   Description of "Figure 5-20 Create Third Party Adapter Service Dialog"
   
   

8. Click the Find JCA file icon, which is located to the right of the JCA File field.

   The SOA Resource Browser dialog is displayed, as shown in Figure 5-21.

   Figure 5-21 SOA Resource Browser Dialog

   
   Description of "Figure 5-21 SOA Resource Browser Dialog"
   
   

9. Browse and select the JCA properties file from the following directory:

   <ADAPTER_HOME>\soa\thirdparty\ApplicationAdapters\wsdls
   

10. Click OK.

    The following message is displayed.

    
    Description of the illustration bpel_out_adapt7.gif
    
    

11. Click Yes.

    A copy of the JCA properties file is made in the project folder.

    You are returned to the Create Third Party Adapter Service dialog, as shown in Figure 5-22.

    Figure 5-22 Create Third Party Adapter Service Dialog

    
    Description of "Figure 5-22 Create Third Party Adapter Service Dialog"
    
    

12. Click OK.

    The third party adapter service component (GetDetail) is created and displayed in the External References pane, as shown in Figure 5-23.

    Figure 5-23 Third Party Adapter Service Component

    
    Description of "Figure 5-23 Third Party Adapter Service Component"
    
    

    You are now ready to configure an outbound BPEL process component.

Configuring an Outbound BPEL Process Component

Perform the following steps to configure an outbound BPEL process component:

1. Drag and drop the BPEL Process component from the Service Components pane to the Components pane, as shown in Figure 5-24.

   Figure 5-24 BPEL Process Component

   
   Description of "Figure 5-24 BPEL Process Component"
   
   

   The Create BPEL Process dialog is displayed, as shown in Figure 5-25.

   Figure 5-25 Create BPEL Process Dialog

   
   Description of "Figure 5-25 Create BPEL Process Dialog"
   
   

2. In the Name field, enter a name to identify the new outbound BPEL process component (for example, cc_getdetail).

3. From the Template list, select Synchronous BPEL Process.

4. Click the Browse icon, which is located to the right of the Input field to select the associated XML request schema file.

   The Type Chooser dialog is displayed, as shown in Figure 5-26.

   Figure 5-26 Type Chooser Dialog

   
   Description of "Figure 5-26 Type Chooser Dialog"
   
   

5. Expand Project Schema Files, GetDetail_invoke_request.xsd, and select CompanyCode.GetDetail.

6. Click OK.

   You are returned to the Create BPEL Process dialog, as shown in Figure 5-27.

   Figure 5-27 Create BPEL Process Dialog

   
   Description of "Figure 5-27 Create BPEL Process Dialog"
   
   

7. Click the Browse icon, which is located to the right of the Output field to select the associated XML response schema file.

   The Type Chooser dialog is displayed, as shown in Figure 5-28.

   Figure 5-28 Type Chooser Dialog

   
   Description of "Figure 5-28 Type Chooser Dialog"
   
   

8. Expand Project Schema Files, GetDetail_invoke_response.xsd, and select CompanyCode.GetDetailResponse.

9. Click OK.

   You are returned to the Create BPEL Process dialog, as shown in Figure 5-29.

   Figure 5-29 Create BPEL Process Dialog

   
   Description of "Figure 5-29 Create BPEL Process Dialog"
   
   

10. Click OK.

11. Create a connection between the outbound BPEL process component (cc_ getdetail) and the third party adapter service component (GetDetail), as shown in Figure 5-30.

    Figure 5-30 Created Connection

    
    Description of "Figure 5-30 Created Connection"
    
    

12. Double-click the outbound BPEL process component (cc_ getdetail) in the Components pane, as shown in Figure 5-31.

    Figure 5-31 Outbound BPEL Process Component

    
    Description of "Figure 5-31 Outbound BPEL Process Component"
    
    

13. Drag and drop the Invoke activity component to the Components pane and place it between the receiveInput activity component and the replyOutput activity component, as shown in Figure 5-32.

    Figure 5-32 Invoke Activity Component

    
    Description of "Figure 5-32 Invoke Activity Component"
    
    

14. Create a connection between the new Invoke activity component (Invoke_1) and the third party adapter service component (GetDetail), as shown in Figure 5-33.

    Figure 5-33 Created Connection

    
    Description of "Figure 5-33 Created Connection"
    
    

15. Double-click the new Invoke activity component (Invoke_1).

    The Edit Invoke dialog is displayed, as shown in Figure 5-34.

    Figure 5-34 Edit Invoke Dialog

    
    Description of "Figure 5-34 Edit Invoke Dialog"
    
    

16. Click the Plus sign icon, which is located to the right of the Input field to configure a new input variable.

    The Create Variable dialog is displayed, as shown in Figure 5-35.

    Figure 5-35 Create Variable Dialog

    
    Description of "Figure 5-35 Create Variable Dialog"
    
    

17. Accept the default values that are provided for the new input variable and click OK.

    You are returned to the Edit Invoke dialog, as shown in Figure 5-36.

    Figure 5-36 Edit Invoke Dialog

    
    Description of "Figure 5-36 Edit Invoke Dialog"
    
    

18. Click the Plus sign icon, which is located to the right of the Output field to configure a new output variable.

    The Create Variable dialog is displayed, as shown in Figure 5-37.

    Figure 5-37 Create Variable Dialog

    
    Description of "Figure 5-37 Create Variable Dialog"
    
    

19. Accept the default values that are provided for the new output variable and click OK.

    You are returned to the Edit Invoke dialog, as shown in Figure 5-38.

    Figure 5-38 Edit Invoke Dialog

    
    Description of "Figure 5-38 Edit Invoke Dialog"
    
    

20. Click Apply and then OK.

21. Drag and drop the Assign activity component to the Components pane and place it between the Receive activity component (receiveInput) and the Invoke activity component (Invoke_1), as shown in Figure 5-39.

    Figure 5-39 Assign Activity Component

    
    Description of "Figure 5-39 Assign Activity Component"
    
    

22. Double-click the new Assign activity component (Assign_1), as shown in Figure 5-40.

    Figure 5-40 Assign Activity Component

    
    Description of "Figure 5-40 Assign Activity Component"
    
    

    The Assign dialog is displayed, as shown in Figure 5-41.

    Figure 5-41 Assign Dialog

    
    Description of "Figure 5-41 Assign Dialog"
    
    

23. Click the Copy Operation tab.

24. Click the Plus sign icon and select Copy Operation from the list of available operations.

    The Create Copy Operation dialog is displayed, as shown in Figure 5-42.

    Figure 5-42 Create Copy Operation Dialog

    
    Description of "Figure 5-42 Create Copy Operation Dialog"
    
    

25. In the From pane, expand Variables, InputVariable, and then select payload.

26. In the To pane, expand Variables, Invoke_1_GetDetail_InputVariable, and then select input_GetDetail.

27. Click OK.

    You are returned to the Assign dialog, as shown in Figure 5-43.

    Figure 5-43 Assign Dialog

    
    Description of "Figure 5-43 Assign Dialog"
    
    

28. Click Apply and then OK.

29. Drag and drop the Assign activity component to the Components pane and place it between the Invoke activity (Invoke_1) and the Reply activity (replyOutput), as shown in Figure 5-44.

    Figure 5-44 Assign Activity Component

    
    Description of "Figure 5-44 Assign Activity Component"
    
    

30. Double-click the new Assign activity component (Assign_2), as shown in Figure 5-45.

    Figure 5-45 New Assign Activity Component

    
    Description of "Figure 5-45 New Assign Activity Component"
    
    

    The Assign dialog is displayed, as shown in Figure 5-46.

    Figure 5-46 Assign Dialog

    
    Description of "Figure 5-46 Assign Dialog"
    
    

31. Click the Copy Operation tab.

32. Click the Plus sign icon and select Copy Operation from the list of available operations.

    The Create Copy Operation dialog is displayed, as shown in Figure 5-47.

    Figure 5-47 Create Copy Operation Dialog

    
    Description of "Figure 5-47 Create Copy Operation Dialog"
    
    

33. In the From pane, expand Variables, Invoke_1_GetDetail_OutputVariable, and then select output_GetDetail.

34. In the To pane, expand Variables, outputVariable, and then select payload.

35. Click OK.

    You are returned to the Assign dialog, as shown in Figure 5-48.

    Figure 5-48 Assign Dialog

    
    Description of "Figure 5-48 Assign Dialog"
    
    

36. Click Apply and then OK.

    Figure 5-49 Composite.xml File

    
    Description of "Figure 5-49 Composite.xml File"
    
    

37. Double-click composite.xml in the left pane, as shown in Figure 5-49.

    Figure 5-50 Save All Icon

    
    Description of "Figure 5-50 Save All Icon"
    
    

38. Click the Save All icon in the menu bar to save the new outbound BPEL process component that was configured, as shown in Figure 5-50.

    You are now ready to deploy the BPEL outbound process.

Deploying the BPEL Outbound Process

Perform the following steps to deploy the BPEL outbound process.

1. Right-click the project name in the left pane (for example, CompanyCode_GD), select Deploy, and then click CompanyCode_GD, as shown in Figure 5-51.

   Figure 5-51 CompanyCode_GD Option

   
   Description of "Figure 5-51 CompanyCode_GD Option"
   
   

   The Deployment Action page is displayed, as shown in Figure 5-52.

   Figure 5-52 Deployment Action Page

   
   Description of "Figure 5-52 Deployment Action Page"
   
   

2. Ensure that Deploy to Application Server is selected.

3. Click Next.

   The Deploy Configuration page is displayed, as shown in Figure 5-53.

   Figure 5-53 Deploy Configurations Page

   
   Description of "Figure 5-53 Deploy Configurations Page"
   
   

4. Leave the default values selected and click Next.

   The Select Server page is displayed, as shown in Figure 5-54.

   Figure 5-54 Select Server Page

   
   Description of "Figure 5-54 Select Server Page"
   
   

5. Select an available application server that was configured and click Next.

   The SOA Servers page is displayed, as shown in Figure 5-55.

   Figure 5-55 SOA Servers Page

   
   Description of "Figure 5-55 SOA Servers Page"
   
   

6. Select a target SOA server and click Next.

   The Summary page is displayed, as shown in Figure 5-56.

   Figure 5-56 Summary Page

   
   Description of "Figure 5-56 Summary Page"
   
   

7. Review and verify all the available deployment information for your project and click Finish.

   The process is deployed successfully, as shown in Figure 5-57.

   Figure 5-57 Successful Deployment Message

   
   Description of "Figure 5-57 Successful Deployment Message"
   
   

Invoking the Input XML Document in the Oracle Enterprise Manager Console

Perform the following steps to invoke the input XML document in the Oracle Enterprise Manager console.

1. Logon to the Oracle Enterprise Manager console.

   
   Description of the illustration bpel_out_invoke1.gif
   
   

2. Expand your domain in the left pane followed by the SOA folder.

3. Select an available project (for example, CompanyCode_GD).

   Figure 5-58 Test Button

   
   Description of "Figure 5-58 Test Button"
   
   

4. Click Test, as shown in Figure 5-58.

   Figure 5-59 Request Tab

   
   Description of "Figure 5-59 Request Tab"
   
   

5. Click the Request tab, as shown in Figure 5-59.

6. Provide an appropriate input value in the Value field and click Test Web Service.

   The output response is received in the Oracle Enterprise Manager console, as shown in Figure 5-60.

   Figure 5-60 Output Response

   
   Description of "Figure 5-60 Output Response"
   
   

   Perform the following steps to invoke the input XML document using XML View:

   1. Select XML View from the list, as shown in Figure 5-61.

      Figure 5-61 Input Arguments List

      
      Description of "Figure 5-61 Input Arguments List"
      
      

   2. Provide an appropriate input XML document in the Input Arguments area and click Test Web Service.

      The output response is received in the Oracle Enterprise Manager console, as shown in Figure 5-62.

      Figure 5-62 Received Output Response

      
      Description of "Figure 5-62 Received Output Response"
      
      

Testing Outbound BPEL and Mediator Processes

When testing an outbound BPEL process or an outbound Mediator process from the Oracle Enterprise Manager console, do not use the XML envelopes that are generated by these consoles. Instead, remove them and use the XML payloads that are generated from the schemas, which conform to the WSDLs for namespace qualifications.

The Mediator data flows can be tested using the Enterprise Manager console. When creating a Mediator data flow and interactions, the Web services are created and registered with the Oracle Application Server. For more information on creating a Mediator outbound process, see Chapter 6, "Integration With Mediator Service Components in the Oracle SOA Suite".

Generating WSDL for Event Integration

You must create a separate channel for every inbound J2CA service and select that channel when you generate WSDL for inbound interaction using Application Explorer.

Creating a Channel

To create a channel:

1. Start Application Explorer and connect to a J2CA configuration.

2. In the left pane, expand the Events node.

3. Expand the MySAP node.

   The Ports and Channels nodes appear in the left pane, as shown in Figure 5-63.

   Figure 5-63 MySAP Channel Node

   
   Description of "Figure 5-63 MySAP Channel Node"
   
   

4. Right-click Channels and select Add Channel.

   The Add Channel dialog is displayed, as shown in Figure 5-64.

   Figure 5-64 Add Channel Dialog

   
   Description of "Figure 5-64 Add Channel Dialog"
   
   

   Perform the following steps:

   1. Enter a name for the channel, for example, SAP_Channel.

   2. Enter a brief description (optional).

   3. From the Protocol list, select Application Server - mySAP.

5. Click Next.

   The Application Server dialog is displayed, as shown in Figure 5-65. The following tabs are available:

   • User (Required)

   • System (Required)

   • Security

   • Advanced

   Figure 5-65 Application Server Dialog

   
   Description of "Figure 5-65 Application Server Dialog"
   
   

6. For the User tab, enter the appropriate information for your SAP R/3 channel based on the information in the following table.

   Table 5-1 User Tab Parameters

   Target Parameter	Description
   Client	The client number defined for the SAP R/3 application for client communications.
   User	A valid user ID for the SAP R/3 application.
   Password	A valid password for the SAP R/3 application.
   Authentication Mode	The authentication mode you want to use when connecting to your SAP R/3 system. By default, Password is selected from the list.

   
   

7. Click the System tab, as shown in Figure 5-66.

   Figure 5-66 System Tab

   
   Description of "Figure 5-66 System Tab"
   
   

8. For the System tab, enter the appropriate information for your SAP R/3 channel based on the information in the following table.

   Table 5-2 System Tab Parameters

   Target Parameter	Description
   Gateway host	A host name for the SAP R/3 Gateway.
   Gateway service	A service for the SAP R/3 Gateway.
   Program ID of the server	An SAP R/3 program ID you want to use for this channel.
   Application Server	The name of the SAP R/3 application server you are using.
   System Number	An SAP R/3 system number.

   
   

9. For the Security tab (optional), enter the appropriate information for your SAP R/3 channel based on the information in the following table.

   Table 5-3 Security Tab Parameters

   Target Parameter	Description
   SNC mode	By default, SNC is disabled. To enable SNC, select 1 from the list.
   SNC partner	Enter the name of the RFC server or message server (load balancing) that provides the SNC services.
   SNC level	From the list select the version of the SNC library.
   SNC name	Enter the name of the SNC library you are using.
   SNC library path	Enter the path to the SNC library.

   
   

10. For the Advanced tab (optional), enter the appropriate information for your SAP R/3 channel based on the information in the following table.

    Table 5-4 Advanced Tab Parameters

    Target Parameter	Description
    IDOC Format	Select an IDOC type from the list: XML (default) XML-CDATA-ENVELOPED NATIVE IDOC
    IDOC release	The IDOC versioning you want to use for your connection.
    IDOC release provider	The IDOC release provider for your connection. Select IDOC DOCREL field (default), SAP release, or user input from the list.
    SAP trace	Select this option to enable SAP traces. The SAP traces are stored in the following locations during design time and run time: Design Time: <ADAPTER_HOME>\soa\thirdparty\ApplicationAdapters\tools\iwae\bin Run Time: <ADAPTER_HOME>\user_projects\domains\base_domain The file name formats that are used for the SAP traces are as follows (for design time and run time): rfc02664_04332.trc JCO100226_043846994.trc
    Processing Mode	Select the type of synchronous processing from the list. Possible values include REQUEST and REQUEST_RESPONSE.

    
    

11. Click OK.

    The channel appears under the channels node in the left pane. An X over the icon indicates that the channel is currently disconnected.

    Note:

    Do not start the channel, as it is managed by BPEL PM Server. If you start the channel for testing and debugging purposes, then stop it before run-time.

Generating WSDL for Event Notification

After you create a channel and verify that it is not started, you must generate WSDL for the event using Application Explorer.

1. Start Application Explorer.

2. Expand the Adapters node.

   A list of all adapters is displayed, as shown in Figure 5-67.

   Figure 5-67 Adapters Node

   
   Description of "Figure 5-67 Adapters Node"
   
   

   Perform the following steps:

   1. Expand the MySAP node.

      A list of your available targets is displayed, as shown in Figure 5-68.

      Figure 5-68 Disconnected MySAP Target Node

      
      Description of "Figure 5-68 Disconnected MySAP Target Node"
      
      

   2. Click a target name under the MySAP node, for example, SAPTarget..

      The Connection dialog displays the saved parameters.

3. Verify your connection parameters.

4. Right-click the target name and select Connect.

   The x icon disappears, indicating that the node is connected, as shown in Figure 5-69.

   Figure 5-69 Connected MySAP Target

   
   Description of "Figure 5-69 Connected MySAP Target"
   
   

5. Expand the IDOCs node and select DEBMAS.

   The DEBMAS list is displayed, as shown in Figure 5-70.

   Figure 5-70 DEBMAS Customer Master Data Distribution List

   
   Description of "Figure 5-70 DEBMAS Customer Master Data Distribution List"
   
   

6. Right-click DEBMAS05 from the DEBMAS list.

   Figure 5-71 Create Inbound JCA Service (Event) Option

   
   Description of "Figure 5-71 Create Inbound JCA Service (Event) Option"
   
   

7. Select Create Inbound JCA Service (Event), as shown in Figure 5-71.

   The Export WSDL dialog is displayed, as shown in Figure 5-72.

   Figure 5-72 Export WSDL Catalog

   
   Description of "Figure 5-72 Export WSDL Catalog"
   
   

   Perform the following steps:

   1. In the Name field, specify a name for the WSDL file.

   2. From the Channel list, select the channel you created for this inbound service.

      Important: You must create a separate channel for every event. Verify that the channel is stopped before run-time.

   3. Three check boxes for Root, Namespace, and Schema validation are also available. Selection of multiple validation options is allowed.

      - Root validation is used to validate the root element in the inbound XML document.

      - Namespace validation is used to validate the namespace in the inbound XML document.

      - Schema validation is used to validate the inbound XML document with the schema in the WSDL document.

      During run time, validation is processed based on the validation options that are selected. If multiple validation options are selected, then during run time if the first validation option fails, the remaining validation options are not processed. Root and namespace validations are considered modest levels of validation. Schema validation is a stricter validation level. It is recommended to use root and namespace validation options, unless the root element and namespace are different between the IDOCs in the SAP environment.

8. Click OK.

   You can now create an empty composite for SOA, which is the first step that is required to define a BPEL inbound process in JDeveloper.

Creating an Empty Composite for SOA

Perform the following steps to create an empty composite for SOA:

1. Create a new SOA application.

2. Enter a name for the new SOA Application and click Next, as shown in Figure 5-73.

   Figure 5-73 Name Your Application Page

   
   Description of "Figure 5-73 Name Your Application Page"
   
   

   The Name your project page is displayed.

   Figure 5-74 Name Your Project Page

   
   Description of "Figure 5-74 Name Your Project Page"
   
   

3. Enter a project name (for example, matmas01) and click Next.

   The Configure SOA settings page is displayed, as shown in Figure 5-75.

   Figure 5-75 Configure SOA Settings Page

   
   Description of "Figure 5-75 Configure SOA Settings Page"
   
   

4. From the Composite Template list, select Empty Composite and click Finish.

Defining a BPEL Inbound Process

This section describes how to define a BPEL inbound process, which consists of the following stages:

1. Configuring a Third Party Adapter Service Component

2. Configuring an Inbound BPEL Process Component

Creating a Third Party Adapter Service Component

Perform the following steps to create a third party adapter service component:

1. Drag and drop the Third Party Adapter component from the Service Adapters pane to the Exposed Services pane, as shown in Figure 5-76.

   Figure 5-76 Third Party Adapter Component

   
   Description of "Figure 5-76 Third Party Adapter Component"
   
   

   The Create Third Party Adapter Service dialog is displayed, as shown in Figure 5-77.

   Figure 5-77 Create Third Party Adapter Service Dialog

   
   Description of "Figure 5-77 Create Third Party Adapter Service Dialog"
   
   

2. Enter a name for the third party adapter service.

3. Ensure that Service is selected from the Type list (default).

4. Click the Find existing WSDLs icon, which is located to the right of the WSDL URL field.

   The SOA Resource Browser dialog is displayed, as shown in Figure 5-78.

   Figure 5-78 SOA Resource Browser Dialog

   
   Description of "Figure 5-78 SOA Resource Browser Dialog"
   
   

5. Browse and select an inbound WSDL file from the following directory:

   <ADAPTER_HOME>\soa\thirdparty\ApplicationAdapters\wsdls
   

6. Click OK.

   The Localize Files dialog is displayed, as shown in Figure 5-79.

   Figure 5-79 Localize Files Dialog

   
   Description of "Figure 5-79 Localize Files Dialog"
   
   

7. Click OK.

   The inbound WSDL file and associated receive/request XML schema file (.xsd) are imported to the project folder that has been created.

   You are returned to the Create Third Party Adapter Service dialog, as shown in Figure 5-80.

   Figure 5-80 Create Third Party Adapter Service Dialog

   
   Description of "Figure 5-80 Create Third Party Adapter Service Dialog"
   
   

8. Click the Find JCA file icon, which is located to the right of the JCA File field.

   The SOA Resource Browser dialog is displayed, as shown in Figure 5-81.

   Figure 5-81 SOA Resource Browser Dialog

   
   Description of "Figure 5-81 SOA Resource Browser Dialog"
   
   

9. Browse and select the JCA properties file from the following directory:

   <ADAPTER_HOME>\soa\thirdparty\ApplicationAdapters\wsdls
   

10. Click OK.

    A Copy File message is displayed, as shown in Figure 5-82.

    Figure 5-82 Copy File Confirmation Message

    
    Description of "Figure 5-82 Copy File Confirmation Message"
    
    

11. Click Yes.

    A copy of the JCA properties file is made in the project folder.

    You are returned to the Create Third Party Adapter Service dialog, as shown in Figure 5-83.

    Figure 5-83 Create Third Party Adapter Service Dialog

    
    Description of "Figure 5-83 Create Third Party Adapter Service Dialog"
    
    

12. Click OK.

    The third party adapter service component (matmas) is created and displayed in the Exposed Services pane, as shown in Figure 5-84.

    Figure 5-84 Third Party Adapter Service Component

    
    Description of "Figure 5-84 Third Party Adapter Service Component"
    
    

    You are now ready to configure an inbound BPEL process component.

Creating an Inbound BPEL Process Component

Perform the following steps to create an inbound BPEL process component:

1. Drag and drop the BPEL Process component from the Service Components pane to the Components pane, as shown in Figure 5-85.

   Figure 5-85 BPEL Process Component

   
   Description of "Figure 5-85 BPEL Process Component"
   
   

   The Create BPEL Process dialog is displayed, as shown in Figure 5-86.

   Figure 5-86 Create BPEL Process Dialog

   
   Description of "Figure 5-86 Create BPEL Process Dialog"
   
   

2. In the Name field, enter a name to identify the new inbound BPEL process component (for example, matmas_inbound).

3. From the Template list, select Base on a WSDL.

4. Uncheck the Expose as SOAP service check box.

5. Click the Find existing WSDLs icon, which is located to the right of the WSDL URL field.

   The SOA Resource Browser dialog is displayed, as shown in Figure 5-87.

   Figure 5-87 SOA Resource Browser Dialog

   
   Description of "Figure 5-87 SOA Resource Browser Dialog"
   
   

6. Browse and select an inbound WSDL file from the project folder.

   For example:

   C:\JDeveloper\mywork\MySAP_sep23\matmas01\MATMAS01_receive.wsdl
   

7. Click OK.

   You are returned to the Create BPEL Process dialog, as shown in Figure 5-88.

   Figure 5-88 Create BPEL Process Dialog

   
   Description of "Figure 5-88 Create BPEL Process Dialog"
   
   

8. Click OK.

   Figure 5-89 Created Connection

   
   Description of "Figure 5-89 Created Connection"
   
   

9. Create a connection between the third party adapter service component (matmas) and the inbound BPEL process component (matmas_inbound), as shown in Figure 5-89.

10. Double-click composite.xml in the left pane.

    Figure 5-90 Save All Icon

    
    Description of "Figure 5-90 Save All Icon"
    
    

11. Click the Save All icon in the menu bar to save the new inbound BPEL process component that was configured, as shown in Figure 5-90.

    You are now ready to deploy the BPEL inbound process.

Deploying the BPEL Inbound Process

Perform the following steps to deploy the BPEL inbound process.

1. Right-click the project name in the left pane (for example, matmas01), select Deploy, and click matmas01, as shown in Figure 5-91.

   Figure 5-91 Matmas01 Option

   
   Description of "Figure 5-91 Matmas01 Option"
   
   

   The Deployment Action page is displayed, as shown in Figure 5-92.

   Figure 5-92 Deployment Action Page

   
   Description of "Figure 5-92 Deployment Action Page"
   
   

2. Ensure that Deploy to Application Server is selected.

3. Click Next.

   The Deploy Configuration page is displayed, as shown in Figure 5-93.

   Figure 5-93 Deploy Configuration Page

   
   Description of "Figure 5-93 Deploy Configuration Page"
   
   

4. Leave the default values selected and click Next.

   The Select Server page is displayed, as shown in Figure 5-94.

   Figure 5-94 Select Server Page

   
   Description of "Figure 5-94 Select Server Page"
   
   

5. Select an available application server that was configured and click Next.

   The SOA Servers page is displayed, as shown in Figure 5-95.

   Figure 5-95 SOA Servers Page

   
   Description of "Figure 5-95 SOA Servers Page"
   
   

6. Select a target SOA server and click Next.

   The Summary page is displayed, as shown in Figure 5-96.

   Figure 5-96 Summary Page

   
   Description of "Figure 5-96 Summary Page"
   
   

7. Review and verify all the available deployment information for your project and click Finish.

   The process is deployed successfully, as shown in Figure 5-97.

   Figure 5-97 Successful Deployment Message

   
   Description of "Figure 5-97 Successful Deployment Message"
   
   

   Once event messages are triggered through SAP GUI, successful instances are received in the Oracle Enterprise Manager console, as shown in Figure 5-98.

   Figure 5-98 Received Instances

   
   Description of "Figure 5-98 Received Instances"
   
   

Triggering an Event in SAP R/3

Events are generated by activity in an application system. For example, SAP R/3 may generate an event as customer information is updated in the system. For more information on events, see "Configuring an Event Adapter".

The following topics describe how to trigger an event in SAP R/3 and verify event integration using Oracle Application Adapter for SAP R/3.

To trigger an event in SAP R/3:

1. Start the SAP Workbench and log in to the SAP R/3 system, as shown in Figure 5-99.

   Figure 5-99 SAP Workbench

   
   Description of "Figure 5-99 SAP Workbench"
   
   

2. Run the bd12 transaction.

   Figure 5-100 Send Customers Window

   
   Description of "Figure 5-100 Send Customers Window"
   
   

   Enter the following information in the Send Customers window:

   1. In the Customer field, enter a customer number with a range from 1 to 3, as shown in Figure 5-100.

   2. In the Output type field, enter DEBMAS.

   3. In the Logical system field, specify the logical system you are using with SAP R/3.

3. Click the check mark icon in the upper left-hand corner, as shown in Figure 5-101.

   Figure 5-101 Restrictions Page

   
   Description of "Figure 5-101 Restrictions Page"
   
   

4. Ensure DEBMAS appears in the Message type column.

5. Click the Execute button.

   Customer master data is sent to the logical system specified. If a channel in Application Explorer defined the Program ID with the same value, then the channel receives this customer master data from SAP R/3.

Verifying the Results

To verify your results:

1. Logon to the Oracle Enterprise Manager console by using the following URL:

   http://localhost:7001/em
   

2. Expand your domain in the left pane followed by the SOA folder.

3. Select an available inbound BPEL process (for example, matmas01), as shown in Figure 5-102.

   Figure 5-102 Available Inbound BPEL Process

   
   Description of "Figure 5-102 Available Inbound BPEL Process"
   
   

4. Click the Instances tab.

   Recently received run-time event messages are displayed in the Instances tab, as shown in Figure 5-103.

   Figure 5-103 Instances Tab

   
   Description of "Figure 5-103 Instances Tab"
   
   

5. Click the Instance ID to view the received event message.