1. Using the Oracle RightNow Adapter
  2. Developing Oracle Service Bus Integrations with the Oracle RightNow Adapter
  3. Generating Oracle Cloud Adapter Artifacts

6.1 Generating Oracle Cloud Adapter Artifacts

To create Oracle Service Bus projects using Oracle Service Bus Console, you must use Oracle RightNow adapter artifacts generated using Oracle JDeveloper. To create a BPEL composite, see the section Designing a Composite for Service Integration.

You use the artifacts generated in Configuring the Oracle RightNow Adapter to create Oracle Service Bus business services in Oracle Service Bus Console.

6.1.1 Creating Oracle Service Bus Projects Using Oracle Service Bus Console

To create Oracle Service Bus projects and services using Oracle Service Bus Console.

  1. Log in to Oracle Service Bus Console: http://hostname:port/servicebus.
  2. 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.

    Figure 6-1 Create an Oracle Service Bus Session

    Description of Figure 6-1 follows
    Description of "Figure 6-1 Create an Oracle Service Bus Session"
  3. Right-click All Projects and click Create - Project.

    Figure 6-2 Adding a New Project to Oracle Service Bus

    Description of Figure 6-2 follows
    Description of "Figure 6-2 Adding a New Project to Oracle Service Bus"
  4. The Oracle Service Bus Console displays the Create a new Project dialog box.
  5. Enter the project name in the Resource Name field, and provide the description in Description field.

    Figure 6-3 Create a New Project Page

    Description of Figure 6-3 follows
    Description of "Figure 6-3 Create a New Project Page"
  6. Click Create. A new project named RightNow Create appears under All Projects.
  7. Import the Oracle RightNow adapter artifacts in this project. Right-click the Project name just created. Select Create and select the WSDL.

    Figure 6-4 Choosing WSDL Reference

    Description of Figure 6-4 follows
    Description of "Figure 6-4 Choosing WSDL Reference"

    The console displays the WSDL Creation page.

  8. Click Browse and browse to the directory where you have stored the artifacts received from Oracle JDeveloper. Select the Oracle Cloud Adapter for RightNow WSDL.
  9. Click Create.
  10. Right-click the Project name, from the menu, select Create, and then WSDL.
  11. On the WSDL Creation page, browse for rightnowReference WSDL.

    Figure 6-6 rightnowReference WSDL

    Description of Figure 6-6 follows
    Description of "Figure 6-6 rightnowReference WSDL"
  12. Click Create.
  13. Select JCA Binding from the Create drop-down list under Project Name.

    Figure 6-7 Selecting JCA Binding from Create Drop-Down List

    Description of Figure 6-7 follows
    Description of "Figure 6-7 Selecting JCA Binding from Create Drop-Down List"

    The JCA Binding creation dialog box is displayed.

  14. Click Browse and browse to the directory where the artifacts received from the Oracle JDeveloper 12c are stored. Choose the Oracle Cloud Adapter for RightNow JCA file.

    Figure 6-8 Choosing the RightNow Adapter JCA File

    Description of Figure 6-8 follows
    Description of "Figure 6-8 Choosing the RightNow Adapter JCA File"
  15. 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.

  16. Click Browse. Search for the WSDL you created and click Submit after choosing the WSDL.

    Figure 6-9 Edit JCA Binding References

    Description of Figure 6-9 follows
    Description of "Figure 6-9 Edit JCA Binding References"
  17. Click Save.
  18. Navigate to the project folder. Right-click the JCA Binding just created, and click Generate WSDL and Service option.

    Figure 6-10 Generate WSDL and Service from JCA Binding

    Description of Figure 6-10 follows
    Description of "Figure 6-10 Generate WSDL and Service from JCA Binding"
  19. 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.

  20. Click Generate.

    Figure 6-11 Generate WSDL and Service

    Description of Figure 6-11 follows
    Description of "Figure 6-11 Generate WSDL and Service"

    The console generates the new WSDL and the new business service.

  21. Activate the Oracle Service Bus session by clicking Activate in the right corner.

    Figure 6-12 Activate Session

    Description of Figure 6-12 follows
    Description of "Figure 6-12 Activate Session"

    The console displays the Confirm Session Activation dialog box.

  22. Click Activate to activate the session.

    Figure 6-13 Confirming Session Activation

    Description of Figure 6-13 follows
    Description of "Figure 6-13 Confirming Session Activation"
  23. Click Activate to activate a session.

6.1.2 Creating a Service Bus Project, and Generating the Oracle Service Bus JCA Business Service

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.

6.1.2.1 Creating an Empty Console for the Oracle Service Bus and Creating a New Service Bus Project

To create an empty composite for the Oracle Service Bus:

  1. Create a new Oracle Service Bus application, Select File >New >Application. The New Gallery opens, where you can select application components to create.

    Figure 6-14 Choosing an Application

    Description of Figure 6-14 follows
    Description of "Figure 6-14 Choosing an Application"
  2. On the Name your Application page, optionally change the name and directory location for the application.

    Figure 6-15 Name Your Application

    Description of Figure 6-15 follows
    Description of "Figure 6-15 Name Your Application"
  3. Create a new Oracle Service Bus project.

    Figure 6-16 Create a New Project

    Description of Figure 6-16 follows
    Description of "Figure 6-16 Create a New Project"
  4. On the Name your Project page, optionally change the name of your Oracle Service Bus project. Make sure the project directory is in the application directory (this is the default).

    Figure 6-17 Name Your Project Page

    Description of Figure 6-17 follows
    Description of "Figure 6-17 Name Your Project Page"
  5. Click Finish.

