4 Connecting to Composites

Transcription

1 4 Connecting to Composites 4 Connecting to Composites Prerequisites Introduction OSB to SOA Suite Direct binding What is being done? Create Direct Binding exposed service in POProcessing Composite Create soa-direct Business Service in Oracle Service Bus Update receivepo_db Proxy Service Message Flow Test Test SOA Suite to OSB Direct Binding What is being done? Create SB transport protocol Proxy Service in OSB Create Direct Binding reference in POProcessing Composite Update approvelargeorder BPEL to selectively invoke Direct Binding reference Test Test Prerequisites 4.2 Introduction Chapter One and Three Labs completed, working and deployed. SOA and Oracle Service Bus server running.. Note: The solution for this chapter can be found in /home/oracle/soaosb/solutions/chap-4. To run this solution, you must first complete Chapter 1 to set up the environment. Then, open JDev and deploy the composite solutions for POProcessing, CreditCardValidation, and ConsumeJMSFulfillmentApp from /home/oracle/soa-osb/solutions/chap-4. You will find the OSB solution config jar named chap-4-solution-sbconfig.jar. Deploy the OSB config jar first and then the SOA composites. In this chapter, you will learn to use Oracle Service Bus to Mediate Direct Binding service exposed by SOA Suite. You will use a Business Service with the soa-direct protocol in Oracle Service Bus. Use Dynamic Routing in the Proxy Service Message Flow to dynamically route between Business Services Section 4.1 Page 1 of 38

2 OSB 11gR1 Workshop Use Direct Binding Reference in SOA composite to invoke OSB Proxy Service with SB transport protocol Pega Corporation s POProcessing application has been in production for some time. This application is being extensively leveraged by the Mega Corporation to submit purchase orders. Increasing order volumes have brought in increasing demands for customer satisfaction and/or order visibility/reliability. After extensive discussions, the IT departments of both companies agreed that having transaction (and security) context propagation between the two systems will enable meeting the growing demands for customer satisfaction through improved transaction visibility/reliability. Luckily for Pega Corporation, the timing of this decision could not be better. Oracle recently released SOA Suite 11gR1 PS2 that supports a new binding called Direct Binding, which allows invoking SOA components over RMI with transaction and security context propagation from the client. Pega Corporation decides to upgrade to SOA Suite 11gR1 PS2 to leverage the Direct Binding for POProcessing. Mega Corporation will test the new binding starting with orders with low value. Orders less than $1000 will be routed to the Direct Binding service, while orders of greater value will continue to be routed to the WS Binding service. Once this section is complete the execution flow of Receive PO in the Mega Corporation will look as follows In addition, Pega Corporation decides to use Direct Binding reference in the POProcessing composite to invoke the Credit Card validation (composite) service that is virtualized using OSB. This enables POProcessing composite to propagate transaction and security context into OSB. Pega Corporation decides to test the Direct Binding using a test credit card. Hence, logic (BPEL) in the POProcessing composite is updated to use the Direct Binding reference if the credit card number is For other credit cards the WS Binding reference will be used as before. Once this section is complete the credit card validation flow will look as follows Section 4.2 Page 2 of 38

3 4.3 OSB to SOA Suite Direct binding What is being done? In this section, you will add a Direct Binding service to the POProcessing Composite. You will invoke the Direct Binding service from OSB using Business Service with soadirect protocol. Following steps will be performed JDeveloper - Create Direct Binding exposed service in the POProcessing Composite. OSB Console - Create Business Service with soa-direct protocol using the WSDL for the Direct Binding service in SOA. OSB Console - Update Message Flow for the receivepo_db Proxy Service with a Dynamic Routing action to route either to the WS binding service or to the Direct Binding service Create Direct Binding exposed service in POProcessing Composite In this section you will add a Direct Binding service to the POProcessing Composite and then Wire this service to the routepo component. 1. In JDeveloper, Open POProcessing/SOA Content/composite.xml 2. Drag and Drop Direct Binding service from Component Palette to the Exposed Services swim lane 3. Update Service a. Name: receivepodirect b. WSDL URL: receivepo.wsdl Section 4.3 Page 3 of 38

