Oracle AS Adapter for Siebel provides bi-directional connectivity to Siebel EAI. It uses the Siebel COM and Java Data Bean API to synchronously invoke Siebel transactions - Siebel Business Objects and Business Services. It uses Siebel’s robust EAI framework to asynchronously receive events from Siebel in the form of Siebel Integration Objects. It supports more than one way of receiving events from the Siebel application namely Files, HTTP and MQSeries and ensures guaranteed delivery of Siebel events. It translates Siebel native data to standard XML format and back.
Deployment of Adapter
During installation, Oracle Application Adapter for Siebel is deployed as a J2CA 1.0 resource adapter within the WLS container. The adapter must be deployed in the same WLS container as Oracle BPEL Process Manager.Configuring a New Application Server Connection
To configure a new Application Server connection in Oracle JDeveloper:- Open Oracle JDeveloper on your system.
- From the menu bar, click View and select Application Server Navigator.
Description of the illustration config_appserver1.gif
The Application Server tab is displayed.
Description of the illustration config_appserver2.gif - Right-click Application Servers, and then select New Application Server.
The Create Application Server Connection Wizard - Usage page is displayed.
Description of the illustration config_appserver3.gif - Accept the default selection (Standalone Server) and click Next.
The Name and Type page is displayed.
Description of the illustration config_appserver4.gif - Specify a new name for the Application Server connection and click Next.
The Authentication page is displayed.
Description of the illustration config_appserver5.gif - Specify a valid user name (for example, weblogic) and a password (for example, welcome1) for your new connection.
- Click Next.
The Configuration page is displayed.
Description of the illustration config_appserver6.gif - Specify the Oracle WebLogic host name (for example, localhost), which is the machine IP where the process needs to deploy and Oracle WebLogic domain (for example, base_domain).
- Click Next.
The Test page is displayed.
Description of the illustration config_appserver7.gif - Click Test Connection.
- Ensure that the test status is successful.
- Click Next.
The Finish page is displayed.
Description of the illustration config_appserver8.gif - Click Finish.
The new Application Server connection is listed in the left pane (Application Server tab), as shown in the following image.
Description of the illustration config_appserver9.gif
Designing an Outbound BPEL Process for Service Integration
The following tools are required to complete your adapter design-time configuration:- Oracle Adapter Application Explorer (Application Explorer)
- Oracle JDeveloper BPEL Designer (JDeveloper) or Eclipse
Siebel Service Integration
This section describes how to perform service integration with Siebel. The following topcis are included:- Creating a Request-Response J2CA Service in Application Explorer
- Creating an Integration Object Node
Creating a Request-Response J2CA Service in Application Explorer
To generate WSDL in Application Explorer:- Start Application Explorer and connect to a defined Siebel target or create a new target.
See Connecting to a Defined Target for more information. - Expand the Siebel target to which you are connected.
- Expand Business Object, Account, and then Account.
Description of the illustration wsdl_generate1.gif - Right-click queryWithView, and then select Create Outbound JCA Service (Request/Response).
The Export WSDL dialog is displayed.
Description of the illustration wsdl_generate2.gif - Specify an export location on your file system or accept the default path.
The .wsdl file extension is added automatically. By default, the names of WSDL files generated for request-response services end with _invoke. - Click OK.
Creating a New SOA Application for the Outbound BPEL Process
Perform the following steps to create a new SOA application for the outbound BPEL process:- Open Oracle JDeveloper on your system.
- In the Application Navigator tab, click New Application.
Description of the illustration bpel_out_comp1.gif
The Create SOA Application wizard is displayed.
Description of the illustration bpel_out_comp2.gif - From the Application Template list, click SOA Application.
- Enter name for the new SOA application (for example, Siebel_Outbound_BPEL) and click Next.
The Name your project page is displayed.
Description of the illustration bpel_out_comp3.gif - Enter a project name (for example, QueryWithView_Invoke) and click Next.
The Configure SOA settings page is displayed.
Description of the illustration bpel_out_comp4.gif - From the Composite Template list, select Empty Composite and click Finish.
The new SOA application (Siebel_Outbound_BPEL) and associated project (QueryWithView_Invoke) are added to the Application Navigator tab in the left pane.
Description of the illustration bpel_out_comp5.gif
Defining a BPEL Outbound Process
This section describes how to define a BPEL outbound process, which consists of the following stages:- Configuring a Third Party Adapter Service Component
- 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:- Drag and drop the Third Party Adapter component from the Component Palette tab (Service Adapters section) to the External References design pane.
Description of the illustration bpel_out_adapt1.gif
The Create Third Party Adapter Service dialog is displayed.
Description of the illustration bpel_out_adapt2.gif - Enter a name for the new third party adapter service.
- Ensure that Reference is selected from the Type list (default).
- Click the Find existing WSDLs icon, which is located to the right of the WSDL URL field.
The SOA Resource Browser dialog is displayed.
Description of the illustration bpel_out_adapt3.gif - Browse and select an outbound WSDL file from the following directory:
C:\oracle\Middleware\Oracle_SOA1\soa\thirdparty\ApplicationAdapters\wsdls - Click OK.
The Localize Files dialog is displayed.
Description of the illustration bpel_out_adapt4.gif - 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.
Description of the illustration bpel_out_adapt5.gif - Click the Find JCA Files icon, which is located to the right of the JCA File field.
The SOA Resource Browser dialog is displayed.
Description of the illustration bpel_out_adapt6.gif - Browse and select the JCA properties file from the following directory:
C:\oracle\Middleware\Oracle_SOA1\soa\thirdparty\ApplicationAdapters\wsdls - Click OK.
The following message is displayed.
Description of the illustration bpel_out_adapt7.gif - 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.
Description of the illustration bpel_out_adapt8.gif - Click OK.
The third party adapter service component (GetDetail) is created in the External References pane, as shown in the following image.
Description of the illustration bpel_out_adapt9.gif
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:- Drag and drop the BPEL Process component from the Component Palette tab (Service Components section) to the Components design pane.
Description of the illustration bpel_out_proc1.gif
The Create BPEL Process dialog is displayed.
Description of the illustration bpel_out_proc2.gif - In the Name field, enter a name to identify the new outbound BPEL process component (for example, querywithview_out).
- From the Template list, select Synchronous BPEL Process.
- Click the Browse Input Elements 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.
Description of the illustration bpel_out_proc3.gif - Expand Project Schema Files, queryWithView_invoke_request.xsd, and then select Siebel.
- Click OK.
You are returned to the Create BPEL Process dialog.
Description of the illustration bpel_out_proc4.gif - Click the Browse Output Elements 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.
Description of the illustration bpel_out_proc5.gif - Expand Project Schema Files, queryWithView_invoke_response.xsd, and then select SiebelResponse.
- Click OK.
You are returned to the Create BPEL Process dialog.
Description of the illustration bpel_out_proc6.gif - Click OK.
- Create a connection between the outbound BPEL process component (querywithview_out) and the third party adapter service component (QueryWithView).
Description of the illustration bpel_out_proc7.gif - Double-click the outbound BPEL process component (querywithview_out) in the Components pane.
The following is displayed.
Description of the illustration bpel_out_proc8.gif - Drag and drop the Invoke activity component to the Components pane and place it between the receiveInput activity component and the replyOutput activity component.
Description of the illustration bpel_out_proc9.gif - Create a connection between the new Invoke activity component (Invoke_1) and the third party adapter service component (QueryWithView).
Description of the illustration bpel_out_proc10.gif
The Edit Invoke dialog is displayed.
Description of the illustration bpel_out_proc11.gif - Click the Automatically Create Input Variable icon, which is located to the right of the Input field to configure a new input variable.
The Create Variable dialog is displayed.
Description of the illustration bpel_out_proc12.gif - Accept the default values that are provided for the new input variable and click OK.
You are returned to the Edit Invoke dialog.
Description of the illustration bpel_out_proc13.gif - Click the Automatically Create Output Variable icon, which is located to the right of the Output field to configure a new output variable.
The Create Variable dialog is displayed.
Description of the illustration bpel_out_proc14.gif - Accept the default values that are provided for the new output variable and click OK.
You are returned to the Edit Invoke dialog.
Description of the illustration bpel_out_proc15.gif - Click Apply and then OK.
The Invoke activity component (Invoke_1) is updated accordingly.
Description of the illustration bpel_out_proc16.gif - 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).
Description of the illustration bpel_out_proc17.gif - Double-click the new Assign activity component (Assign_1).
The Assign dialog is displayed.
Description of the illustration bpel_out_proc18.gif - Click the Copy Operation tab.
- Click the Plus sign icon and select Copy Operation from the list of available operations.
The Create Copy Operation dialog is displayed.
Description of the illustration bpel_out_proc19.gif - In the From pane, expand Variables, InputVariable, and then select payload.
- In the To pane, expand Variables, Invoke_1_queryWithView_InputVariable, and then select input_queryWithView.
- Click OK.
You are returned to the Assign dialog.
Description of the illustration bpel_out_proc20.gif - Click Apply and then OK.
- 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).
Description of the illustration bpel_out_proc21.gif - Double-click the new Assign activity component (Assign_2).
The Assign dialog is displayed.
Description of the illustration bpel_out_proc18.gif - Click the Copy Operation tab.
- Click the Plus sign icon and select Copy Operation from the list of available operations.
The Create Copy Operation dialog is displayed.
Description of the illustration bpel_out_proc22.gif - In the From pane, expand Variables, Invoke_1_queryWithView_OutputVariable, and then select output_queryWithView.
- In the To pane, expand Variables, outputVariable, and then select payload.
- Click OK.
You are returned to the Assign dialog.
Description of the illustration bpel_out_proc23.gif - Click Apply and then OK.
The completed activity flow is now displayed.
Description of the illustration bpel_out_proc24.gif - Double-click composite.xml in the left pane.
Description of the illustration bpel_out_proc25.gif - Click the Save All icon in the menu bar to save the new outbound BPEL process component that was configured.
Description of the illustration bpel_out_proc26.gif
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.- Right-click the project name in the left pane (for example, QueryWithView_Invoke), select Deploy, and then click QueryWithView_Invoke.
Description of the illustration bpel_out_deploy1.gif
The Deployment Action dialog is displayed.
Description of the illustration bpel_out_deploy2.gif - Ensure that Deploy to Application Server is selected.
- Click Next.
The Deploy Configuration dialog is displayed.
Description of the illustration bpel_out_deploy3.gif - Leave the default values selected and click Next.
The Select Server dialog is displayed.
Description of the illustration bpel_out_deploy4.gif - Select an available application server that was configured and click Next.
The SOA Servers dialog is displayed. - Select a target SOA server and click Next.
The Summary dialog is displayed.
Description of the illustration bpel_out_deploy5.gif - Review and verify all the available deployment information for your project and click Finish.
The process is deployed successfully.
Description of the illustration bpel_out_deploy6.gif
If an Authorization Request dialog is displayed during the deployment process, provide the required user name and password and click OK.
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.- Log in to the Oracle Enterprise Manager console by using the following URL:
http://localhost:7001/em - Expand your domain in the left pane followed by the SOA folder.
Description of the illustration bpel_out_test1.gif - Select an available project (for example, Siebel_Outbound_queryWithView_BPEL).
Description of the illustration bpel_out_test2.gif - Click Test in the right pane.
The Test Web Service page is displayed.
Description of the illustration bpel_out_test3.gif - Click the Request tab.
- Scroll down to the Input Arguments section.
Description of the illustration bpel_out_test4.gif - Select XML View from the list in the upper-left corner.
- Provide an appropriate input XML document in the Input Arguments area.
- Click Test Web Service.
The output response is received in the Response tab of the Oracle Enterprise Manager console.
Description of the illustration bpel_out_test5.gif
Testing Outbound BPEL and Mediator Processes
When testing an outbound BPEL process from the Oracle Enterprise Manager console or an outbound Mediator process from the 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.
No comments:
Post a Comment