This chapter includes these sections:
To integrate with Oracle BPEL Process Manager, the organization's Enterprise WSDL must be available to the user. The underlying adapter services are exposed as WSDL files, which are generated during design time in the configuration wizard of the Oracle RightNow adapter.
Use the generated WSDL files to design the appropriate BPEL processes for outbound adapter services. A completed BPEL process must be successfully compiled in JDeveloper and deployed to an SOA Suite server. Upon deployment to a SOA Suite server, each newly-deployed process is viewable in the Oracle Fusion Middleware Control console, where you can run, monitor, administer BPEL processes, and monitor adapter events.
You create an Account object and integrate the WSDL with the Oracle BPEL Process Manager. Account is one of the standard objects provided by RightNow, an account generated for a staff member in the RightNow Cx system. Customer service representatives, sales agents, and site administrators use Accounts.
Specifically, an Account object on RightNow Cx represents an individual or business associated with the business.
The Oracle RightNow adapter enables you to create an Account object on RightNow Cx.
For steps to configure the CSF key on the Fusion Middleware Control Console, seeAppendix A, "Credential Store Configuration for Managing RightNow Credentials".
The next steps detail how to design a composite using the Oracle JDeveloper Studio Edition, a comprehensive tool for developing Oracle Fusion Middleware applications. It provides an easy-to-use Integrated Development Environment that enables you to create your integrations efficiently.
To define a composite for BPEL and Mediator:
In the File menu of JDeveloper, click New and select Application.
JDeveloper displays the New Gallery page. Select SOA Application from the Items list.
Provide a suitable name to your application.
Click Next and provide a suitable name to your project.
Select Composite with BPEL Process from Standard Composite list.
Select the Synchronous BPEL Process from Template drop-down and click OK.
In the Application Navigator, under the Schemas folder, JDeveloper displays an XML schema file with the name
BPELProcess1.xsd after BPEL process creation.
Edit this schema file as your business needs require. It is the responsibility of the front-end application to enforce data validations and to ensure that the input sent to the Oracle RightNow Cx Server from SOA is error-free.
The structure of the schema used in this use case is as shown below.
To configure a new Oracle RightNow adapter:
In External References swim lane of the
composite.xml file, right-click and select Oracle RightNow Adapter.
JDeveloper displays the Oracle RightNow Adapter Configuration Wizard - Welcome page.
JDeveloper displays the Oracle RightNow Adapter Server Connection page. You must provide the WSDL URL/Location and Authentication Key details.
If you have the WSDL available in the file system, click the Find existing WSDLs icon, located to the right of the WSDL on the screen.
JDeveloper displays the WSDL Chooser dialog. Browse and select the downloaded Enterprise WSDL and click OK.
Click OK. You are returned to the Oracle RightNow Adapter Server Connection page.
As an alternative, you can store WSDL at an MDS location and access it. The next screenshot shows you storing the WSDL at an MDS location.
Navigate to IDE Connections-> SOA-MDS. Select the appropriate SOA-MDS connection where you placed the Enterprise WSDL. Select the WSDL file to be used in the adapter configuration and click OK.
Ensure that the WSDL is of the form:
An alternative is to directly provide the https URL:
Click ”+” button to create a new Authentication Key.
JDeveloper displays the Add Credential dialog box. Provide a suitable name and the Right Now credentials and click OK.
Click Test Connection button to validate the Authentication Key.
JDeveloper displays the Cloud Operation Configuration page.
Because the requirement is to create an Account on RightNow, select the Operation Category as
Cloud Operation as
On the same screen, move
Account from the list of Available objects to the list of the Selected objects. The WSDL Operation by default is create. You can edit the WSDL Operation by providing an operation name suitable to your business requirement.
Click Properties tab. JDeveloper displays the Oracle RightNow Adapter Processing Options page.
Select the processing options for your requirement. Properties displayed in this page depend on the operation you selected in the previous page. In this case, the SuppressResponse checkbox is selected, and suppressing a response is disabled, that is, made false. Once this is selected, the
Create operation returns a valid ID for a a batch operation instance you are creating.
Click Next. JDeveloper displays the Finish page, which provides a complete summary of the operation selected, the object on which the operation operates and the headers selected for that operation.
Click the Finish button to complete the Oracle RightNow adapter Configuration wizard. After clicking on Finish button, the External References screen appears.
Perform the following steps to provide integration with BPEL:
ServiceCloudCreateAccount using a wire.
After wiring your composite appears.
Double-click and open
BPELProcess1. The Oracle RightNow adapter should be present as a part of the Partner Links.
Add an Invoke activity to invoke the
ServiceCloudCreateAccount Partner Link. To add the Invoke activity:
Drag and drop the invoke activity from the BPEL constructs.
After dropping the Invoke property on the canvas, wire the Invoke activity to the
ServiceCloudAdapter partner link.
Create an input variable to the partner link by clicking the + button adjacent to Input text box in the Variables section. JDeveloper displays the Create Variable dialog.
Create an output variable from the partner link by clicking the + button adjacent to Output text box in the Variables section. The wizard displays the Create Variable dialog.
Introduce two transform activities, one before the Invoke activity and another after it.
Map Transform1 values from receive activity's input variable to the Invoke activity's input variable.
+ button adjacent to Mapper File text box to open the Transformation_1.xsl file.
Map between inputVariable and Invoke1_create_InputVariable:
Map Account_Name with Name.
Map Phone with Phone.
Map Website with Website.
Map Description with Description.
Map Transform2 values from the Invoke activity's output variable to the reply activity's input variable.
Map the output variable.
This completes the project creation. JDeveloper displays the
To deploy the composite application:
In the Application Navigator pane, right-click Project1 and select Deploy Project1.
Select the Deploy to Application Server option and follow the instructions. Using this option, you can deploy the composite on the Application server after providing the details of the server.
You can run and test the instances of deployed SOA composite applications from the Oracle Fusion Middleware Control Console. Doing so enables you to manage a composite application, initiate and track an instance of a composite and to view detailed component instance audit trails.
The following process shows you how to test the composite.
To test the Outbound process:
Login to Fusion Middleware Console for the server on which you have deployed your project.
Open Project1 under the Default partition.
Click the Test button to test the Web service.
Provide the input payload and click the Test Web Service button.
After successful execution, the response contains the id of the account created on RightNow and Status as success.