4 OSB 11gR1 Workshop c. Port Type: execute_ptt 4. Wire receivepodirect service to routepo component 5. Click Save 6. Deploy POProcessing Composite a. Select POProcessing composite in Application Navigator b. Right Click c. Deploy -> POProcessing d. Deploy to Application Server e. Deploy Configuration i. New Revision ID: 1.0 ii. Check 1. Mark composite revision as default 2. Overwrite any existing composites with the same revision ID iii. Do not select the ADF Task Flow f. Select Application Service Connection MyAppServerConnection g. Click Finish h. You will see the following message in the Deployment tab 7. Copy the URL for the Direct Binding service s WSDL from JDeveloper. This will be handy when you need the URL to import the WSDL for the Direct Binding service from OSB. Section 4.3 Page 4 of 38

5 a. Expand the receivepodirect Direct Binding service in the Application Server connection as shown below b. Right-click on receivepodirect service and select Copy Path Section 4.3 Page 5 of 38

6 OSB 11gR1 Workshop Create soa-direct Business Service in Oracle Service Bus In this section, you will import the WSDL for the Direct Binding service into OSB. You will then create a Business Service based on this WSDL. 1. Get WSDL URL for Direct Binding service this is an alternative way to get the URL for Direct Binding service. You can skip this step if you already copied the WSDL URL path for the Direct Binding service from JDeveloper a. Go to (change host name if necessary depending on where your browser is run from) i. Username weblogic ii. Password welcome1 b. Click on link View WSDL for receivepodirect and copy WSDL URL. Remember to remove any version information from the url. 2. Login to OSB Console i Create WSDL Resource in Oracle Service Bus a. Create Session (Click Create in the Change Center) b. Navigate to Folder POProcessing/Resources c. Create Resource: Bulk - Resources from URL Section 4.3 Page 6 of 38

7 d. In Load Resources i. URL: (or you can paste the WSDL URL path copied earlier from Jdeveloper and replace IP with orapbpm-server) ii. Resource Name: receivepodirect iii. Resource Type: WSDL iv. Click Next v. Click Import. This creates two resources in POProcessing/Resources 1. receivepodirect - WSDL 2. XMLSchema-<generated-id> XML Schema 4. Next, create Business Service based on the WSDL imported in previous Step. Section 4.3 Page 7 of 38

8 OSB 11gR1 Workshop a. Navigate to Folder POProcessing/BusinessServices b. Create Resource: Business Service i. Service Name: receivepodirect ii. Service Type: WSDL Web Service 1. Click Browse and select the WSDL POProcessing/Resources/receivePODirect 2. Select Port: receivepodirectdirectbindingport11 Section 4.3 Page 8 of 38

9 iii. Click Next iv. Protocol: soa-direct (will be selected by default) v. Click Next (leave the defaults on the SOA-DIRECT Transport Configuration screen) vi. Click Last vii. Click Save (Do not forget to click Save on the Summary Page) Update receivepo_db Proxy Service Message Flow Update the Message Flow for the receivepo_db Proxy Service to use a Dynamic Routing action instead of the Route action. The Dynamic Routing action will route to the receivepodirect Business Service if the order total is less than $1000. Otherwise, the Purchase Order is routed to the receivepo Business Service 1. Navigate to POProcessing/ProxyServices/receivePO_db Proxy Service Section 4.3 Page 9 of 38

10 OSB 11gR1 Workshop 2. Click on to see the Message Flow 3. Click RouteNode1, select Edit Route 4. Click select Delete this Action 5. Add an Action: Communication -> Dynamic Routing (another alternative will be to use a Routing Table try Routing Table for extra credit) 6. Dynamic route to service: (The evaluation of the XQuery Expression must return an XML fragment in the following format. This XML fragment will determine the Business Service that will be invoked) <ctx:route xmlns:ctx= > <ctx:service isproxy= false >path/to/businessservice</ctx:service> <ctx:operation>operation-name</ctx:operation> <ctx:route> If the path is to a proxy service then set isproxy attribute to true. a. Click <Expression> i. Add [User Defined] Namespace Section 4.3 Page 10 of 38

