This section explains how to create Oracle Service Bus projects using the Oracle Service Bus console and JDeveloper. To create these projects, you first need to generate Oracle RightNow adapter artifacts using JDeveloper 12c, and subsequently, use those artifacts while creating Oracle Service Bus projects and services with the Oracle Service Bus console.
This chapter contains the following topics:
To create Oracle Service Bus projects using Oracle Service Bus Console, you must use Oracle RightNow adapter artifacts generated using JDeveloper.To create a BPEL composite, see the section Section 5.3, "Designing a Composite for Service Integration".
You use the artifacts generated in Section 5.4, "Configuring Oracle RightNow Adapter" in creating Oracle Service Bus business services in Oracle Service Bus console.
Note:You must configure the CSF key on the Fusion MIddleware Control Console. For an explanation of the steps to configure the CSF key on Fusion Middleware Control Console, refer to Appendix A, "Credential Store Configuration for Managing RightNow Credentials"
To create Oracle Service Bus projects and services using the Oracle Service Bus console.
Log in to Oracle Service Bus Console:
On right side of the page, click Create. This opens a new session in the Oracle Service Bus console to enable you to make changes.
Right-click All Projects and click Create - Project.
The Oracle Service Bus Console displays the Create a new Project dialog box.
Enter the project name in the Resource Name field, and provide the description in Description field.
Click Create. A new project named
RightNow Create appears under All Projects.
Import the Oracle RightNow adapter artifacts in this project. Right-click the Project name just created. Select Create and select the WSDL.
The console displays the WSDL Creation Page. Click Browse and browse to the directory where you have stored the artifacts received from JDeveloper. Choose the Oracle Cloud Adapter for RightNow WSDL.
Right-click the Project name, from the menu select Create and then WSDL. On the WSDL Creation Page, browse for
Select JCA Binding from the Create drop-down list under Project Name.
The JCA Binding creation dialog box is displayed. Click Browse and browse to the directory where the artifacts received from the JDeveloper 12c are stored. Choose the
Oracle Cloud Adapter for RightNow JCA file.
Click Create. You are returned to the Project page. You might get an error message such as
The JCA Binding 'rightnowReference_rightnow' was successfully created with validation errors. View the JCA Binding/Conflicts to see detailed diagnostic messages.
This error is thrown because the JCA binding cannot find the associated WSDL. To rectify the error if you receive it, click the JCA file you created and then click Edit.
Click Browse. Search for the WSDL you created and click Submit after choosing the WSDL.
Navigate to the project folder. Right-click the JCA Binding just created, and click Generate WSDL and Service option.
Enter a new name for the WSDL name in the New WSDL Name field and the service name in the New Service Name field.
Note:Choose the correct location for the new WSDL and service to be generated.
The console generates the new WSDL and the new business service.
Activate the Oracle Service Bus session by clicking Activate in the right corner.
The console displays the Confirm Session Activation dialog box. Click Activate to activate the session.
Click Activate to activate a session.
This section describes how to create a Service Bus project using JDeveloper. It also includes information on generating an Oracle Service Bus JCA Business Service using the Oracle RightNow adapter. It includes: creating an empty composite for the Oracle Service Bus, then defining an Oracle Service Bus outbound process, and finally deploying that Oracle Service Bus project on a server.
To create an empty composite for the Oracle Service Bus:
Create a new Oracle Service Bus application, Select File-->New-->Application. The New Gallery opens, where you can select application components to create.
On the Name your Application page, optionally change the name and directory location for the application.
Create a new Service Bus project.
On the Name your Project page, optionally change the name of your Service Bus project. Make sure the project directory is in the application directory (this is the default).
This section describes how to define an Oracle Service Bus Business Service for RightNow integration using the Oracle RightNow adapter, which consists of the following stages:
To configure an Oracle RightNow adapter component:
Open the Service Bus Overview Editor.
Drag and drop the Oracle RightNow adapter component from the Components panel to the External Services swim lane.
The Welcome page of the adapter configuration wizard is displayed.
Enter a reference name for the RightNow adapter reference in the Name field and then click Next.
On the Connection Information page, browse for the Enterprise WSDL location by clicking on the Browse button.
The WSDL Chooser dialog is displayed. Browse and select the downloaded Enterprise WSDL and click OK.
Click Finish. The wizard returns you to the RightNow Cloud Server Connection page.
Select an authentication key from the dropdown, if available, or create an Authentication key by clicking on + button.
The Add Credential dialog box is displayed. Provide a suitable name and the RightNow credentials and click OK.
Click the Test Connection button to validate the Authentication Key.
Click Next. The Cloud Operation Configuration page is displayed.
The WSDL Operation by default is
Create. You can edit this operation by providing an operation name suitable to your business requirement. Select the Account object from the Available objects list, and move to the Selected objects list.
Click Next, The Finish page is displayed.
To configure a Service Bus Proxy Service:
Using the Oracle Service BusOracle Service Bus Overview Editor, right-click the Pipeline/Split Joins lane and click Insert and then Pipeline.
The Create Pipeline Service dialog is displayed.
In the Service Name field, enter a name to identify the pipeline name and select the corresponding location of the project.
Click Next and select the Service Type as WSDL.
Click the Browse icon, which is located to the right of the WSDL URL, to select the WSDL from the file system.
Select the appropriate WSDL file from the Application -> Resources.
Click OK. The selected WSDL and corresponding binding is displayed. Ensure the check box for Expose as a Proxy Service is selected.
Select Proxy Transport as http.
Click Finish. The Pipeline component is displayed.
rightnowReference to the Pipeline.
Open the pipeline which shows the default routing. Verify the service and corresponding operation will be displayed in the Routing Properties.
The outbound Service Bus Project is ready to be deployed
To deploy the outbound Oracle Service Bus Project:
Select the project and select Deploy to Service Bus Server.
Select the already-configured Application Server and click Next.
Check the deployment summary and click Finish.
The Success Message page indicates the Project is successfully deployed.
The successfully deployed project can be tested from Service Bus Console.
To test the Oracle Service Bus project from the Service Bus Console:
Open the Service Bus Console and enter user ID and Password.
All the deployed projects are displayed under All Projects.
Open the project you want to test and click Proxy Service of that project. For example, PipelineProxyService in this case, as shown in the Figure below
The Option for Launch Test Console (Green arrow button) is displayed for testing the outbound endpoint.
Launching Test Console opens new window displaying the Proxy Service and the operation to test along with Execute, Execute-Save, Reset and Close button.
The Request Document section contains the Request Payload.
Provide the input and click the Execute button. This sends the payload to Oracle RightNow Cx and the response is displayed under the Response Document section.