6.1.2.2 Defining a Service Bus Business Service with the Oracle RightNow Adapter

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:

6.1.2.2.1 Configuring the Oracle RightNow Adapter Component

To configure an Oracle RightNow adapter component:

Note:

If the Import OSB Resource dialog is displayed during adapter configuration, click Cancel. You cannot localize the WSDL file.
  1. Open the Service Bus Overview Editor.
  2. Drag and drop the Oracle RightNow adapter component from the Components panel to the External Services swim lane.

    The Basic Info page of the adapter configuration wizard is displayed.

  3. Enter a connection name for the RightNow adapter in the Name field and then click Next.
  4. On the Connection page, browse for the Enterprise WSDL location by clicking on the Browse button.
  5. The WSDL Chooser dialog is displayed. Browse and select the downloaded Enterprise WSDL and click OK.
  6. Click OK.
  7. Click Next.
  8. Click Finish. The wizard returns you to the Connection page.
  9. Select an authentication key from the dropdown, if available, or create an Authentication key by clicking on + button.
  10. Click the Test button to validate the authentication key.
  11. Click Next. The Operations page is displayed.
  12. The operation by default is Create. You can change this operation by selecting an operation name suitable to your business requirement.
  13. Select the Account business object from the Available list, and move to the Selected list.
  14. Click Next, The Summary page is displayed.
6.1.2.2.1.1 Configuring a Proxy Service

To configure an Oracle Service Bus proxy service:

  1. Using the Oracle Service Bus Overview Editor, right-click the Pipeline/Split Joins lane and click Insert and then Pipeline.

    Figure 6-18 Pipeline Component

    Description of Figure 6-18 follows
    Description of "Figure 6-18 Pipeline Component"
    The Create Pipeline Service dialog is displayed.

    Figure 6-19 Create Pipeline Service Dialog

    Description of Figure 6-19 follows
    Description of "Figure 6-19 Create Pipeline Service Dialog"
  2. In the Service Name field, enter a name to identify the pipeline name and select the corresponding location of the project.
  3. Click Next and select the Service Type as WSDL.

    Figure 6-20 Creating a Pipeline

    Description of Figure 6-20 follows
    Description of "Figure 6-20 Creating a Pipeline"
  4. Click the Browse icon, which is located to the right of the WSDL URL, to select the WSDL from the file system.
  5. Select the appropriate WSDL file from the Application -> Resources.
  6. Click OK. The selected WSDL and corresponding binding is displayed. Ensure the check box for Expose as a Proxy Service is selected.

    Figure 6-22 Creating a Pipeline Service

    Description of Figure 6-22 follows
    Description of "Figure 6-22 Creating a Pipeline Service"
  7. Select Proxy Transport as http.
  8. Click Finish. The Pipeline component is displayed.

    Figure 6-23 Pipeline Component

    Description of Figure 6-23 follows
    Description of "Figure 6-23 Pipeline Component"
  9. Connect the Oracle RightNow adapter in the External Services swimlane to the pipeline.

    Figure 6-24 Connecting the rightnowReference to the Pipeline Component

    Description of Figure 6-24 follows
    Description of "Figure 6-24 Connecting the rightnowReference to the Pipeline Component "
  10. Open the pipeline which shows the default routing. Verify the service and corresponding operation will be displayed in the Routing Properties.

    Figure 6-25 Routing Properties

    Description of Figure 6-25 follows
    Description of "Figure 6-25 Routing Properties"

    The outbound Service Bus Project is ready to be deployed

6.1.2.2.1.1.1 Deploying the Outbound Oracle Service Bus Process

To deploy the outbound Oracle Service Bus Project:

  1. Select the project and select Deploy to Service Bus Server.
  2. Select the already-configured Application Server and click Next.

    Figure 6-27 Select Server Page.

    Description of Figure 6-27 follows
    Description of "Figure 6-27 Select Server Page."
  3. Check the deployment summary and click Finish.
  4. The Success Message page indicates the Project is successfully deployed.

Figure 6-29 Success Message Page

Description of Figure 6-29 follows
Description of "Figure 6-29 Success Message Page"

The successfully deployed project can be tested from Service Bus Console.

6.1.2.3 Testing the Oracle Service Bus Project from the Oracle Service Bus Console

To test the Oracle Service Bus project from the Oracle Service Bus Console:

  1. Open the Oracle Service Bus Console and enter the user ID and password.

    Figure 6-30 Service Bus Console

    Description of Figure 6-30 follows
    Description of "Figure 6-30 Service Bus Console"
  2. All the deployed projects are displayed under All Projects.

    Figure 6-31 Service Bus Deployed Projects

    Description of Figure 6-31 follows
    Description of "Figure 6-31 Service Bus Deployed Projects"
  3. 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

    Figure 6-32 Proxy Service Definition

    Description of Figure 6-32 follows
    Description of "Figure 6-32 Proxy Service Definition"
  4. The Option for Launch Test Console (Green arrow button) is displayed for testing the outbound endpoint.

    Figure 6-33 Option for Launching Test Console

    Description of Figure 6-33 follows
    Description of "Figure 6-33 Option for Launching Test Console"
  5. Launching Test Console opens new window displaying the Proxy Service and the operation to test along with Execute, Execute-Save, Reset and Close button.

    Figure 6-34 Proxy Service Testing

    Description of Figure 6-34 follows
    Description of "Figure 6-34 Proxy Service Testing"

    The Request Document section contains the Request Payload.

  6. 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.