11 1. Prefix: ord 2. URI: 3. Click Add ii. Copy content of /home/oracle/soa-osb/solutions/chap-4/dynamicroute-xq.txt into the XQuery Text text area as shown below 7. Click Save All iii. Click Save 8. Activate Session by clicking on Activate in Change Center 9. Add optional Description and click Submit Section 4.3 Page 11 of 38

12 OSB 11gR1 Workshop Test 1 Before you proceed with the testing please read the following trouble shooting note. Note - Troubleshooting: During your testing If you see a failure. Drill down to the POProcessing composite in EM. If you see the following error message on the POProcessing composite and the composite is in Running/Faulted state, you must restart the server. Test again after server restart. If the error persists, delete the dynamic route node that allows routing to receivepodirect business service. This will force routing to the receivepo business service (http-based). The root cause for this error can be traced to the validationforcc composite (that is invoked from OSB) as shown below Section 4.3 Page 12 of 38

13 1. Select Requisition/ProxyServices/createRequisition. Click icon under Actions to launch test console. 2. Load the sample input from /home/oracle/soa-osb/input/small.txt & click Execute. The value of this order is $750. Hence, we expect the Direct Binding service for POProcessing to be invoked. 3. You should see the following response Section 4.3 Page 13 of 38

14 OSB 11gR1 Workshop 4. Go to Oracle Service Bus Console. Navigate to Operations followed by Message Reports. You should see the following report 5. Next, navigate to Fusion Middleware Control ( 1. Expand SOA/soa-infra/default and click on POProcessing 2. Click on Instance ID of the latest instance in the Recent Instances table of the Dashboard 3. You should see the following Notice the first entry is receivepodirect service, which is the Direct Binding. Section 4.3 Page 14 of 38

15 4.3.6 Test 2 1. Select Requisition/ProxyServices/createRequisition. Click icon under Actions to launch test console. 2. Load the sample input from /home/oracle/soa-osb/input/medium.txt & click Execute. This sample has order total greater than $1000. Hence, the WS Binding POProcessing service will be invoked from receivepo_db proxy service. 3. You should see the following result on the Oracle Service Bus Test console Section 4.3 Page 15 of 38

16 OSB 11gR1 Workshop 4. Go to Oracle Service Bus Console. Navigate to Operations followed by Message Reports. You should see the following report 5. Next, navigate to Fusion Middleware Control ( 1. Exapnd SOA/soa-infra/default and click on POProcessing 2. Click on Instance ID of the latest instance in the Recent Instances table of the Dashboard 3. You should see the following Notice that the first entry is the receivepo WS (HTTP) exposed service. 4.4 SOA Suite to OSB Direct Binding What is being done? In this section, you will expose the virtualized validationforcc Composite service using the SB transport protocol (This is in addition to the HTTP Proxy Service that virtualized the same service in Chapter 1). SB Protocol allows invoking (from SOA Suite or OSB) OSB Proxy Service over RMI. POProcessing composite will use the Direct Binding reference to invoke the Proxy Service with SB transport protocol. Following steps will be performed OSB Console - Create Proxy Service with SB transport protocol routing to validationforcc Business Service. Section 4.4 Page 16 of 38

17 JDeveloper Create Direct Binding reference, pointing to the SB transport protocol Proxy Service, in the POProcessing composite JDeveloper - Update approvelargeorder BPEL to invoke Direct Binding reference when credit card number is Otherwise, the WS Binding reference is invoked Create SB transport protocol Proxy Service in OSB In this step you will create SB transport protocol Proxy Service that routes to the validationforcc business service in Credit_Services/BusinessServices 1. In OSB Console create a new session by clicking on Create 2. Click Credit_Services/ProxyServices 3. From Create Resource select Proxy Service Section 4.4 Page 17 of 38

18 OSB 11gR1 Workshop 4. In General Configuration a. Service Name: ValidateCredit_SB b. Create From Existing Business Service (this will automatically add a Route action in the message flow that routes to the selected Business Service) Select Business Service, Click Browse and choose validationforcc in Credit_Services/BusinessServices Section 4.4 Page 18 of 38

19 c. Click Next 5. In Transport Configuration a. Protocol: sb b. Click Next 6. Click Last 7. Click Save (Do not miss this step as your configuration will not be saved otherwise) Section 4.4 Page 19 of 38

20 OSB 11gR1 Workshop 8. Click on the icon to edit the ValidateCredit_SB message flow. You will a Report action in the message flow for testing purpose. 9. Click on the envelope above ValidateCredit_SB Select Add Pipeline Pair. 10. Click on left Request_Pipeline and select Add Stage. Section 4.4 Page 20 of 38

21 11. Click on new Stage and select Edit Stage. 12. Click on Add an Action->Reporting->Report. You will see Report action as above. 13. Fill in fields as follows: Expression: $body (Click on <Expression>, Enter $body in text area, Click Save) Click Add a key: KeyName: CCNumber-SB Key Value:./cca:creditcardStatusRequest/cca:CCNumber Click <XPath> Section 4.4 Page 21 of 38

22 OSB 11gR1 Workshop Type above value in text area OR select Variable Structure on the left bottom. Select body from Drop Down, Expand $body execute (request) and select CCNumber (as shown in figure below) The Property Inspector field will be populated with the XPath as shown below. Click on Copy Property to copy the XPath automatically into the text area above. (Make sure the cursor is in the text area before you click Copy Property for the copy to work) Click Save In the in variable field type: body and Click Save 14. Click Save 15. Click Save All 16. Click Activate in the Change Center to activate your changes Section 4.4 Page 22 of 38

23 17. Click Submit (Do not miss this step as your configuration will not be activated otherwise) Create Direct Binding reference in POProcessing Composite In this step you will update the POProcessing composite to add a Direct Binding reference invoking the SB transport protocol Proxy Service in OSB. 18. Open the POProcessing composite.xml 19. Drag and Drop Direct Binding from the Component Palette to the External References swim lane 20. In the Create Direct Binding dialog set a. Name: DirectGetCCStatus b. Reference Target: Oracle Service Bus c. WSDL URL: Click on to select the WSDL for SB Proxy Service in OSB In the SOA Resource Browser, expand IDE Connections as show below and select ValidateCredit_SB and click OK Section 4.4 Page 23 of 38

24 OSB 11gR1 Workshop 21. Rest of the fields are automatically completed as shown below 22. Click OK Section 4.4 Page 24 of 38

25 23. Direct Binding reference is created as shown below 24. Wire approvelargeorder to DirectGetCCStatus reference. Select approvelargeorder, Drag and Drop the arrow from approvelargeorder on the arrow on DirectGetCCStatus reference as shown below This will create the wire as shown below Section 4.4 Page 25 of 38

26 OSB 11gR1 Workshop Update approvelargeorder BPEL to selectively invoke Direct Binding reference In this step you will update logic in the approvelargeorder BPEL to invoke the Direct Binding reference if the credit card number is , otherwise, WS Binding reference is invoked. 25. Double Click on approvelargeorder component 26. Delete invokeccstatusservice invoke activity by right clicking, selecting delete, and confirm Section 4.4 Page 26 of 38

27 27. Add Switch below assignccnumber activity 28. Click Add Condition on the Switch activity as shown below Section 4.4 Page 27 of 38

28 OSB 11gR1 Workshop 29. Launch Expression Builder, expand inputvariable to select ns2:cardnumber. Drag and Drop this variable (XPath) into the text area. Next, update text area with the condition as shown below (ie, add = at the end) Section 4.4 Page 28 of 38

29 30. Click OK 31. Click OK 32. Add Invoke activity to the branch with the condition 33. Drag and Drop arrow on right of the invoke icon to the DirectBinding reference (partner link) as shown 34. In the Edit Invoke dialog set a. Name: directgetccstatus b. Input Variable: invokeccstatusservice_execute_inputvariable (click to pick the variables) c. Output Variable: invokeccstatusservice_execute_outputvariable d. Click OK Section 4.4 Page 29 of 38

30 OSB 11gR1 Workshop 35. Add Invoke to the second branch 36. Drag and Drop on the right of the Invoke icon on to the getcreditcardstatus reference (partner link) as shown below Section 4.4 Page 30 of 38

31 37. In the Edit Invoke dialog set a. Name: getcreditcardstatus b. Input Variable: invokeccstatusservice_execute_inputvariable (click to pick the variable) c. Output Variable: invokeccstatusservice_execute_outputvariable Click OK Section 4.4 Page 31 of 38

32 OSB 11gR1 Workshop The Switch activity will look as follows 38. Click Save all (Do not miss this step) 39. Deploy POProcessing composite to server. a. Right click on POProcessing project, Deploy, POProcessing Section 4.4 Page 32 of 38

33 b. Select Deploy to Application Server c. Check Overwrite existing composites with the same revision ID d. Click Next e. Select MyAppServerConnection f. Click Finish g. When the deployment is successful you see the following message in the Deployment tab Section 4.4 Page 33 of 38

34 OSB 11gR1 Workshop Test Select Requisition/ProxyServices/createRequisition. Click icon under Actions to launch test console. 41. Load the sample input from /home/oracle/soa-osb/input/medium.txt & click Execute. This sample has order total greater than $1000, hence credit check will be performed on the Purchase Order, generated from the Requisition, by the POProcessing composite. Since the credit card number is POProcessing composite will invoke the Direct Binding reference to SB Proxy Service in OSB. 42. You should see the following result on the Oracle Service Bus Test console Section 4.4 Page 34 of 38

35 43. Go to Oracle Service Bus Console. Navigate to Operations followed by Message Reports. You should see the following report. You will notice that the Report action (CCNumber-SB= ) in the ValidateCredit_SB is seen below. This indicates that the POProcessing composite used the Direct Binding reference to invoke OSB. 44. Next, navigate to Fusion Middleware Control ( 45. Expand SOA/soa-infra/default and click on POProcessing 46. Click on Instance ID of the latest instance in the Recent Instances table of the Dashboard 47. You should see the following. Notice that the POProcessing composite invoked the DirectBinding reference (to OSB SB Proxy Service, ValidateCredit_SB) Section 4.4 Page 35 of 38

36 OSB 11gR1 Workshop Test Invoke Requisition/ProxyServices/createRequisition with sample data in /home/oracle/soa-osb/input/medium.txt. However, update the credit number (ccnumber) to be instead of as shown below <cre:osbrequisitioncollection xmlns:cre=" quisition"> <cre:osbrequisition> <cre:requisitioner>bob</cre:requisitioner> <cre:reqid>3333</cre:reqid> <cre:productname>ipod Shuffle</cre:productname> <cre:item>1gb</cre:item> Section 4.4 Page 36 of 38

37 <cre:itemtype>electronics</cre:itemtype> <cre:reqdate>march 16, 2010</cre:reqDate> <cre:description>string</cre:description> <cre:quantity>5.00</cre:quantity> <cre:price>500.00</cre:price> <cre:currency>usd</cre:currency> <cre:deliverydate>april 16, 2010</cre:deliverydate> <cre:plant>boulder</cre:plant> <cre:cctype>mastercard</cre:cctype> <cre:ccnumber> </cre:ccnumber> </cre:osbrequisition> </cre:osbrequisitioncollection> Since the credit card number does not match POProcessing composite will use the WS Binding to invoke ValidateCredit HTTP Proxy Service in OSB. 49. Go to Operations->Message Reports in OSB console. You will see the following reports. Notice that the report from ValidateCredit (CCNumber= ) can be seen indicating that the HTTP proxy service was invoked from POProcessing composite using the WS binding. 50. Next, navigate to Fusion Middleware Control ( 51. Expand SOA/soa-infra/default and click on POProcessing 52. Click on Instance ID of the latest instance in the Recent Instances table of the Dashboard 53. You should see the following. Notice that the POProcessing composite invoked the WS binding reference (to OSB HTTP Proxy Service, ValidateCredit) Section 4.4 Page 37 of 38

38 OSB 11gR1 Workshop Congratulations, you are done! Section 4.4 Page 38 of 38