Janrain’s integration with the Oracle Sales Cloud enables customer acquisition through an accelerated Registration conversion with Social Login, allowing you to capture rich customer profile data that can be gathered and stored and used to drive sales and marketing efforts.
The Janrain-Oracle Web connector application is a collection of web services that transfers information about new or updated customer profiles from the Janrain REST API to the Oracle Sales Cloud.
If you don’t have one already, contact Janrain for a Registration solution.
Note: A webhook from Janrain tied to this Registration solution will be needed, but not until a URL for your web application is obtained. Testing can be carried out without the webhook.
Any page containing your Registration widget will work. This is needed for webhook operation.
A free account is needed to download JDeveloper. To create an account (or sign in), go to http://www.oracle.com/index.html and click Sign-in/Register.
Register at https://cloud.oracle.com/home.
This came with your subscription and lets you see any leads you created.
Needed to create proxy clients to the Oracle Sales Cloud. The services needed are:
These URLs point to WSDL documents and have the form:
Oracle recommends installing JDeveloper on 64-bit Windows. We do not recommend installing JDeveloper on other operating systems. For instructions on installing and configuring JDeveloper, refer to Oracle’s JDeveloper Installation page.
There are three web proxy clients to be constructed, each using the JDeveloper wizard. Each proxy client is placed in a separate project. The code generated through the wizard must be amended to work in this application. Re-running the wizard afterward erases any amendments. What follows is applicable to all three clients, although we will use the Location Service in our example.
a. Right-click on the project name (Location, SalesParty, or SalesLead) and select New.
b. In the New Gallery dialog, select Business Tier > Web Services > Web Service Proxy, and click OK. The following screen is displayed:
c. Click Next.
d. Enter the location of the WSDL file. See the following example.
e. The actual URL is based on your cloud instance. Click Next.
f. Enter “com.oracle.pts” for the Package Name and unselect the Generate as Async option. The screen should look like the previous one.
g. Click Next.
h. Click Next.
i. Select Don’t generate any asynchronous methods and click Next.
j. Select oracle/wss_username_token_over_ssl_client_policy and leave the other options unselected. Click Next.
k. Click Next. The final screen is displayed.
l. Click Finish. Repeat this process for the remaining WSDL URLs. Many more files will appear in the Application Navigator.
In order for the REST API class method
Send to work, a valid certificate for your target REST endpoint must be used.
Connector.Jar file and extract the contents.
LocationServiceSoapHttpPortClient.javafile with the contents of
LocationService.javafrom the JAR file.
SalesLeadServiceSoapHttpPortClient.javafile with the contents of
SalesLeadService.javafrom the JAR file.
SalesPartyServiceSoapHttpPortClient.javafile with the contents of
SalesPartyService.javafrom the JAR file.
Webhook.javawith the contents of
Webhook.javafrom the JAR file.
JSONParse.javawith the contents of
JSONParse.javafrom the JAR file.
IFstatement to match the number of codes. See Code Sample 1 for more information.
JSONParse classin the
RESTApi.javawith the contents of
RESTApi.javafrom the JAR file.
Sendmethod to reflect your actual capture endpoint URL, your client ID, and your client secret. See Code Sample 2 for more information.
Mapper.javawith the contents of
Mapper.javafrom the JAR file.
Before deploying to an external server, deploy the individual projects of the application to their individual JAR or WAR file.
SalesLeadServiceProxy all must be deployed as JAR files. Deploy
ViewController as a WAR file.
There are two ways to deploy to JCS:
Once your application is successfully deployed to JCS, you can test it. A simple way to test is to use a cURL message (PHP or command-line).
An example of a command-line cURL post is:
Contact Janrain for a Registration application webhook. For more information, refer to Webhooks.
The following code sample is a section of the
JSONParse class that needs to be customized to work for you. The parts to be customized are highlighted below.
You will need to know all of the hash codes that were set up in the webhook configuration file. These codes add a layer of confidence that the JSON post to the servlet is from Janrain.
The following code sample is a section of the
RESTApi class that needs to be customized to work for you. The parts to be customized are highlighted below.
You will need to know your Registration application name, the client ID code, and the client secret code.