Introduction

Oracle Documents Cloud and Oracle Sales Cloud working together is a perfect match to increase productivity. Better if integrates in a single UI.

This post will show you how to integrate Oracle Documents Cloud with Oracle Sales Cloud using a simple “Sales Collateral” use case, which consist in showing a new menu item that shows documents from a embedded Documents Cloud Public Link.

This sample focus in using Public Links from Documents Cloud and the Desktop UI from Sales Cloud, to cover the Sales Cloud R9.

Main Article

To complete this sample will be needed:

• Oracle Documents Cloud account
• ADF customization asset
• Oracle Sales Cloud account with Application Composer and Topology Manager access

Due the integration limitations with Sales Cloud R9, including outbound REST calls support, the choice was to use Documents Cloud Public Links without security.
This sample covers the Oracle Sales Cloud R9. Also works with Oracles Sales Cloud R10, but with R10 is possible do a integration without ADF customization and using only the Page Composer. Also is possible to create a new Simplified UI (Fuse) button. This subject is covered in another Blog Post.

Step-by-Step of the integration

For this integration, a new Sales Object will be created and the ADF customization will replace, which will consume a Topology previously created. All this need to be done in a Sandbox before publish to all users.

Creating a Sandbox

Before start, its mandatory the creation of a sandbox where will reside the customization, which can be published later.

In the top right, open the menu below the user name and click “Manage Sandboxes”:

* If you cannot see this menu, your user do not have customization right, logout and login with a user with customization rights.

Create a new Sandbox with any desired name:

Sandbox created. Make sure to “Set as Active” your Sandbox.

Creating a Topology Object

The topology object will store the Public Link address.

Go to “Setup and Maintenance” to create the Topology.

In the “Setup and Maintenance” screen, select “Manage Third Party Applications” and then create, to create a new Topology.

Enter the Application Name, something like “SalesCollateral_PublicLink” or something else more simple like “Sales Collateral”. Note that this name will be used by the customization.

Enter the Full URL, which contains the public link.

Then, enter the Partner Name: Documents Cloud

Your Topology object should looks like this:

Creating Sales Collateral Object

Now will create the Sales Collateral Object, which will be the placeholder for the customization.

Go back to the navigator and enter in the Application Composer:

* If you cannot see the Customization or Application Composer in the menu, the user probably do not have customization rights.

In the Application Composer, select the “Sales” as the application and then the new  icon right in the “Custom Objects”:

Enter the name “Sales Collateral” in the Display name and accept the default values:

Select the icon (Sales Cloud R9 do not have one icon specific to Documents Cloud. Sales Cloud R10 come with a specific “similar” icon):

In the Sales Collateral object, go to pages:

Go to “Desktop Pages” and click in the “Create Work Area”:

In the “Menu Category”, select “Sales” and enter the “Menu Item Display Label”:

Uncheck the “Enable” for Regional Search and then  and  again:

Uncheck the options and :

Save and close:

Go back to the Navigator, you should see a “Sales Collateral” new option under Sales:

Inside the “Sales Collateral” page, select “Customize Sales Collateral Pages” under the Administration menu:

Then chose “Site” to Edit:

Click in “Manage Customizations”:

Click in the “Upload” option, in the “All Layers” column for the “Page:”.

Upload the file provided:

You can also create the customization file by creating a xml document with the following content:

<?xml version='1.0' encoding='UTF-8'?>
<mds:customization version="11.1.1.67.89" xmlns:mds="http://xmlns.oracle.com/mds" motype_local_name="root" motype_nsuri="http://java.sun.com/JSP/Page">
   <mds:insert parent="(xmlns(jsp=http://java.sun.com/JSP/Page))/jsp:root" position="last">
      <af:panelStretchLayout xmlns:af="http://xmlns.oracle.com/adf/faces/rich" id="ExtGen_psl11" inlineStyle="width:99.9%;" startWidth="0px" endWidth="0px" topHeight="0px" bottomHeight="0px" styleClass="AFStretchWidth" xmlns:f="http://java.sun.com/jsf/core" xmlns:c="http://java.sun.com/jsp/jstl/core" xmlns:fnd="http://xmlns.oracle.com/apps/fnd/applcore">
         <f:facet xmlns:f="http://java.sun.com/jsf/core" name="bottom"/>
         <f:facet xmlns:f="http://java.sun.com/jsf/core" name="center">
           <af:inlineFrame xmlns:af="http://xmlns.oracle.com/adf/faces/rich" id="DoCS_SalesLibrary" source="#{EndPointProvider.externalEndpointByModuleShortName['SalesCollateral_PublicLink']}/lyt=grid" inlineStyle="" styleClass="inlinestlye" sizing="none" shortDesc="Documents Cloud"/>
         </f:facet>
         <f:facet xmlns:f="http://java.sun.com/jsf/core" name="start"/>
         <f:facet xmlns:f="http://java.sun.com/jsf/core" name="end"/>
         <f:facet xmlns:f="http://java.sun.com/jsf/core" name="top"/>
      </af:panelStretchLayout>
   </mds:insert>
</mds:customization>

Updated code here:

Note the EL in the xml (Line 7), contains the name of the Topology Object previously created:

#{EndPointProvider.externalEndpointByModuleShortName['SalesCollateral_PublicLink']}/lyt=grid

Also note the “/lyt=grid” at the end, this will force the layout be grid.

Close the customization screen by hitting “Close” in the Top Right of the page.

At this point, you will be able to see the integration:

* Remember that the Sales Cloud R10 has a different look and feel.

Conclusion

This article covers a simple integration between Oracle Documents Cloud and Oracle Sales Cloud, by using public links. Can also be replicated to different use cases other than the Sales Collateral and different modules such as HCM.

Soon will be posted a similar integration using Sales Cloud R10, which will be referenced here.

Reference

Oracle Documents Cloud Service info: http://cloud.oracle.com/documents

Oracle Sales Cloud info: http://cloud.oracle.com/sales-cloud

Embedding DoCS web user interface info: http://docs.oracle.com/cloud/latest/documentcs_welcome/WCCCD/GUID-3AB30A35-F0E4-4967-92C8-159FC5AA3844.htm#WCCCD4015

All content listed on this page is the property of Oracle Corp. Redistribution not allowed without written permission